Gulp plugin for GNU xgettext utility

Usage no npm install needed!

<script type="module">
  import dcousineauGulpXgettext from 'https://cdn.skypack.dev/@dcousineau/gulp-xgettext';


gulp-xgettext NPM version

Gulp plugin for running GNU xgettext.


  1. Install the plugin with the following command:

    npm install gulp-xgettext --save-dev
  2. Install GNU xgettext


var gulp = require('gulp');
var xgettext = require('gulp-xgettext');

gulp.task('default', function () {
    return gulp.src(['src/**/*.cpp'])
            language: 'C++',
            keywords: [
                {name: 'get_local'}




Type: String

Default: 'xgettext'

GNU xgettext executable.


Type: String

A language that should be used to parse the files. By default xgettext will try to determine a language by file extension.


Type: Array

List of keywords that should be checked. Each keyword is an object with the following properties:

  • name: string, name of a localization function to search.
  • singular: integer, number of argument that represents singular form of a string.
  • plural: integer, number of argument that represents plural form of a string.
  • context: integer, number of argument that represents context of a string.

All properties, except name are optional. Arguments counting starts from one.


Type: Object

A list of headers that will be used in the resulting .po file. The list of available headers with their descriptions can be found here. If a header is not specified an appropriate xgettext value will be used.


MIT © Dmitriy Simushev