Permalink
Cannot retrieve contributors at this time
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
2015OmegaT/OmegaT/doc_src/Readme.txt
Go to fileThis commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
135 lines (87 sloc)
4.13 KB
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
***License*** | |
All the files in this directory and below are under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. | |
***Installation*** | |
The creation of the documentation requires a number of tools: | |
- DocBook XSL Stylesheets 1.75.2 ("dbk") | |
- DocBook XML 4.5 | |
- fop 1.1 | |
- libxml2 2-2.7.7 | |
- Saxon 6-5-5 | |
- Ant 1.7.1 or above | |
For efficiency reason, the path to the DTD in the DocBook files (e.g., AboutOmegaT.xml) has been changed to a local path (../../../docbook-xml-4.5/docbookx.dtd instead of an http:// reference). Depending on the actual configuration, it might be changed to a standard reference ("http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd") or to another local reference. | |
***Windows*** | |
dbk must be installed at the root of c:\ | |
c:\dbk\common | |
c:\dbk\docsrc | |
etc. | |
Docbook-xml-4.5 must be installed at the same level as your OmegaT development folder. | |
So, if you have | |
c:\dev\omegat-trunk | |
c:\dev\omegat-trunk\src | |
c:\dev\omegat-trunk\doc_src | |
etc. | |
you would have | |
c:\dev\docbook-xml-4.5\ent | |
c:\dev\docbook-xml-4.5\calstblx.dtd | |
etc. | |
libxml2-2.7.7 and apache-ant must be installed where a path can find them, usually in Program Files. | |
C:\Program Files\libxml2-2.7.7.win32 | |
C:\Program Files\apache-ant | |
Corresponding path: | |
path=C:\Program Files\libxml2-2.7.7.win32\bin;C:\Program Files\apache-ant\bin | |
fop-1.1 can be installed anywhere, usually in Program Files. | |
C:\Program Files\fop-1.1 | |
The location of fop-1.1, dbk and Saxon must be set in doc_src_paths.xml, in the corresponding properties: | |
<property name="fop.home" value="C:\Program Files\fop-1.1" /> | |
<property name="dbk" value="c:\dbk" /> | |
<property name="saxon" value="C:\Program Files\saxon6-5-5\saxon.jar" /> | |
The location of dbk must also be set in docbook-utf8.xsl: | |
<xsl:import href="file:///c:\dbk\html\docbook.xsl"/> | |
Both doc_src_paths and docbook-utf8.xsl must be copied at the same level as your OmegaT development folder. | |
c:\dev\doc_src_paths.xml | |
c:\dev\docbook-utf8.xsl | |
The ones available in doc_src are only there for reference. | |
***Mac OSX*** | |
All the dependencies can be installed through Macports except for Saxon 6-5-5 | |
Macports: | |
http://www.macports.org/ | |
Saxon 6-5-5 | |
https://sourceforge.net/projects/saxon/files/saxon6/6.5.5/ | |
Unzip the downloaded package and put it in your prefered location. The example below uses the /Applications/ folder. | |
If you use Macports, the doc_src_paths.xml settings are: | |
<property name="fop.home" value="/opt/local/share/java/fop/1.0" /> | |
<property name="dbk" value="/opt/local/share/xsl/docbook-xsl" /> | |
<property name="saxon" value="/Applications/saxon6-5-5/saxon.jar" /> | |
and the docbook-utf8.xsl settings are: | |
<xsl:import href="file:///opt/local/share/xsl/docbook-xsl/html/docbook.xsl"/> | |
The DocBook 4.5 DTD is located here: | |
/opt/local/var/macports/software/docbook-xml-4.5/4.5_0/opt/local/share/xml/docbook/4.5/ | |
Copy the /4.5/ folder to the folder that is three folders "higher" than the DocBook documentation source files in your folder tree and rename it /docbook-xml-4.5/. | |
So, if you have your DocBook documentation source files in: | |
/path/to/omegat/branches/release-2-3/doc_src/hu/ | |
The /docbook-xml-4.5/ folder should be copied inside /branches/: | |
/path/to/omegat/branches/docbook-xml-4.5/ | |
Both doc_src_paths.xml and docbook-utf8.xsl must be copied at the same level as /docbook-xml-4.5/. | |
The ones available in doc_src are only there for reference. | |
***Fonts*** | |
Creating PDFs requires having the DejaVu Sans font family available. | |
Creating PDFs for CJK languages requires having the Arial Unicode MS font family available. | |
***Usage*** | |
All the scripts require the language folder as argument. | |
E.g.: | |
Building Instant Start only | |
ant -Dlanguage=en instant-start | |
Building everything except Javahelp: | |
ant -Dlanguage=en | |
Building HTML | |
ant -Dlanguage=en html | |
Building PDF | |
ant -Dlanguage=en pdf | |
Building PDF for a CJK language | |
ant -Dlanguage=ja pdf-cjk | |
Building Javahelp | |
ant -Dlanguage=en javahelp | |
***Scripts*** | |
build.xml: Main script. | |
doc_src_paths.xml: Set the paths for utilities. | |
docbook-utf8.xsl: Allows to issue the Instant Start Guide in UTF-8. |