From a90e5bb79f3f78799d15efe6ee50155f17485035 Mon Sep 17 00:00:00 2001 From: John Mandereau Date: Fri, 29 Jun 2007 14:07:32 +0200 Subject: [PATCH] Fix and update TRANSLATION Thanks to Francisco Vila. --- Documentation/TRANSLATION | 33 ++++++++++++++++++++++++--------- 1 file changed, 24 insertions(+), 9 deletions(-) diff --git a/Documentation/TRANSLATION b/Documentation/TRANSLATION index a34cd4b0ec..6b03886d03 100644 --- a/Documentation/TRANSLATION +++ b/Documentation/TRANSLATION @@ -5,7 +5,7 @@ SOURCES The sources live in a GIT repository. Git 1.4.4.1 or newer is required, and Git 1.5.x is highly recommended. To get a fresh version -run +of LilyPond sources run mkdir lily ; cd lily git init-db @@ -29,6 +29,16 @@ Working on LilyPond documentation translations requires: * gettext +WHICH DOCUMENTATION CAN BE TRANSLATED + +The makfiles and scripts infrastructure currently supports translation +of the following documentation: + + * documentation index (HTML) + * user manual -- Texinfo source, PDF and HTML output; Info output +might be added if there is enough demand for it. + + STARTING A TRANSLATION IN A NEW LANGUAGE At top of the source directory, do @@ -56,6 +66,7 @@ buildscripts/langdefs.py. See next section about what files to translate and the following detailed instructions after the next section. + FILES TO BE TRANSLATED All the following files are in Documentation/ @@ -213,9 +224,9 @@ replace 'make' with 'make -C Documentation') and run make ISOLANG= check-translation This presents a diff of the original files since the most recent -revision of the translation. To check a single page, run +revision of the translation. To check a single file, run - buildscripts/check-translation.py Documentation/user//foo/bar.itely + python buildscripts/check_translation.py Documentation//user/foo.itely @@ -240,12 +251,16 @@ TECHNICAL BACKGROUND A number of Python scripts handle a part of the documentation translation process: -langdefs.py -- language definitions -check_translation.py -- show diff to update a translation -texi-langutils.py -- quickly and dirtily parse Texinfo files to +* langdefs.py -- language definitions +* 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 -html-gettext.py -- translate node names, section titles and cross +* texi-skeleton-update.py -- update Texinfo skeleton files +* html-gettext.py -- translate node names, section titles and cross references in HTML files generated by makeinfo -add_html_footer.py (module called by www_post.py) -- add footer and +* add_html_footer.py (module called 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 -- 2.39.5