forked from TortoiseGit/TortoiseGit
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
71 lines (50 loc) · 2.72 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
Documentation
=============
You can find the "readable" version of the TortoiseGit manual under
https://tortoisegit.org/docs/tortoisegit/.
For general information on TortoiseGit please see https://tortoisegit.org/ or the [README file in the root](README.md).
HowTo build the docs
====================
First of all you need a local copy of the TortoiseGit repository.
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 (for PDF generation)
tools\xsl\ - the docbook xsl files from sourceforge
tools\ - xsl processor, hhc.exe, ...
you can download all the required tools as a 7-Zip package from the TortoiseSVN project:
<https://osdn.net/projects/tortoisesvn/storage/build%20tools/>
Use 7-zip extract the tools-*.7z file to e.g. \TortoiseGit\Tools. 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.
Please note that having spaces in your directory path will (for the time being)
cause the documentation build process to fail.
For chm docs you need:
- Microsofts makehm.exe, Part of visual studio, sources available on msdn
- Microsofts html workshop, Binaries available on msdn
If you want to update the git-man pages see [source/en/TortoiseGit/git_doc.patch](doc/source/en/TortoiseGit/git_doc.patch).
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
xsl\ - contains the stylesheets for the doc creation
dtd\ - contains the tools and the dtd to validate and build the docs.
Please see [Screenshots.txt](doc/Screenshots.txt) for notes on how to create screenshots.
Building the docs
=================
NAnt Build
----------
VS->Tools->Visual Studio 2013 command line
cd TortoiseGit
cd doc
..\tools\nant\nant.exe
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.
All other parameters are defined in doc.build.include. You can override all settings
in doc.build.user or via the NAnt command line.