Let's use Hoge-HOWTO as our sample here.
Create a directory in the same name as the document under
$ svn addto put it under the control of svn.
Then do svn commit as required.
Perhaps in creating this xml file mere copying one from another document directory might be a quick fix but let me write some rules to apply at the beginning of the file.
<?xml version="1.0" encoding="EUC-JP"?> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ <!ENTITY % kent SYSTEM "../../momonga.ent"> %kent; ]> <article id="index" lang="ja">
A declaration that this file is an xml file. Xml has UTF-8 as default encoding. When another encoding is used, it should be declared as well.
A declaration to use XML DocBook DTD Version 4.1.2.
URL where DTD is actually located. This is mandatory since it is not DocBook sgml.
Reading in momonga.ent file.
Take this as a declaration to use references defined in momonga.ent file.
This is an root element of this document,
Since it is in Japanese, lang character is set as ja. As a result of this, output html files would have ja as language type, would be encoded in EUC-JP, and have "Table of Contents" translated to the appropriate term in the language.
Omf stands for Open Source Metadate Framework. For details, refer to metalab.
Its contents should be
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?> <omf> <resource> <title> Hoge-HOWTO </title> <subject> <category>General|Linux|Distributions|Momonga</category> </subject> <format mime="text/xml"/> <identifier url="Hoge-HOWTO.xml"/> <language code="C"/> </resource> </omf>Something like that.
docs/Hoge-HOWTO/Makefile.am, list up directories
specific to available languages like below:
SUBDIRS = C ja
docs/Hoge-HOWTO/C/Makefile.am, it should have
something like the following:
docname = Hoge-HOWTO lang = en omffile = Hoge-HOWTO-C.omf xml_ents = include $(top_srcdir)/xmldocs.make dist-hook: app-dist-hook figs = \ figures/hoge1.jpg \ figures/hoge2.png
Next go to
docs and do
ruby checknew.rbThen an entry for Hoge-HOWTO is added in
$ ./autogen.sh $ maketo sythesize html and txt under
docs/Hoge-HOWTO/ja. If you confirm that there has not been any errors doing make then do svn commit.