• R/O
  • SSH
  • HTTPS

tortoisesvn: Dateibaum


Name Größe Rev. Zeit Autor Log Message
xml2po.py 24.93 k r22208 2011-10-28 16:28:26 luebbe.tortoisesvn Patch by Simon Large fixes pot creati...
API r26276 2015-02-10 03:42:28 stefankueng Remove the project properties from tr...
readme.txt 3.81 k r26433 2015-04-05 00:00:07 stefankueng update links to the tools zip.
test r26276 2015-02-10 03:42:28 stefankueng Remove the project properties from tr...
Aspell r26276 2015-02-10 03:42:28 stefankueng Remove the project properties from tr...
doc.build.include 12.94 k r26711 2015-08-18 06:41:51 csware Use UTF-8 encoding Without this ther...
xml2po-modes r26276 2015-02-10 03:42:28 stefankueng Remove the project properties from tr...
scripts r26276 2015-02-10 03:42:28 stefankueng Remove the project properties from tr...
notes r28194 2018-04-17 02:24:38 stefankueng Mention the inherited properties.
doc.build.user.tmpl 1.66 k r19757 2010-06-25 15:14:21 stefankueng converted tabs to spaces.
presentations r26276 2015-02-10 03:42:28 stefankueng Remove the project properties from tr...
source r28524 2019-03-12 05:25:21 stefankueng make the number of items kept in the ...
logo r27718 2017-02-26 07:58:59 xhmikosr New tortoisesvn_logo_hor468x64.psd. ...
UploadDocs.bat 1.27 k r24155 2013-05-01 17:34:01 XhmikosR minor changes to the batch files
doc.build 24.24 k r26103 2014-12-11 05:47:39 stefankueng Use the micro version number as well ...
CheckIDD.bat 433 r19799 2010-07-04 09:21:14 simon.tortoisesvn Add an IDD_ ignore list for TortoiseP...
images r28365 2018-09-16 00:15:40 stefankueng update the context menu images in the...
xsl r27044 2015-12-14 03:09:28 stefankueng As of Win8.1, msgothic has been repla...

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.
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 7zip package from our website:
https://sourceforge.net/projects/tortoisesvn/files/build%20tools/

The file is Tools-1.x.7z

Currently you can build the docs using NAnt. Download a current release from:
http://nant.sourceforge.net
Note: NAnt requires the full .NET framework installed, not just the client profile.

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/)

For Chm docs you need:
- Microsoft's makehm.exe, part of visual studio, sources available on MSDN
- Microsoft's html workshop, binaries available on MSDN


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\*  - 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 TortoiseSVN 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 customizations, 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.

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

Now go ahead and translate the rest.

Cheers
-Lübbe
Show on old repository browser