@@ -9,7 +9,7 @@ target: book book/default.css book.html book.pdf # The book consists of these text files in the following order: TXTFILES := preface.txt intro.txt basic.txt clone.txt branch.txt history.txt \ - grandmaster.txt secrets.txt drawbacks.txt + grandmaster.txt secrets.txt drawbacks.txt translate.txt book.xml: $(addprefix $(LANG)/,$(TXTFILES)) # Kludge to make preface sections work for languages besides English. Makefile @@ -46,32 +46,3 @@ or from one of the mirrors: $ git clone git://github.com/blynn/gitmagic.git $ git clone git://gitorious.org/gitmagic/mainline.git - -=== How to Translate This Guide === - -Clone the source, then create a directory corresponding to the target http://www.iana.org/assignments/language-subtag-registry[language's IETF tag]: see -http://www.w3.org/International/articles/language-tags/Overview.en.php[the W3C article on internationalization]. For example, English is "en", Japanese is "ja", and Traditional Chinese is "zh-Hant". In the new directory, and translate the +txt+ files from the "en" subdirectory. - -For instance, to translate the guide into http://en.wikipedia.org/wiki/Klingon_language[Klingon], you might type: - - $ git clone git://repo.or.cz/gitmagic.git - $ cd gitmagic - $ mkdir tlh # "tlh" is the IETF language code for Klingon. - $ cd tlh - $ cp ../en/intro.txt . - $ edit intro.txt # Translate the file. - -and so on for each text file. You can review your work incrementally: - - $ make LANG=tlh - $ firefox book.html - -Commit your changes often, then let me know when they're ready. -GitHub.com has an interface that facilitates this: fork the "gitmagic" project, -push your changes, then ask me to merge. - -I like to have translations follow the above scheme so my scripts can produce -HTML and PDF versions. Also, it conveniently keeps all the translations in the -official repository. But please do whatever suits you best: for example, the -Chinese translators used Google Docs. I'm happy as long as your work -enables more people to access my work. en/preface.txt @@ -30,16 +30,15 @@ do sed 's/pr01\.html/index.html/g' -i $FILE # Paste ToC into beginning and add div section with class content for CSS. sed '/<body/{n; r toc.tmp - a <div class="content"> - } ' -i $FILE +a <div class="content"> +}' -i $FILE sed '/^<\/body/i </div>' -i $FILE fi done # Originally this link was "My Homepage". Since it appears on translations of # the guide, I changed it to my name so it doesn't have to be translated. -sed '/^<\/body/i </div><div class="footer"><a href="/~blynn/">Ben -Lynn</a></div>' -i $BOOKDIR/*.html +sed '/^<\/body/i </div><div class="footer"><a href="/~blynn/">Ben Lynn</a></div>' -i $BOOKDIR/*.html cp $BOOKDIR/pr01.html $BOOKDIR/index.html rm toc.tmp makeover e39c56dc7d659d459b55546e701ce9652bab4681 Ben Lynn benlynn@gmail.com http://github.com/blynn/gitmagic/commit/9b5b4ef73f24d471f9241b89f1dfb4b928f8fd80 9b5b4ef73f24d471f9241b89f1dfb4b928f8fd80 2009-06-09T00:02:15-07:00 2009-06-09T00:02:15-07:00 Moved translation hints to appendix. 74b1f3354b477b5c5994e953fbf2498e6a1ac2b7 Ben Lynn benlynn@gmail.com