X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2FTRANSLATION;h=ada4bd7b156ed0cb910c6d31df582fe31f4d6525;hb=6140c6eb657080939fa4aef3d00d717bd85b5028;hp=73fbb9fa1684f49f3720dc52c846378b43b5f661;hpb=b6b251afb3d68e32df8b84274f28c864ecd2beff;p=lilypond.git diff --git a/Documentation/TRANSLATION b/Documentation/TRANSLATION index 73fbb9fa16..ada4bd7b15 100644 --- a/Documentation/TRANSLATION +++ b/Documentation/TRANSLATION @@ -47,6 +47,10 @@ The reader is supposed to be familiar with Git, for example by having experience from lilypond.org translation; see http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=README;hb=web/master +If you do not have this experience, you may want to read the first two +chapters of Git User's Manual at +http://www.kernel.org/pub/software/scm/git/docs/user-manual.html + REQUIREMENTS @@ -89,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. @@ -111,63 +115,64 @@ Files marked with priority 3, 4 or 5 may be submitted individually. Word counts (excluding lilypond snippets) are given for each file. -1- Documentation index and Tutorial -407 user/lilypond-learning.tely +429 user/lilypond-learning.tely 6365 user/tutorial.itely 23 user/dedication.itely -413 user/macros.itexi +423 user/macros.itexi 171 index.html.in -6339 po/lilypond-doc.pot (translate to po/.po) -13718 total +6346 po/lilypond-doc.pot (translate to po/.po) +--- ../lilypond-texi2html.init (section TRANSLATIONS) +13757 total -2- Introduction and beginning of Application Usage 411 user/preface.itely 3855 user/introduction.itely -385 user/lilypond-program.tely -1926 user/install.itely (partial translation) +407 user/lilypond-program.tely +1930 user/install.itely (partial translation) 1149 user/setup.itely -2896 user/running.itely -10622 total +2827 user/running.itely +10579 total -3- Learning manual 10318 user/fundamental.itely -- Fundamental concepts -14578 user/tweaks.itely -- Tweaking output +14647 user/tweaks.itely -- Tweaking output 3007 user/working.itely -- Working on LilyPond files 483 user/templates.itely -- Templates -28386 total +28455 total -4- Notation reference -672 user/lilypond.tely +695 user/lilypond.tely 91 user/notation.itely -- Musical notation -3083 user/pitches.itely -5005 user/rhythms.itely -1110 user/expressive.itely +3123 user/pitches.itely +5013 user/rhythms.itely +1146 user/expressive.itely 555 user/repeats.itely -1452 user/simultaneous.itely -1633 user/staff.itely -902 user/editorial.itely -2443 user/text.itely +1455 user/simultaneous.itely +1701 user/staff.itely +895 user/editorial.itely +2286 user/text.itely 76 user/specialist.itely -- Specialist notation -2678 user/vocal.itely -1326 user/chords.itely +2670 user/vocal.itely +1464 user/chords.itely 702 user/piano.itely 810 user/percussion.itely 826 user/guitar.itely 66 user/strings.itely 242 user/bagpipes.itely -4240 user/ancient.itely -5803 user/input.itely -- Input syntax +4487 user/ancient.itely +5805 user/input.itely -- Input syntax 2164 user/non-music.itely -- Non-musical notation -8444 user/spacing.itely -- Spacing issues -11291 user/changing-defaults.itely -- Changing defaults +8451 user/spacing.itely -- Spacing issues +11391 user/changing-defaults.itely -- Changing defaults 5202 user/programming-interface.itely -- Interfaces for programmers -1155 user/notation-appendices.itely -- Notation manual tables +1190 user/notation-appendices.itely -- Notation manual tables 250 user/cheatsheet.itely -- Cheat sheet -62221 total +62756 total -5- Application usage -3202 user/lilypond-book.itely -- LilyPond-book +3248 user/lilypond-book.itely -- LilyPond-book 1171 user/converters.itely -- Converting from other formats -4373 total +4419 total -6- Appendices whose translation is optional 310 user/literature.itely @@ -361,7 +366,11 @@ This script overwrites music snippets in /user/every.itely with music snippets from user/every.itely. It ignores skeleton files, and keeps intact music snippets preceded with a line starting with '@c KEEP LY'; it reports an error for each .itely that has not the same -music snippet count in both languages. +music snippet count in both languages. Always use this script with a +lot of care, i.e. run it on a clean Git working tree, and check the +changes it made with "git diff" before committing; if you don't do so, +some @lilypond snippets might be broken or make no sense in their +context. Finally, a command runs the three update processes above for all enabled languages (from Documentation): @@ -661,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/aux/: -* 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/aux/ or scripts/build/ (but +not by installed Python scripts) are located in python/aux/: +* 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