个人工具

“UbuntuHelp:DocBookReference”的版本间的差异

来自Ubuntu中文

跳转至: 导航, 搜索
(新页面: {{From|https://help.ubuntu.com/community/DocBookReference}} {{Languages|UbuntuHelp:DocBookReference}} This reference is incomplete. Just use it to find out how to enter certain contents i...)
 
第4行: 第4行:
 
certain contents into your document. See http://www.docbook.org/tdg/en/html/
 
certain contents into your document. See http://www.docbook.org/tdg/en/html/
 
for the real fun. :)
 
for the real fun. :)
 
 
For an introduction on how to write DocBook/XML documents please see the
 
For an introduction on how to write DocBook/XML documents please see the
 
DocBook Wiki entry.
 
DocBook Wiki entry.
 
 
=== General article layout ===
 
=== General article layout ===
 
 
<pre><nowiki>
 
<pre><nowiki>
 
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://docbook.org/xml/4.2/docbookx.dtd">
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://docbook.org/xml/4.2/docbookx.dtd">
第17行: 第13行:
 
<title>The Magic of Dragons</title>
 
<title>The Magic of Dragons</title>
 
<articleinfo>
 
<articleinfo>
 
 
<author>
 
<author>
 
<honorific>Dr. H.C</honorific>
 
<honorific>Dr. H.C</honorific>
第23行: 第18行:
 
<surname>Fischbecker</surname>
 
<surname>Fischbecker</surname>
 
</author>
 
</author>
 
 
<copyright>
 
<copyright>
 
<year>2004</year>
 
<year>2004</year>
 
<holder>The Ubuntu Dragons Subproject</holder>
 
<holder>The Ubuntu Dragons Subproject</holder>
 
</copyright>
 
</copyright>
 
 
<keywordset>
 
<keywordset>
 
<keyword>magic</keyword>
 
<keyword>magic</keyword>
 
<keyword>dragons</keyword>
 
<keyword>dragons</keyword>
 
</keywordset>
 
</keywordset>
 
 
<abstract>
 
<abstract>
 
<para>
 
<para>
第39行: 第31行:
 
</para>
 
</para>
 
</abstract>
 
</abstract>
 
 
</articleinfo>
 
</articleinfo>
 
 
<sect1>
 
<sect1>
 
 
<title>History of Magic</title>
 
<title>History of Magic</title>
 
<para>
 
<para>
 
In the middle ages there were two kinds of magic:
 
In the middle ages there were two kinds of magic:
 
</para>
 
</para>
 
 
<itemizedlist>
 
<itemizedlist>
 
<listitem>
 
<listitem>
第57行: 第45行:
 
</listitem>
 
</listitem>
 
</itemizedlist>
 
</itemizedlist>
 
 
<para>
 
<para>
 
A picture of the flow of mana:
 
A picture of the flow of mana:
第66行: 第53行:
 
</mediaobject>
 
</mediaobject>
 
</para>
 
</para>
 
 
<sect2>
 
<sect2>
 
<title>Evil magic</title>
 
<title>Evil magic</title>
第79行: 第65行:
 
</article>
 
</article>
 
</nowiki></pre>
 
</nowiki></pre>
 
 
=== Sections that can be used in the <articleinfo> ===
 
=== Sections that can be used in the <articleinfo> ===
 
 
Please see http://www.docbook.org/tdg/en/html/articleinfo.html
 
Please see http://www.docbook.org/tdg/en/html/articleinfo.html
 
 
=== Including images ===
 
=== Including images ===
 
<pre><nowiki>
 
<pre><nowiki>
 
 
<mediaobject>
 
<mediaobject>
 
<imageobject>
 
<imageobject>
第93行: 第75行:
 
</mediaobject>
 
</mediaobject>
 
</nowiki></pre>
 
</nowiki></pre>
 
 
=== Terminal input/output ===
 
=== Terminal input/output ===
 
<pre><nowiki>
 
<pre><nowiki>
 
 
<screen>
 
<screen>
 
user = service
 
user = service
第102行: 第82行:
 
</screen>
 
</screen>
 
</nowiki></pre>
 
</nowiki></pre>
 
 
=== Lists ===
 
=== Lists ===
 
<pre><nowiki>
 
<pre><nowiki>
第115行: 第94行:
 
</nowiki></pre>
 
</nowiki></pre>
 
=== References ===
 
=== References ===
 
 
If you need to refer to a section in your document place an anchor like this:
 
If you need to refer to a section in your document place an anchor like this:
 
<pre><nowiki>
 
<pre><nowiki>
第125行: 第103行:
 
</nowiki></pre>
 
</nowiki></pre>
 
Which will render to:
 
Which will render to:
 
 
'See 'installing the needed packages' for more information.'
 
'See 'installing the needed packages' for more information.'
 
 
 
=== Tables ===
 
=== Tables ===
 
 
<pre><nowiki>
 
<pre><nowiki>
 
 
<informaltable frame="none">
 
<informaltable frame="none">
 
<tgroup cols="2">
 
<tgroup cols="2">
第163行: 第136行:
 
</nowiki></pre>
 
</nowiki></pre>
 
=== Notes / Warnings ===
 
=== Notes / Warnings ===
 
 
<pre><nowiki>
 
<pre><nowiki>
 
 
<caution>...</caution>
 
<caution>...</caution>
 
<note>...</note>
 
<note>...</note>
第185行: 第156行:
 
=== Hyperlinks ===
 
=== Hyperlinks ===
 
<pre><nowiki>
 
<pre><nowiki>
 
 
<ulink url="http://workaround.org>workaround.org</ulink>
 
<ulink url="http://workaround.org>workaround.org</ulink>
 
</nowiki></pre>
 
</nowiki></pre>
 
 
'Christoph Haas'
 
'Christoph Haas'
 
 
[[category:CategoryDocumentation]] [[category:CategoryDocteam]] [[category:CategoryCleanup]]
 
[[category:CategoryDocumentation]] [[category:CategoryDocteam]] [[category:CategoryCleanup]]
  
 
[[category:UbuntuHelp]]
 
[[category:UbuntuHelp]]

2007年11月30日 (五) 16:49的版本

This reference is incomplete. Just use it to find out how to enter certain contents into your document. See http://www.docbook.org/tdg/en/html/ for the real fun. :) For an introduction on how to write DocBook/XML documents please see the DocBook Wiki entry.

General article layout

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://docbook.org/xml/4.2/docbookx.dtd">
<article>
<title>The Magic of Dragons</title>
<articleinfo>
<author>
<honorific>Dr. H.C</honorific>
<firstname>Joseph</firstname>
<surname>Fischbecker</surname>
</author>
<copyright>
<year>2004</year>
<holder>The Ubuntu Dragons Subproject</holder>
</copyright>
<keywordset>
<keyword>magic</keyword>
<keyword>dragons</keyword>
</keywordset>
<abstract>
<para>
This document deals with the magic of dragons.
</para>
</abstract>
</articleinfo>
<sect1>
<title>History of Magic</title>
<para>
In the middle ages there were two kinds of magic:
</para>
<itemizedlist>
<listitem>
Bad magic: mostly used by evil wizards
</listitem>
<listitem>
Good magic: mostly used by good wizards
</listitem>
</itemizedlist>
<para>
A picture of the flow of mana:
<mediaobject>
<imageobject>
<imagedata fileref="bigpicture.png" format="PNG"/>
</imageobject>
</mediaobject>
</para>
<sect2>
<title>Evil magic</title>
<para>
In this subsection you will learn about evil magic.
</para>
<important>
Be very careful. Evil magic is hard to handle!
</important>
</sect2>
</sect1>
</article>

Sections that can be used in the <articleinfo>

Please see http://www.docbook.org/tdg/en/html/articleinfo.html

Including images

<mediaobject>
<imageobject>
<imagedata fileref="bigpicture.png" format="PNG"/>
</imageobject>
</mediaobject>

Terminal input/output

<screen>
user = service
password = DomAKg07
</screen>

Lists

<itemizedlist>
<listitem>
Bad magic: mostly used by evil wizards
</listitem>
<listitem>
Good magic: mostly used by good wizards
</listitem>
</itemizedlist>

References

If you need to refer to a section in your document place an anchor like this:

<sect1 id="install_packages" xreflabel="installing the needed packages">

Later you can refer to that section using:

See <xref linkend="install_packages"/> for more information.

Which will render to: 'See 'installing the needed packages' for more information.'

Tables

<informaltable frame="none">
<tgroup cols="2">
<thead>
<row>
<entry>Setting</entry>
<entry>Meaning</entry>
</row>
</thead>
<tbody>
<row>
<entry>
$mydomain = 'yourdomain.org';
</entry>
<entry>
Configure this string to your default domain.
</entry>
</row>
<row>
<entry>
@bypass_virus_checks_acl = qw( . );
</entry>
<entry>
If this line is commented out virus checks are enabled.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>

Notes / Warnings

<caution>...</caution>
<note>...</note>
<tip>...</tip>
<warning>...</warning>
<important>...</important>

Use them like:

<warning>
<title>
Careful
</title>
<para>
Dragons may have a bad breath even resulting in bursts of fire.
</para>
</warning>

Hyperlinks

<ulink url="http://workaround.org>workaround.org</ulink>

'Christoph Haas'