Author: bbbush
Update of /cvs/docs/documentation-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27776
Modified Files:
acknowledgments-zh_CN.xml docs-emacs-zh_CN.xml
docs-getting-files-zh_CN.xml docs-intro-zh_CN.xml
docs-rh-guidelines-zh_CN.xml docs-tutorial-zh_CN.xml
docs-vim-zh_CN.xml docs-xml-tags-zh_CN.xml
documentation-guide-zh_CN.xml
Log Message:
update build part
Index: acknowledgments-zh_CN.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/acknowledgments-zh_CN.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- acknowledgments-zh_CN.xml 9 Dec 2005 15:28:54 -0000 1.1
+++ acknowledgments-zh_CN.xml 17 Dec 2005 13:28:38 -0000 1.2
@@ -7,4 +7,5 @@
<para>Joshua Daniel Franklin (joshuadfranklin at
yahoo.com)
������������������������������ <xref linkend="ch-vim"/>���</para>
<para>Karsten Wade (kwade at
redhat.com) ������������������������������ <xref
linkend="s1-screenshots"/>��������� Paul W. Frields (stickstr5 at
hotmail.com) ���������</para>
<para>Paul W. Frields (stickstr5 at
hotmail.com) ���������������������������
<xref linkend="s1-xml-tags-screen"/> ������
<command>screen</command> ���������������������������������</para>
+ <para>��������� Tommy Reynolds (Tommy.Reynolds at
MegaCoder.com)
���������������������������������������������</para>
</chapter>
Index: docs-getting-files-zh_CN.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/docs-getting-files-zh_CN.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- docs-getting-files-zh_CN.xml 9 Dec 2005 15:28:54 -0000 1.1
+++ docs-getting-files-zh_CN.xml 17 Dec 2005 13:28:38 -0000 1.2
@@ -1,46 +1,286 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Id: --><!--
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
- <!ENTITY BOILERPLATE "This header makes editing XML easier" >
+<!ENTITY BOILERPLATE "This header makes editing XML easier" >
+<!ENTITY FDPX "Fedora Docs Project" >
+<!ENTITY FED "Fedora" >
]>
--><chapter id="ch-getting-files">
- <title>������������</title>
- <para>������������ Docs Project ��������������������������������� DocBook XML
���������������������������������������������������������������������</para>
- <itemizedlist>
- <listitem>
- <para>
- <filename>xmlto</filename> — ������ HTML ��� PDF
���������������</para>
- </listitem>
- <listitem>
- <para>
- <filename>docbook-style-xsl</filename> —
��������������������� XSLT ���������</para>
- </listitem>
- <listitem>
- <para>
- <filename>docbook-dtds</filename> — DocBook DTD ������ XML
���������</para>
- </listitem>
- </itemizedlist>
- <para>���������������������������������������
<computeroutput>cvs.fedora.redhat.com</computeroutput> CVS
��������������������������������������������������������������� DocBook XML
���������������</para>
- <para>��������������������������� docs CVS
������������������������������������������������������������������
<keycap>Enter</keycap>���</para>
- <screen>
- <userinput>mkdir my-fedora-docs
-cd my-fedora-docs
+ <title>������������</title>
+ <para>��������� &FED;
���������������������������������������������������������������������������������������������������</para>
+ <section id="ch-getting-files-system-packages">
+ <title>���������������</title>
+ <para>������������ Docs Project ��������������������������������� DocBook XML
���������������������������������������������������������������������</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>xmlto</filename> — ������ HTML ��� PDF
���������</para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>docbook-style-xsl</filename> —
������������������������ XSLT ������������</para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>docbook-dtds</filename> — DocBook DTD ������
XML ���������</para>
+ </listitem>
+ </itemizedlist>
+
<para>������������������������������������������������������������</para>
+ <screen>
+ <userinput>
+rpm -q xmlto
+rpm -q docbook-style-xsl
+rpm -q docbook-dtds
+</userinput>
+ </screen>
+ <para>������������������������������������
<application>yum(8)</application> ������������</para>
+ <screen>
+ <userinput>
+su -c 'yum install xmlto'
+su -c 'yum install docbook-style-xsl'
+su -c 'yum install docbook-dtds'
+</userinput>
+ </screen>
+ </section>
+ <section id="ch-getting-files-fdp">
+ <title>Fedora ������������</title>
+ <para>��������������������������������������������������������� &FDPX;
������������������������</para>
+ <para>���������������������������������������
<computeroutput>cvs.fedora.redhat.com</computeroutput> CVS
��������������������������������������������������������������� DocBook XML
���������������</para>
+ <para>������������������������������������ <keycap>Enter</keycap>
������������������������������������������������������������������������ &FDPX;
������������������</para>
+ <screen>
+ <userinput>mkdir my-fedora-docs-sandbox
+cd my-fedora-docs-sandbox
export CVSROOT=:pserver:anonymous@cvs.fedora.redhat.com:/cvs/docs
cvs login
cvs co docs-common
cvs co example-tutorial</userinput>
- </screen>
- <para>������������������ CVS
������������������������������������������������������������������������������������������������������������������������������������������
<abbrev>CVS</abbrev> ������������������������ <abbrev>CVS</abbrev>
������������������ <ulink
url="http://fedoraproject.org/wiki/DocsProject/NewWriters"/>...
- <para>���������������������������������</para>
- <screen>
- <userinput>cvs co -c</userinput>
- </screen>
- <para>������������������������������������������������������������</para>
- <screen>
- <userinput>cvs co example-tutorial</userinput>
- </screen>
- <para>������ <citetitle>&IG;</citetitle> ���������CVS
������������������������ DocBook XML article ���������������
<filename>example-tutorial</filename> ���������������������������������
<emphasis>������</emphasis> ��������������������������������������������� XML
���������</para>
+ </screen>
+ </section>
+ <section id="ch-getting-files-filenames">
+ <title>���������������</title>
+ <para>&FDPX; ������������������������������������������������
<abbrev>XML</abbrev> ��������������� <abbrev>HTML</abbrev> ���
<abbrev>PDF</abbrev>
���������������������������������������������������������������
<abbrev>RPM</abbrev> ������������</para>
+
<para>������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������</para>
+ <section id="ch-getting-files-filenames-doc">
+ <title>���������������</title>
+ <para>��������������������������������������������� &FED;
������������������ <filename>docs-common</filename>
���������������������������������������������������������������������������������������������������������������������
<userinput>cvs co -c</userinput>
������������������������������������</para>
+ </section>
+ <section id="ch-getting-files-i18n">
+ <title>��� I18N ������������������������</title>
+ <para>&FDPX;
���������������������������������������������������������������������������������������������������������������������������������������������������������</para>
+ <para>&FDPX; ������������������������������������������������������������
<abbrev>ISO</abbrev> ���������������������������������������������
<abbrev>US</abbrev>(������������)������������������
<filename>mydoc-en.xml</filename>������������������������������������������
<filename>mydoc-zh_CN.xml</filename>������������������</para>
+
<para>���������������������������������������������������������������������������
<abbrev>I18N</abbrev>
��������������������������������������������������������� <xref
linkend="ch-getting-files-i18n-table"/> ���������</para>
+ <table id="ch-getting-files-i18n-table">
+ <title>&FDPX; ���������������</title>
+ <tgroup cols="2">
+ <colspec align="right" colnum="1"
colwidth="*1"/>
+ <colspec colnum="2" colwidth="*5"/>
+ <thead>
+ <row>
+ <entry>
+ <phrase>������</phrase>
+ </entry>
+ <entry>
+ <phrase>������</phrase>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <phrase>
+ <replaceable>������������������������������</replaceable>
+ </phrase>
+ </entry>
+ <entry>
+
<para>������������������������������������������������������<emphasis>������������������(dash)</emphasis>���</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <filename>-</filename>
+ </phrase>
+ </entry>
+ <entry>
+ <para>��������� (<filename>-</filename>) ������������
<systemitem class="macro">${LANG}</systemitem>
������������������</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <systemitem class="macro">${LANG}</systemitem>
+ </phrase>
+ </entry>
+ <entry>
+ <para>
+ <systemitem class="macro">${LANG}</systemitem>
������������������������������
<wordasword>locale</wordasword>(������������)���</para>
+ <para>������������������������������������������������
<systemitem class="macro">${LANG}</systemitem>
������������������������������ <abbrev>UTF-8</abbrev>
������������������������������ <filename>mydoc-it.xml</filename>
��������������������� <systemitem
class="resource">it.UTF-8</systemitem>
���������������������</para>
+ <para>������������ <abbrev>I18N</abbrev>
��������������������������� <ulink url="http://www.openi18n.org"/>
���������</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <warning>
+ <title>���������������������������</title>
+ <para>��������������������� <emphasis>������</emphasis>
���������������������������������������������������������������</para>
+ </warning>
+ </section>
+ </section>
+ <section id="ch-getting-files-build-system">
+ <title>������������������</title>
+ <para>������������������������������������������
<abbrev>HTML</abbrev> ��� <abbrev>PDF</abbrev>
������������������������������������������������</para>
+ <para>��������������������� <application>make(1)</application>
��������� shell
������������������������������������������������������������������������������<emphasis>������</emphasis>
��������� shell ��������� <filename>Makefile</filename>
������������������������������������������������
<filename>Makefile</filename>���������������������������������������������������������
<filename>Makefile</filename> ��������������������������������� 'n
���������</para>
+ <para>���������<xref
linkend="ch-getting-files-build-system-makefile"/>
���������������������������(������������������������������������������)���������
<filename>Makefile</filename>���</para>
+ <example id="ch-getting-files-build-system-makefile">
+ <title>������������ Makefile(������������������)</title>
+ <programlisting width="60">
+DOCBASE = mydoc
+LANGUAGES = en
+XMLEXTRAFILES-en=
+include ../docs-common/Makefile.common
+</programlisting>
+ </example>
+ <para>��������������� <abbrev>XML</abbrev> ���������
<filename>mydoc-en.xml</filename>������������������������</para>
+ <para>
+ <systemitem class="macro">LANGUAGES</systemitem>
������������������������������������
<literal>en</literal>������������������������������������������������������������������������������������������</para>
+ <para>���������������������������������
<filename>mydoc-en.xml</filename>������������������������������������������������������
<systemitem class="macro">XMLEXTRAFILES-en</systemitem>
������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������</para>
+ <para>������������������
<literal>include</literal>(������)������������������������������������������
<filename>Makefile</filename>���<filename>Makefile.common</filename>
��������������������� <application>make(1)</application>
���������������������������������������������������������������������</para>
+ <para>���������������������������</para>
+ <orderedlist>
+ <listitem>
+ <para>������������������������������������������������������������������
<systemitem class="macro">${LANG}</systemitem>
������������������������������������������������</para>
+ </listitem>
+ <listitem>
+ <para>������ <filename>Makefile</filename>���������������
<systemitem class="macro">${LANG}</systemitem> ��� <systemitem
class="macro">LANGUAGES</systemitem> ������������</para>
+ </listitem>
+ <listitem>
+ <para>������������ <systemitem
class="macro">XMLEXTRAFILES-${LANG}</systemitem>
������������������������������������������������������������������������������������</para>
+ </listitem>
+ </orderedlist>
+ <section id="ch-getting-files-build-system-targets">
+ <title>������������������</title>
+ <para>������ <abbrev>XML</abbrev> ���������������
<abbrev>HTML</abbrev> ��� <abbrev>PDF</abbrev>������������������
<userinput>make html</userinput>, <userinput>make
html-nochunk</userinput>, ��� <userinput>make
pdf</userinput>���</para>
+ <para>
+ <xref linkend="ch-getting-files-build-system-targets-table"/>
������������������������������������������</para>
+ <table id="ch-getting-files-build-system-targets-table">
+ <title>������������������</title>
+ <tgroup cols="2">
+ <colspec align="right" colnum="1"
colwidth="*1"/>
+ <colspec colnum="2" colwidth="*5"/>
+ <thead>
+ <row>
+ <entry>
+ <phrase>������</phrase>
+ </entry>
+ <entry>
+ <phrase>������</phrase>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <phrase>
+ <filename>all</filename>
+ </phrase>
+ </entry>
+ <entry>
+ <para>������ <abbrev>HTML</abbrev>, ���
<abbrev>PDF</abbrev> ������������������������������������������</para>
+ <para>���������������������������
<application>tar(1)</application> ���
<application>rpm(8)</application>���</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <filename>tarball</filename>
+ </phrase>
+ </entry>
+ <entry>
+ <para>��������� <application>tar(1)</application>
������������������������������������</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <filename>pdf</filename>
+ </phrase>
+ </entry>
+ <entry>
+ <para>��������� <abbrev>PDF</abbrev>
������������������������������������</para>
+ <para>���������<abbrev>PDF</abbrev>
������������������������������������������</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <filename>html</filename>
+ </phrase>
+ </entry>
+ <entry>
+ <para>��������� <abbrev>HTML</abbrev>
������������������������������������������������������������������<systemitem
class="macro">${DOCBASE}</systemitem><filename>-</filename><systemitem
class="macro">${LANG}</systemitem><filename>/</filename>������������������������������������������������������</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <filename>html-nochunks</filename>
+ </phrase>
+ </entry>
+ <entry>
+ <para>��������� <abbrev>HTML</abbrev>
���������������������������������������������������������������<systemitem
class="macro">${DOCBASE}</systemitem><filename>-</filename><systemitem
class="macro">${LANG}</systemitem><filename>.html</filename>������������������������������</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <filename>clean</filename>
+ </phrase>
+ </entry>
+ <entry>
+
<para>���������������������������������������������<emphasis>������</emphasis>
������������ <abbrev>HTML</abbrev>, <abbrev>PDF</abbrev>,
������������������</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <phrase>
+ <filename>distclean</filename>
+ </phrase>
+ </entry>
+ <entry>
+ <para>������������ <abbrev>HTML</abbrev>,
<abbrev>PDF</abbrev>, ������������������������������������
<filename>clean</filename> ���������</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
<para>������������������������������������������������������������������������������
<filename>Makefile</filename> ���������������
<literal>include</literal> ������������������</para>
+
<para>������������������������������������������������������������������������������������������������������������������������������������</para>
+ </section>
+ <section id="ch-getting-files-build-system-images">
+ <title>������������������������</title>
+ <para>���������������������
<filename>.PNG</filename>���������������������������������������������������������������������������������������������������������������������������������
<filename>figs/</filename> ������������������������������������
<filename>picture.png</filename> ���������
<filename>mydoc/figs/picture.png</filename> ���������</para>
+ <note>
+ <title>������ PNG ������������������ JPG</title>
+
<para>���������������������������������������������������������������������������������������������������������������������
<wordasword>PNG</wordasword> ���������������
<wordasword>JPG</wordasword> ���������</para>
+ <para>������������ <systemitem
class="filesystem">convert(1)</systemitem> ���������������
<application>ImageMagick</application><abbrev>RPM</abbrev>
������������������������������������ <wordasword>JPG</wordasword>
���������������������</para>
+ </note>
+ <para>���������������������������������
<filename>figs/</filename>
������������������������������������������������������������������������������������������������</para>
+
<para>������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������
<filename>words-en.png</filename> ���
<filename>words-ru.png</filename>
������������������������������������������������������������������������
<filename>picture.png</filename> ���������</para>
+
<para>���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������
<filename>figs/Manifest-</filename><systemitem
class="macro">${LANG}</systemitem>���������������������������������������������������������������������</para>
+ <para>������ <filename>figs/Manifest-</filename><systemitem
class="macro">${LANG}</systemitem> ������������������������ <xref
linkend="ch-getting-files-build-system-manifest"/>���</para>
+ <example id="ch-getting-files-build-system-manifest">
+ <title>������������������(Manifest)</title>
+ <programlisting>
+rm -f figs/Manifest-en
+find figs -print >/tmp/manifest
+mv /tmp/manifest figs/Manifest-en
+vi figs/Manifest-en
+</programlisting>
+ </example>
+ </section>
+ </section>
</chapter>
Index: docs-rh-guidelines-zh_CN.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/docs-rh-guidelines-zh_CN.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- docs-rh-guidelines-zh_CN.xml 9 Dec 2005 15:28:54 -0000 1.1
+++ docs-rh-guidelines-zh_CN.xml 17 Dec 2005 13:28:38 -0000 1.2
@@ -181,7 +181,7 @@
<para>��������������� CVS ������
(������������������)���������������������������������������������������������������������������</para>
<screen>
<computeroutput>
-<!-- $Id$ -->
+<!-- $Id: -->
</computeroutput>
</screen>
</sect1>
Index: docs-xml-tags-zh_CN.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/docs-xml-tags-zh_CN.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- docs-xml-tags-zh_CN.xml 9 Dec 2005 15:28:54 -0000 1.1
+++ docs-xml-tags-zh_CN.xml 17 Dec 2005 13:28:38 -0000 1.2
@@ -119,8 +119,6 @@
<para>������ DocBook ���������������������������������������</para>
<screen>
<computeroutput>
-<!--$Id$ -->
-
<chapter id="ch-sample">
<title>���������</title>
Index: documentation-guide-zh_CN.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/documentation-guide-zh_CN.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- documentation-guide-zh_CN.xml 9 Dec 2005 15:28:54 -0000 1.1
+++ documentation-guide-zh_CN.xml 17 Dec 2005 13:28:38 -0000 1.2
@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!-- *************** Bring in Fedora entities *************** -->
-<!ENTITY % FEDORA-ENTITIES-EN SYSTEM
"../docs-common/common/fedora-entities-en.ent">
+<!ENTITY % FEDORA-ENTITIES-EN SYSTEM
"../docs-common/common/fedora-entities-zh_CN.ent">
%FEDORA-ENTITIES-EN;
-
<!ENTITY VERSION "0.2.6.3">
<!ENTITY BOOKID "documentation-guide-&VERSION; (2005-09-18)">
<!ENTITY INTRODUCTION SYSTEM "docs-intro-zh_CN.xml" >
@@ -14,7 +13,6 @@
<!ENTITY VIM SYSTEM "docs-vim-zh_CN.xml" >
<!ENTITY TAGS SYSTEM "docs-xml-tags-zh_CN.xml" >
<!ENTITY TUTORIAL SYSTEM "docs-tutorial-zh_CN.xml" >
-<!ENTITY CONVERTING SYSTEM "docs-converting-zh_CN.xml" >
<!ENTITY CVS SYSTEM "../docs-common/common/cvs-zh_CN.xml" >
<!ENTITY ACKNOWLEDGMENTS SYSTEM "acknowledgments-zh_CN.xml" >
<!ENTITY STYLE SYSTEM "docs-style-zh_CN.xml" >
@@ -43,4 +41,4 @@
<surname>Moore</surname>
<firstname>Sandra</firstname>
</author>
- </authorgroup> &LEGALNOTICE;</bookinfo> &INTRODUCTION;
&GETTINGFILES; &GUIDELINES; &EMACS; &EMACS-NXML; &VIM; &TAGS;
&TUTORIAL; &STYLE; &CONVERTING; &CVS; &ACKNOWLEDGMENTS; <index
id="generated-index"/></book>
+ </authorgroup> &LEGALNOTICE;</bookinfo> &INTRODUCTION;
&GETTINGFILES; &GUIDELINES; &EMACS; &EMACS-NXML; &VIM; &TAGS;
&TUTORIAL; &STYLE; &CVS; &ACKNOWLEDGMENTS; <index
id="generated-index"/></book>