@unvt/charites 0.1.1 → 0.1.4

package/dist/commands/build.js

@@ -3,14 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.build = void 0;
+exports.buildWatch = exports.build = void 0;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const yaml_parser_1 = require("../lib/yaml-parser");
 const validate_style_1 = require("../lib/validate-style");
+const build_sprite_1 = require("../lib/build-sprite");
+const get_sprite_slug_1 = require("../lib/get-sprite-slug");
 const defaultValues_1 = require("../lib/defaultValues");
 const jsonminify_1 = __importDefault(require("jsonminify"));
-function build(source, destination, options) {
+const node_watch_1 = __importDefault(require("node-watch"));
+async function build(source, destination, options) {
     let sourcePath = path_1.default.resolve(process.cwd(), source);
     // The `source` is absolute path.
     if (source.match(/^\//)) {
@@ -19,7 +22,7 @@ function build(source, destination, options) {
     if (!fs_1.default.existsSync(sourcePath)) {
         throw `${sourcePath}: No such file or directory`;
     }
-    let destinationPath = "";
+    let destinationPath = '';
     if (destination) {
         if (destination.match(/^\//)) {
             destinationPath = destination;
@@ -39,7 +42,23 @@ function build(source, destination, options) {
     try {
         const _style = yaml_parser_1.parser(sourcePath);
         validate_style_1.validateStyle(_style, provider);
+        if (options.spriteUrl && 'sprite' in _style) {
+            _style.sprite = options.spriteUrl;
+        }
         style = JSON.stringify(_style, null, '  ');
+        if (options.spriteInput && options.spriteOutput) {
+            if (!fs_1.default.existsSync(options.spriteInput)) {
+                throw `${options.spriteInput}: No such directory. Please specify valid icon input directory. For more help run charites build --help`;
+            }
+            if (!fs_1.default.existsSync(options.spriteOutput)) {
+                throw `${options.spriteOutput}: No such directory. Please specify valid icon output directory. For more help run charites build --help`;
+            }
+            const iconSlug = get_sprite_slug_1.getSpriteSlug(JSON.parse(style));
+            if (!iconSlug) {
+                throw `Invalid sprite url format.`;
+            }
+            await build_sprite_1.buildSprite(options.spriteInput, options.spriteOutput, iconSlug);
+        }
         if (options.compactOutput) {
             style = jsonminify_1.default(style);
         }
@@ -60,3 +79,20 @@ function build(source, destination, options) {
     }
 }
 exports.build = build;
+function buildWatch(source, destination, options) {
+    let sourcePath = path_1.default.resolve(process.cwd(), source);
+    if (source.match(/^\//)) {
+        sourcePath = source;
+    }
+    console.log(path_1.default.dirname(sourcePath));
+    return node_watch_1.default(path_1.default.dirname(sourcePath), { recursive: true, filter: /\.yml$/ }, (event, file) => {
+        console.log(`${(event || '').toUpperCase()}: ${file}`);
+        try {
+            build(source, destination, options);
+        }
+        catch (e) {
+            // Nothing to do
+        }
+    });
+}
+exports.buildWatch = buildWatch;

package/dist/commands/convert.js

@@ -6,25 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.convert = void 0;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
-const js_yaml_1 = __importDefault(require("js-yaml"));
 const readline_1 = __importDefault(require("readline"));
-// TODO: Type of style should be loaded from maplibre or mapbox style spec.
-const writeYaml = (destinationPath, style) => {
-    const layers = [];
-    for (let i = 0; i < style.layers.length; i++) {
-        const layer = style.layers[i];
-        const layerYml = js_yaml_1.default.dump(layer);
-        const fileName = `${style.layers[i].id}.yml`;
-        const dirName = path_1.default.join(path_1.default.dirname(destinationPath), 'layers');
-        fs_1.default.mkdirSync(dirName, { recursive: true });
-        fs_1.default.writeFileSync(path_1.default.join(dirName, fileName), layerYml);
-        layers.push(`!!inc/file ${path_1.default.join('layers', fileName)}`);
-    }
-    style.layers = layers;
-    fs_1.default.writeFileSync(destinationPath, js_yaml_1.default.dump(style).replace(/'\!\!inc\/file layers\/.+\.yml'/g, function (match) {
-        return match.replace(/'/g, '');
-    }));
-};
+const yaml_writer_1 = require("../lib/yaml-writer");
 const getDestinationPath = (destination, sourcePath = '') => {
     let destinationPath;
     if (destination) {
@@ -50,17 +33,17 @@ function convert(source, destination) {
     if ('-' === source) {
         const rl = readline_1.default.createInterface({
             input: process.stdin,
-            terminal: false
+            terminal: false,
         });
         const lines = [];
-        rl.on("line", (line) => {
+        rl.on('line', (line) => {
             lines.push(line);
         });
-        rl.on("close", () => {
+        rl.on('close', () => {
             const style = JSON.parse(lines.join(''));
             const destinationPath = getDestinationPath(destination);
             try {
-                writeYaml(destinationPath, style);
+                yaml_writer_1.writeYaml(destinationPath, style, false);
             }
             catch (err) {
                 throw `${destinationPath}: Permission denied`;
@@ -79,7 +62,7 @@ function convert(source, destination) {
         style = JSON.parse(fs_1.default.readFileSync(sourcePath, 'utf-8'));
         const destinationPath = getDestinationPath(destination, sourcePath);
         try {
-            writeYaml(destinationPath, style);
+            yaml_writer_1.writeYaml(destinationPath, style, false);
         }
         catch (err) {
             throw `${destinationPath}: Permission denied`;

package/dist/commands/init.js

@@ -1,33 +1,26 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.init = void 0;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const js_yaml_1 = __importDefault(require("js-yaml"));
-// TODO: We need type definition for style.
+const yaml_writer_1 = require("../lib/yaml-writer");
+const tileinfo_importer_1 = require("../lib/tileinfo-importer");
 const styleRoot = {
     version: 8,
-    name: "My Style",
-    sprite: "",
-    glyphs: "",
+    name: 'My Style',
+    sprite: '',
+    glyphs: '',
     sources: {},
-    layers: []
+    layers: [],
 };
-function init(file) {
-    const styleYAML = js_yaml_1.default.dump(styleRoot);
-    let stylePath = path_1.default.resolve(process.cwd(), file);
-    // The `source` is absolute path.
-    if (file.match(/^\//)) {
-        stylePath = file;
-    }
-    try {
-        fs_1.default.writeFileSync(stylePath, styleYAML);
+async function init(file, options) {
+    let styleTemplate = JSON.parse(JSON.stringify(styleRoot));
+    if (options.tilejsonUrls) {
+        const tileJSONImporter = new tileinfo_importer_1.TileJSONImporter(options.tilejsonUrls);
+        styleTemplate = await tileJSONImporter.import(styleTemplate);
     }
-    catch (err) {
-        throw `${stylePath}: Permission denied`;
+    if (options.metadatajsonUrls) {
+        const metadataJSONImporter = new tileinfo_importer_1.MetadataJSONImporter(options.metadatajsonUrls);
+        styleTemplate = await metadataJSONImporter.import(styleTemplate);
     }
+    yaml_writer_1.writeYaml(file, styleTemplate, options.compositeLayers);
 }
 exports.init = init;

package/dist/commands/serve.js

@@ -14,7 +14,10 @@ const yaml_parser_1 = require("../lib/yaml-parser");
 const validate_style_1 = require("../lib/validate-style");
 const defaultValues_1 = require("../lib/defaultValues");
 function serve(source, options) {
-    const port = process.env.PORT || 8080;
+    let port = process.env.PORT || 8080;
+    if (options.port) {
+        port = Number(options.port);
+    }
     let sourcePath = path_1.default.resolve(process.cwd(), source);
     let provider = defaultValues_1.defaultValues.provider;
     if (options.provider) {
@@ -38,8 +41,9 @@ function serve(source, options) {
                 res.end(content);
                 break;
             case '/style.json':
-                const style = yaml_parser_1.parser(sourcePath);
+                let style;
                 try {
+                    style = yaml_parser_1.parser(sourcePath);
                     validate_style_1.validateStyle(style, provider);
                 }
                 catch (error) {
@@ -60,7 +64,8 @@ function serve(source, options) {
                 res.setHeader('Content-Type', 'application/javascript; charset=UTF-8');
                 try {
                     const app = fs_1.default.readFileSync(path_1.default.join(dir, 'app.js'), 'utf-8');
-                    const js = app.replace('___PORT___', `${port}`)
+                    const js = app
+                        .replace('___PORT___', `${port}`)
                         .replace('___MAPBOX_ACCESS_TOKEN___', `${options.mapboxAccessToken || defaultValues_1.defaultValues.mapboxAccessToken}`);
                     res.end(js);
                 }

package/dist/lib/build-sprite.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSprite = void 0;
+const spritezero = require('@mapbox/spritezero');
+const fs = require('fs');
+const glob = require('glob');
+const path = require('path');
+function generateLayoutAsync(option) {
+    return new Promise((resolve, reject) => {
+        spritezero.generateLayout(option, (err, result) => {
+            if (err)
+                reject(err);
+            else
+                resolve(result);
+        });
+    });
+}
+function generateImageAsync(option) {
+    return new Promise((resolve, reject) => {
+        spritezero.generateImage(option, (err, result) => {
+            if (err)
+                reject(err);
+            else
+                resolve(result);
+        });
+    });
+}
+async function buildSprite(svgPath, publicPath, iconSlug) {
+    const pxRatios = [1, 2];
+    for (let i = 0; i < pxRatios.length; i++) {
+        const pxRatio = pxRatios[i];
+        const svgFiles = glob
+            .sync(path.join(svgPath, `*.svg`))
+            .map(function (iconPath) {
+            return {
+                svg: fs.readFileSync(iconPath),
+                id: path.basename(iconPath).replace('.svg', ''),
+            };
+        });
+        let file = '';
+        if (pxRatio > 1) {
+            file = `@${pxRatio}x`;
+        }
+        const pngPath = path.join(publicPath, `${iconSlug}${file}.png`);
+        const jsonPath = path.join(publicPath, `${iconSlug}${file}.json`);
+        try {
+            const dataLayout = await generateLayoutAsync({
+                imgs: svgFiles,
+                pixelRatio: pxRatio,
+                format: true,
+            });
+            fs.writeFileSync(jsonPath, JSON.stringify(dataLayout));
+        }
+        catch (error) {
+            throw `${publicPath}: No such file or directory`;
+        }
+        try {
+            const imageLayout = await generateLayoutAsync({
+                imgs: svgFiles,
+                pixelRatio: pxRatio,
+                format: false,
+            });
+            const image = await generateImageAsync(imageLayout);
+            fs.writeFileSync(pngPath, image);
+        }
+        catch (error) {
+            throw `${publicPath}: No such file or directory`;
+        }
+    }
+}
+exports.buildSprite = buildSprite;

package/dist/lib/defaultValues.js

@@ -9,7 +9,7 @@ const os_1 = __importDefault(require("os"));
 const fs_1 = __importDefault(require("fs"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const homedir = os_1.default.homedir();
-const defaultProvider = "default";
+const defaultProvider = 'default';
 const configDir = path_1.default.join(homedir, '.charites');
 fs_1.default.mkdirSync(configDir, { recursive: true });
 const configFile = path_1.default.join(configDir, 'config.yml');
@@ -24,8 +24,8 @@ catch (e) {
 exports.defaultValues = {
     provider: config.provider || defaultProvider,
     providerDir: path_1.default.join(path_1.default.dirname(path_1.default.dirname(__dirname)), 'provider'),
-    mapboxAccessToken: config.mapboxAccessToken || ''
+    mapboxAccessToken: config.mapboxAccessToken || '',
 };
 exports.defaultSettings = {
-    configFile: configFile
+    configFile: configFile,
 };

package/dist/lib/error.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.error = void 0;
+exports.error = (e) => {
+    if (e instanceof TypeError) {
+        console.error(e.message);
+    }
+    process.exit(1);
+};

package/dist/lib/get-sprite-slug.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSpriteSlug = void 0;
+function getSpriteSlug(style) {
+    var _a;
+    if (!style.hasOwnProperty('sprite')) {
+        return false;
+    }
+    const matchedUrl = (_a = style.sprite) === null || _a === void 0 ? void 0 : _a.match(/^(?:[^:\/?#]+:)?(?:\/\/[^\/?#]*)?(?:([^?#]*\/)([^\/?#]*))?(\?[^#]*)?(?:#.*)?$/);
+    if (!matchedUrl || !matchedUrl[2]) {
+        return false;
+    }
+    // icon slug
+    return matchedUrl[2];
+}
+exports.getSpriteSlug = getSpriteSlug;

package/dist/lib/tileinfo-importer/base-importer.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseImporter = void 0;
+class BaseImporter {
+    constructor(original_urls) {
+        const temp_urls = original_urls + '';
+        this.urls = temp_urls.split(',');
+    }
+    async import(style) {
+        if (this.urls.length === 0)
+            return;
+        const responses = await Promise.all(this.urls.map((url) => this.getJSON(url)));
+        responses.forEach((res) => {
+            Object.keys(res.sources).forEach((sourceName) => {
+                style.sources[sourceName] = res.sources[sourceName];
+            });
+            if (res.layers.length > 0) {
+                style.layers = style.layers.concat(res.layers);
+            }
+        });
+        return style;
+    }
+    getVectorLayers(name, vector_layers) {
+        const layers = [];
+        if (vector_layers) {
+            vector_layers.forEach((layer) => {
+                const layerStyle = {
+                    id: layer.id,
+                    type: 'fill',
+                    source: name,
+                    'source-layer': layer.id,
+                    layout: {},
+                    paint: {},
+                };
+                layers.push(layerStyle);
+            });
+        }
+        return layers;
+    }
+}
+exports.BaseImporter = BaseImporter;

package/dist/lib/tileinfo-importer/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var metadata_importer_1 = require("./metadata-importer");
+Object.defineProperty(exports, "MetadataJSONImporter", { enumerable: true, get: function () { return metadata_importer_1.MetadataJSONImporter; } });
+var tilejson_importer_1 = require("./tilejson-importer");
+Object.defineProperty(exports, "TileJSONImporter", { enumerable: true, get: function () { return tilejson_importer_1.TileJSONImporter; } });

package/dist/lib/tileinfo-importer/metadata-importer.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataJSONImporter = void 0;
+const axios_1 = __importDefault(require("axios"));
+const base_importer_1 = require("./base-importer");
+class MetadataJSONImporter extends base_importer_1.BaseImporter {
+    async getJSON(url) {
+        const res = await axios_1.default.get(url);
+        const matadataJSON = res.data;
+        const metadataName = matadataJSON.name
+            ? matadataJSON.name
+            : Math.random().toString(32).substring(2);
+        const sources = {};
+        const urlSplited = url.split('/');
+        sources[metadataName] = {
+            type: 'vector',
+            tiles: [
+                url.replace(new RegExp(urlSplited[urlSplited.length - 1], 'g'), '{z}/{x}/{y}.pbf'),
+            ],
+        };
+        if (matadataJSON.minzoom) {
+            sources[metadataName].minzoom = matadataJSON.minzoom;
+        }
+        if (matadataJSON.maxzoom) {
+            sources[metadataName].maxzoom = matadataJSON.maxzoom;
+        }
+        let layers = [];
+        if (matadataJSON.json) {
+            const vector_layers = JSON.parse(matadataJSON.json).vector_layers;
+            layers = this.getVectorLayers(metadataName, vector_layers);
+        }
+        return { sources, layers };
+    }
+}
+exports.MetadataJSONImporter = MetadataJSONImporter;

package/dist/lib/tileinfo-importer/tilejson-importer.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TileJSONImporter = void 0;
+const axios_1 = __importDefault(require("axios"));
+const base_importer_1 = require("./base-importer");
+class TileJSONImporter extends base_importer_1.BaseImporter {
+    async getJSON(url) {
+        const res = await axios_1.default.get(url);
+        const tilejson = res.data;
+        const tilesetName = tilejson.name
+            ? tilejson.name
+            : Math.random().toString(32).substring(2);
+        const sources = {};
+        sources[tilesetName] = {
+            type: 'vector',
+            url: url,
+        };
+        const layers = this.getVectorLayers(tilesetName, tilejson.vector_layers);
+        return { sources, layers };
+    }
+}
+exports.TileJSONImporter = TileJSONImporter;

package/dist/lib/validate-style.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateStyle = void 0;
 const maplibreStyleSpec = require('@maplibre/maplibre-gl-style-spec');
 const mapboxStyleSpec = require('@mapbox/mapbox-gl-style-spec');
-function validateStyle(style, provider = "default") {
+function validateStyle(style, provider = 'default') {
     let result = [];
     if ('mapbox' === provider) {
         result = mapboxStyleSpec.validate(style);
@@ -18,7 +18,7 @@ function validateStyle(style, provider = "default") {
         }
     }
     if (errors.length) {
-        throw `\u001b[31mError:\u001b[0m ${errors.join("\n\u001b[31mError:\u001b[0m ")}`;
+        throw `\u001b[31mError:\u001b[0m ${errors.join('\n\u001b[31mError:\u001b[0m ')}`;
     }
 }
 exports.validateStyle = validateStyle;

package/dist/lib/yaml-parser.js

@@ -13,10 +13,10 @@ function parser(file) {
     const obj = js_yaml_1.default.load(yaml, {
         schema: yamlinc.YAML_INCLUDE_SCHEMA,
         filename: file,
-        json: true
+        json: true,
     });
     const styleObj = {};
-    let variables = {};
+    const variables = {};
     for (const key in obj) {
         if (key.match(/^\$/)) {
             variables[key] = obj[key];

package/dist/lib/yaml-writer.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeYaml = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+exports.writeYaml = (destinationPath, style, composite = false) => {
+    if (composite === true) {
+        writeCompositedYaml(destinationPath, style);
+    }
+    else {
+        writeDecompositedYaml(destinationPath, style);
+    }
+};
+const writeCompositedYaml = (destinationPath, style) => {
+    const styleYAML = js_yaml_1.default.dump(style);
+    let stylePath = path_1.default.resolve(process.cwd(), destinationPath);
+    // The `source` is absolute path.
+    if (destinationPath.match(/^\//)) {
+        stylePath = destinationPath;
+    }
+    try {
+        fs_1.default.writeFileSync(stylePath, styleYAML);
+    }
+    catch (err) {
+        throw `${stylePath}: Permission denied`;
+    }
+};
+const writeDecompositedYaml = (destinationPath, style) => {
+    const layers = [];
+    for (let i = 0; i < style.layers.length; i++) {
+        const layer = style.layers[i];
+        const layerYml = js_yaml_1.default.dump(layer);
+        const fileName = `${style.layers[i].id}.yml`;
+        const dirName = path_1.default.join(path_1.default.dirname(destinationPath), 'layers');
+        fs_1.default.mkdirSync(dirName, { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(dirName, fileName), layerYml);
+        // @ts-ignore
+        layers.push(`!!inc/file ${path_1.default.join('layers', fileName)}`);
+    }
+    style.layers = layers;
+    fs_1.default.writeFileSync(destinationPath, js_yaml_1.default.dump(style).replace(/'\!\!inc\/file layers\/.+\.yml'/g, function (match) {
+        return match.replace(/'/g, '');
+    }));
+};

package/dist/types/index.js

@@ -0,0 +1,15 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !exports.hasOwnProperty(p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./tilejson"), exports);
+__exportStar(require("./metadatajson"), exports);
+__exportStar(require("./vector_layers"), exports);

package/dist/types/metadatajson.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/tilejson.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/vector_layers.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/docs/.tx/config

@@ -0,0 +1,62 @@
+[main]
+host = https://www.transifex.com
+
+[charites-docs.index]
+file_filter = i18n/<lang>/LC_MESSAGES/index.po
+source_file = i18n/pot/index.pot
+source_lang = en
+type = PO
+
+[charites-docs.development--index]
+file_filter = i18n/<lang>/LC_MESSAGES/development/index.po
+source_file = i18n/pot/development/index.pot
+source_lang = en
+type = PO
+
+[charites-docs.install--index]
+file_filter = i18n/<lang>/LC_MESSAGES/install/index.po
+source_file = i18n/pot/install/index.pot
+source_lang = en
+type = PO
+
+[charites-docs.install--install]
+file_filter = i18n/<lang>/LC_MESSAGES/install/install.po
+source_file = i18n/pot/install/install.pot
+source_lang = en
+type = PO
+
+[charites-docs.install--install_on_nanban]
+file_filter = i18n/<lang>/LC_MESSAGES/install/install_on_nanban.po
+source_file = i18n/pot/install/install_on_nanban.pot
+source_lang = en
+type = PO
+
+[charites-docs.install--recommended_environment]
+file_filter = i18n/<lang>/LC_MESSAGES/install/recommended_environment.po
+source_file = i18n/pot/install/recommended_environment.pot
+source_lang = en
+type = PO
+
+[charites-docs.usage--commandline_interface]
+file_filter = i18n/<lang>/LC_MESSAGES/usage/commandline_interface.po
+source_file = i18n/pot/usage/commandline_interface.pot
+source_lang = en
+type = PO
+
+[charites-docs.usage--examples]
+file_filter = i18n/<lang>/LC_MESSAGES/usage/examples.po
+source_file = i18n/pot/usage/examples.pot
+source_lang = en
+type = PO
+
+[charites-docs.usage--global_options]
+file_filter = i18n/<lang>/LC_MESSAGES/usage/global_options.po
+source_file = i18n/pot/usage/global_options.pot
+source_lang = en
+type = PO
+
+[charites-docs.usage--index]
+file_filter = i18n/<lang>/LC_MESSAGES/usage/index.po
+source_file = i18n/pot/usage/index.pot
+source_lang = en
+type = PO