X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2FTRANSLATION;h=1dbb9af5fadabf5387037bb4f05112d21059751d;hb=a8d59748660a6d6ad4c64679f24e14914164812b;hp=fb4b6cbc755bdfff83c356ad4107fde92a940a25;hpb=3a991b6913837bac6d0ea429b583295b9263e049;p=lilypond.git diff --git a/Documentation/TRANSLATION b/Documentation/TRANSLATION index fb4b6cbc75..1dbb9af5fa 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 -423 user/macros.itexi +432 user/macros.itexi 171 index.html.in -6411 po/lilypond-doc.pot (translate to po/.po) -13800 total +6390 po/lilypond-doc.pot (translate to po/.po) +--- ../lilypond-texi2html.init (section TRANSLATIONS) +13810 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 +1901 user/install.itely (partial translation) 1149 user/setup.itely -2896 user/running.itely -10622 total +2827 user/running.itely +10550 total -3- Learning manual 10318 user/fundamental.itely -- Fundamental concepts -14581 user/tweaks.itely -- Tweaking output -3007 user/working.itely -- Working on LilyPond files -483 user/templates.itely -- Templates -28389 total +14775 user/tweaks.itely -- Tweaking output +3144 user/working.itely -- Working on LilyPond files +498 user/templates.itely -- Templates +28735 total -4- Notation reference -672 user/lilypond.tely +695 user/lilypond.tely 91 user/notation.itely -- Musical notation -3086 user/pitches.itely -5013 user/rhythms.itely +3123 user/pitches.itely +5215 user/rhythms.itely 1146 user/expressive.itely 555 user/repeats.itely -1455 user/simultaneous.itely -1635 user/staff.itely -906 user/editorial.itely -2472 user/text.itely +1456 user/simultaneous.itely +1701 user/staff.itely +905 user/editorial.itely +2376 user/text.itely 76 user/specialist.itely -- Specialist notation -2638 user/vocal.itely -1333 user/chords.itely +2725 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 -4486 user/ancient.itely -5805 user/input.itely -- Input syntax +4487 user/ancient.itely +5873 user/input.itely -- Input syntax 2164 user/non-music.itely -- Non-musical notation -8447 user/spacing.itely -- Spacing issues -11291 user/changing-defaults.itely -- Changing defaults +8569 user/spacing.itely -- Spacing issues +11747 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 -62524 total +63656 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 @@ -665,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