• R/O
  • SSH
  • HTTPS

tortoisesvn: Dateibaum


Name Größe Rev. Zeit Autor Log Message
issuetrackers.txt 8.73 k r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
images r4468 2005-09-24 01:18:03 stefankueng Remove unused doc images.
TortoiseAPI.bat 311 r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
xml2po.py 23.82 k r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
API r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
readme.txt 3.99 k r3711 2005-06-16 22:45:30 luebbe.tortoisesvn Combined build.txt and readme.txt int...
dtd r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
po r4469 2005-09-24 01:19:53 stefankueng If Apache runs as a system service, t...
IgnoreList.bat 50 r4343 2005-09-06 21:06:20 simonlarge Remove tsvn_app_faq.xml from the igno...
xml2po-modes r4439 2005-09-22 00:51:46 luebbe.tortoisesvn Added 'table' to the list of final ta...
TranslateDoc.bat 2.9 k r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
CreatePot.bat 1019 r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
MailingListAnswers.txt 4.51 k r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
templates r2908 2005-03-25 04:37:34 stefankueng Improved regex to catch more issues i...
source r4469 2005-09-24 01:19:53 stefankueng If Apache runs as a system service, t...
logo r4189 2005-08-19 02:54:52 stefankueng New bitmaps for the installer.
UploadDocs.bat 1.53 k r3982 2005-07-24 21:06:25 stefankueng Set the svn:eol-style property on all...
ImageStatus.txt 2.5 k r4450 2005-09-22 19:51:50 simonlarge Combine Commit.png and CommitContextM...
GenDoc.bat 1.58 k r4154 2005-08-15 03:52:30 stefankueng reorganize the build scripts - Use se...

readme.txt

HowTo build the docs
====================

Since you are already reading this, I assume that you have succeeded in checking 
out the TortoiseSVN or just the doc sources.

Tools needed:
=============

There are some tools for processing the XML input that you need to build the docs.
Scripts and dtd are included, but the executables (formatting processor, microsoft
help compiler, translation tools) have to be installed separately.

tools\fop\		- the fop processor
tools\xsl\		- the docbook xsl files from sourceforge
tools\			- xsl processor, hhc.exe, ...

you can download all the required tools as a zip package from our website:
http://tortoisesvn.tigris.org/servlets/ProjectDocumentList?folderID=616

Then, make a copy of the file TortoiseVars.tmpl in the TSVN root folder and
rename that copy to TortoiseVars.bat. Then simply adjust the paths as mentioned
in that file.

Please note that having spaces in your directory path will (for the time being)
cause the documentation build process to fail.

To build only the english docs, that's all you need. If you want to build translated
docs as well, you need:
- A Python runtime environment
  (http://www.python.org)
- The Python libxml2 bindings
  (http://users.skynet.be/sbi/libxml-python/)
- Aspell (optional) for spell checking translations
  (ftp://ftp.gnu.org/gnu/aspell/w32/)


Structure:
==========
The most important directories for you are:
source\en - contains the english XML text source.
images\en - contains the base (english) images for the docs. If you don't localize 
	    your screenshots, these will be used instead.
images\*  - contain the localized screenshots for other languages.
po\*      - contain the translations for each language. Best edited with poEdit.
tools     - contains the tools and the dtd to validate and build the docs.
	    You might want to place your tools directory somewhere else on your 
            harddisk, if you want to use it to build other docs too. This will 
            however require tweaking the build scripts.
            I'd recommend to leave tools\dtd in place, so the source stays 
            compatible between TSVN doc developers.

The scripts:
============
Three scripts are provided to build the documentation:

TranslateDoc.bat:
  will translate into the given language if the po file exists.
  If no parameter is given, all .po files found in doc\po will be
  used to create the corresponding target languages.
  This script requires python, libxml2 and aspell.
  A log is written to "translatelog.txt"

Example: "TranslateDoc de" will use de.po and the English xml files to
  build the German document stucture in source\de

GenDoc.bat:
  will loop over all known applications and build the docs in
  English plus all .po files it finds inside "doc\po" 
  (so don't place any nonsense or backup .po files there)
  This script requires python and libxml2
  The script retranslates all source files while building, so there's
  no need to run "TranslateDoc" before "GenDoc". "GenDoc" doesn't
  run the spellchecker on the source.

source\MakeDoc.bat:
  is called from GenDoc.bat and will generate html, pdf and chm 
  docs for the given application and language.
  makedoc.bat takes three or more parameters where
  %1 = Target application to build docs for
  %2 = Target language (as in source/en)
  %3..%5 = any of [pdf chm html]

  "makedoc tortoisesvn de pdf"      will build the pdf docs in directory source/de  
                                    (German) for tortoisesvn. Simple.
  "makedoc tortoisesvn en chm html" will build the chm and html docs in directory 
                                    source/en (English)

Translate:
==========
If you want to translate the docs into a new language (assume french), just go ahead
and copy po\doc.pot to po\fr.po. Start to translate phrases and test your translation
with "TranslateDoc fr" and "makedoc tortoisesvn fr".

Place localized screenshots in images\fr. We document which images need updating in
ImageStatus.txt. Just add another column for french.

Now go ahead and translate the rest.

Cheers
-Lübbe
Show on old repository browser