• R/O
  • SSH

tortoisesvn: Dateibaum

Name Größe Rev. Zeit Autor Log Message
source r13512 2008-07-21 07:38:55 simonlarge Merge r13379 from trunk: Fix few omis...
logo r13068 2008-06-01 00:32:29 stefankueng Add Photoshop template for the instal...
UploadDocs.bat 1.36 k r7154 2006-07-29 16:14:16 stefankueng Upload the docs to the new server.
doc.build 20.28 k r12724 2008-04-20 16:20:39 stefankueng Patch from KURASAWA Nozomu (nabetaro)...
issuetrackers.txt 9.78 k r12792 2008-04-27 17:06:07 stefankueng Extend the issue tracker integration ...
images r13510 2008-07-21 07:19:18 simonlarge Merge doc changes from trunk: * r1336...
xsl r13322 2008-06-22 02:47:14 stefankueng Merge r13320-13321 from trunk: * igno...
AutolistDoc.txt 2.01 k r10770 2007-09-28 16:30:21 klenin Log time spent building autocompletio...
xml2po.py 24.28 k r10838 2007-10-02 17:32:04 luebbe.tortoisesvn xml2po.py: - Little change that place...
API r11715 2007-12-31 03:52:12 stefankueng Fix the tsvn:autoprops property: the ...
readme.txt 3.81 k r12612 2008-04-11 05:04:01 jeanmarc Use a bit more real estate for images...
build-zh_CN.txt 7.89 k r9599 2007-05-29 21:07:25 dongsheng.song Update Simplified Chinese translation...
po r13546 2008-07-25 22:03:22 stannic Russian TortoiseSVN doc translation a...
Screenshots.txt 11.35 k r13179 2008-06-10 16:58:13 simonlarge Update Screenshots.txt to describe us...
test r13141 2008-06-06 01:13:26 stefankueng Patch from Kari Grano: Make the test ...
Aspell r13381 2008-06-29 22:25:51 stannic Merge r13380 from trunk: * set svn:eo...
doc.build.include 12.4 k r13301 2008-06-19 21:06:32 luebbe.tortoisesvn Add Dutch and Persian to the general ...
xml2po-modes r11715 2007-12-31 03:52:12 stefankueng Fix the tsvn:autoprops property: the ...
doc.build.user.tmpl 1.62 k r10228 2007-07-25 23:47:28 stannic Doc build system: - "Version" on titl...
MailingListAnswers.txt 4.51 k r6599 2006-05-26 07:45:07 stefan.fuhrmann.1974 fix a typo (may embarrass us in *that...
templates r11715 2007-12-31 03:52:12 stefankueng Fix the tsvn:autoprops property: the ...


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.
You will also need to have a Java Runtime Environment version 1.3.x or above.

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:

Note that building the documentation for TSVN version 1.5 and later, you need the

Currently you can build the docs using NAnt. Download a current release from:

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
- The Python libxml2 bindings
- Aspell (optional) for spell checking translations

For Chm docs you need:
- Microsofts makehm.exe, Part of visual studio, sources available on msdn
- Microsofts html workshop, Binaries available on msdn

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\*  - contains the localized screenshots for other languages.
po\*      - contains the translations for each language. Best edited with poEdit.
xsl\	  - contains the stylesheets for the doc creation
dtd\      - 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 dtd in place, so the source stays 
            compatible between TSVN doc developers.
Building the docs:

NAnt Build:
A NAnt build script has been provided to build the docs. When doc.build is run for
the first time, the template doc.build.include.template is copied to doc.build.include.

For local customisations, copy the doc.build.user.tmpl file to doc.build.user and
modify that copy to point to the location of the tools on your system.

If you want to build the Japanese docs, you have to copy xsl\ja\userconfig.template.xml
to xsl\ja\userconfig.xml and adjust the path settings to the japanese fonts.

Currently nant supports three targets "all", "clean" and "potfile".
- "all" builds all the docs that are out of date. Runs the target "potfile" too.
- "clean" cleans only the output directory
- "potfile" updates the po template from the source document.

All other parameters are defined in doc.build.include. You can override all settings
in doc.build.user or via the NAnt command line.

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. The file "screenshots.txt" contains some 
instructions on how/where the images have been captured. 

Now go ahead and translate the rest.

Show on old repository browser