diff --git a/editions/translators/tiddlers/Extracting Translations.tid b/editions/translators/tiddlers/Extracting Translations.tid index f22f1e7bc..5a1d166f5 100644 --- a/editions/translators/tiddlers/Extracting Translations.tid +++ b/editions/translators/tiddlers/Extracting Translations.tid @@ -2,10 +2,26 @@ title: Extracting Translations The [[Instructions for Translators]] yield a standalone TiddlyWiki HTML file that contains tiddlers corresponding to each translated string. -The following command is used to generate the tiddler source files for the repository: +! Extracting a new language plugin -``` -tiddlywiki editions/translators/ --verbose --load --build output-files -``` +Use this procedure if the language being submitted is not already present in the TiddlyWiki repository. -The source files are generated in `editions/translators/output/language`. They should be copied to the appropriate `languages` directory, and an appropriate flag image placed in `icon.tid`. +# Run the following command in the terminal to generate the tiddler source files for the repository: +#* `tiddlywiki editions/translators/ --verbose --load --build output-files` +#*> The source files are generated in `editions/translators/output/language` +# Create the new language folder `languages/xx-XX` +# Copy the language files into the language folder +# Create a `plugin.info` file for the translation +# Create an appropriate flag image in `icon.tid` +# Change the title of the [[$:/core/readme]] tiddler to `$:/core/xx-XX/readme` +# Submit a pull request + +! Updating an existing language plugin + +Use this procedure for submissions of updates to language plugins that are already present in the TiddlyWiki repository. + +# Run the following command in the terminal to generate the tiddler source files for the repository: +#* `tiddlywiki editions/translators/ --verbose --unpackplugin $:/languages/xx-XX --load --build output-files` +#* substituting the appropriate language code for `xx-XX` +# Copy the language files from the edition output folder to the appropriate language directory +#* Take care not to copy any empty `.tid` files