|
|
| (2 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| = DocBook =
| | #REDIRECT [[DocBook]] |
| | |
| The standard markup language used by the DocsProject. Refer to the Doc<code></code>Book home page for everything Doc<code></code>Book:
| |
| | |
| * http://www.docbook.org
| |
| | |
| {{Anchor|tutorial}}
| |
| == Example Tutorial ==
| |
| | |
| The DocsProject maintains an [http://cvs.fedoraproject.org/viewcvs/example-tutorial/en_US/example-tutorial2.xml?root=docs&view=markup example tutorial] that shows beginners how to get started using Doc<code></code>Book, using a simple "show and tell" format. After you click the above link to [http://cvs.fedoraproject.org/viewcvs/example-tutorial/en_US/example-tutorial2.xml?root=docs&view=markup the tutorial] , choose "(As text)" at the top, and save the resulting page. Then open the page in your favorite editor. Most editors, such as <code>vi</code>, <code>Emacs</code>, and <code>gEdit</code>, will use "syntax highlighting" to make the document very easy to read.
| |
| | |
| {{Anchor|tdg}}
| |
| == Complete Reference ==
| |
| | |
| "Doc<code></code>Book: The Definitive Guide" (often called "The Doc<code></code>Book Book" or "TDG"), available at the site, has a complete reference of all tags used in Doc<code></code>Book. The Docs<code></code>Project currently uses version 4.4 of the Doc<code></code>Book DTD. The reference in TDG shows you which tags belong to newer versions of the Doc<code></code>Book DTD, so you don't violate the specification when you are writing your documents. You can download or read the book here:
| |
| | |
| * http://www.docbook.org/tdg/en/html/docbook.html
| |
| | |
| {{Anchor|tools}}
| |
| == Creating DocBook Using Common Tools ==
| |
| | |
| The [http://docs.fedoraproject.org/documentation-guide/ Documentation Guide] explains how to configure <code>vi</code> and <code>Emacs</code> for Doc<code></code>Book support.
| |
| | |
| Open<code></code>Office.org has some limited capabilities for producing DocBook XML from documents that adhere to strict use of built-in styles. See ["DocsProject/OOoDocBook"] for information on using [http://www.openoffice.org OpenOffice.org] Writer for working with Doc<code></code>Book.
| |
| | |
| Users can export pages from this wiki to Doc<code></code>Book. To ease the conversion process, refer to the guidelines found at [[Docs/WritingUsingTheWiki]] .
| |
| | |
| ----
| |
| [[Category:DocsProject]]
| |
