X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2FTRANSLATION;h=82798c5d45106c3436d46e8ef32b3522d0995dfa;hb=2820653d0e8f00674fd986ad92a6e3ca4342ee37;hp=4651e05d6d04f0f90dacb55c8efcbf2903cfb1c9;hpb=9c1421a4c5d42ae3c78218a296596cc9a4c2e4f5;p=lilypond.git diff --git a/Documentation/TRANSLATION b/Documentation/TRANSLATION index 4651e05d6d..82798c5d45 100644 --- a/Documentation/TRANSLATION +++ b/Documentation/TRANSLATION @@ -93,7 +93,7 @@ Cd into Documentation and run: where is the ISO 639 language code. Add a language definition for your language in -buildscripts/langdefs.py. +python/langdefs.py. See next section about what files to translate and the following detailed instructions after the next section. @@ -128,23 +128,23 @@ Word counts (excluding lilypond snippets) are given for each file. 411 user/preface.itely 3855 user/introduction.itely 407 user/lilypond-program.tely -1930 user/install.itely (partial translation) +1928 user/install.itely (partial translation) 1149 user/setup.itely 2827 user/running.itely -10579 total +10577 total -3- Learning manual 10318 user/fundamental.itely -- Fundamental concepts -14647 user/tweaks.itely -- Tweaking output +14775 user/tweaks.itely -- Tweaking output 3007 user/working.itely -- Working on LilyPond files 483 user/templates.itely -- Templates -28455 total +28583 total -4- Notation reference 695 user/lilypond.tely 91 user/notation.itely -- Musical notation 3123 user/pitches.itely -5013 user/rhythms.itely +5236 user/rhythms.itely 1146 user/expressive.itely 555 user/repeats.itely 1455 user/simultaneous.itely @@ -160,14 +160,14 @@ Word counts (excluding lilypond snippets) are given for each file. 66 user/strings.itely 242 user/bagpipes.itely 4487 user/ancient.itely -5805 user/input.itely -- Input syntax +5873 user/input.itely -- Input syntax 2164 user/non-music.itely -- Non-musical notation 8451 user/spacing.itely -- Spacing issues 11391 user/changing-defaults.itely -- Changing defaults 5202 user/programming-interface.itely -- Interfaces for programmers 1190 user/notation-appendices.itely -- Notation manual tables 250 user/cheatsheet.itely -- Cheat sheet -62756 total +63047 total -5- Application usage 3248 user/lilypond-book.itely -- LilyPond-book @@ -670,25 +670,38 @@ which works regardless of the branch checked out. TECHNICAL BACKGROUND A number of Python scripts handle a part of the documentation -translation process. All are located in buildscripts/, except -langdefs.py which is in python/ +translation process. +All scripts used to maintain the translations +are located in scripts/auxiliar/: -* buildlib.py -- module containing common functions (read piped output -of a shell command, use Git) -* langdefs.py -- language definitions module * check_translation.py -- show diff to update a translation * texi-langutils.py -- quickly and dirtily parse Texinfo files to make message catalogs and Texinfo skeleton files * texi-skeleton-update.py -- update Texinfo skeleton files +* update-snippets.py -- synchronize ly snippets with those from +English docs +* translations-status.py -- update translations status pages and word +counts in the file you are reading. +* tely-gettext.py -- gettext node names, section titles and references +in the sources; WARNING only use this script when support for +"makeinfo --html" has been dropped. + +Other scripts are used in the build process, in scripts/build/: * html-gettext.py -- translate node names, section titles and cross references in HTML files generated by makeinfo -* add_html_footer.py (module imported by www_post.py) -- add footer and -tweak links in HTML pages * texi-gettext.py -- gettext node names, section titles and references before calling texi2pdf * mass-link.py -- link or symlink files between English documentation and documentation in other languages -* update-snippets.py -- synchronize ly snippets with those from -English docs -* translations-status.py -- update translations status pages and word -counts in the file you are reading. + +Python modules used by scripts in scripts/auxiliar/ or scripts/build/ (but +not by installed Python scripts) are located in python/auxiliar/: +* manuals_definitions.py -- define manual names and name of +cross-reference Texinfo macros +* buildlib.py -- common functions (read piped output +of a shell command, use Git) +* postprocess_html.py (module imported by www_post.py) -- add footer and +tweak links in HTML pages + +And finally +* python/langdefs.py -- language definitions module