mirror of https://github.com/mpv-player/mpv
55 lines
2.5 KiB
Plaintext
55 lines
2.5 KiB
Plaintext
The documentation and its translations reside in subdirectories.
|
|
When building the documentation, the toplevel Makefile goes into
|
|
the subdirectories listed in the SUBDIRS variable and executes make
|
|
in each of those directories to create the HTML documentation
|
|
in subdirectories of the 'HTML' directory.
|
|
|
|
IMPORTANT: Do NOT place sensitive files under 'HTML'!
|
|
It is for generated documentation only.
|
|
The whole directory tree is wiped out by the Makefile
|
|
when running 'make distclean' or 'make clean-html'.
|
|
Also, subdirectories are wiped out one by one before
|
|
creating the HTML files.
|
|
|
|
Each subdirectory must have a Makefile. Its purpose is to include
|
|
the toplevel Makefile.inc file (with the rules to build the docs)
|
|
and add dependency information to the main target, $(HTMLDIR)/index.html.
|
|
The main target usually depends on all the XML and XSL files in the
|
|
subdirectory. (Note that the toplevel *.xsl files are added automatically
|
|
by Makefile.inc, so you do not have to list them.)
|
|
|
|
|
|
Adding new translations
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
1) Create a new subdirectory and copy the XML files there.
|
|
2) Make sure to create a 'Makefile' for the translation -- you can
|
|
use 'en/Makefile' as an example.
|
|
3) Set <book lang="XX"> to your language code if the DocBook XSL
|
|
stylesheets support it.
|
|
4) If you want to use a customized XSL stylesheet, create one and name it
|
|
'html.xsl'. And do not forget to import the toplevel XSL file:
|
|
|
|
<xsl:import href="../html.xsl"/>
|
|
|
|
Note: You mustn't xsl:include or xsl:import chunk.xsl directly!
|
|
Including it can (and will) break building of documentation if chunk.xsl
|
|
is installed at a nonstandard location.
|
|
5) If you wish to change output encoding of generated files, create html.xsl
|
|
as suggested in step 4) and add somwhere after <xsl:import .../> such string:
|
|
|
|
<xsl:param name="chunker.output.encoding" select="'your_encoding'"/>
|
|
|
|
Use ru/html.xsl as example.
|
|
6) If you are using your own HTML stylesheet, edit your Makefile and set
|
|
the HTML_STYLESHEET variable to its name.
|
|
7) In each translated file after the <?xml ... ?> tag you must put a note
|
|
like <!-- synced with 1.2 -->, where 1.2 is the revision of corresponding
|
|
English file (see comment at the top of file).
|
|
8) While your translation isn't finished, you can change USE_SYMLINKS
|
|
to "yes" in your Makefile. This will help you testing your translation:
|
|
english files will be used instead of untranslated ones, when generating
|
|
HTML docs.
|
|
|
|
That's all, in theory.
|