]> In this manual we will make extensive use of &entities;, to insert the contents of smaller independent files. This should help translators; any changes will be easier to find within the files. We will try to keep the files small, feel free to create new ones for new subjects or subtopics. This example document contains some of the most useful types of xml markup for our purposes. Some quick rules: All tags must be in lower case Every tag must have a closing tag also No abbreviations in the tags and preferences: Keep starting tags to the left margin as much as possible Keep tag pairs intact on one line if it's reasonable to do so The right margin will not be even, it doesn't matter Use 1-space indentation, but don't sweat it Try to leave a blank line between paragraph tags and the words in the paragraph (this makes word wrapping much easier) I use the docbookide xemacs mode to edit: apt-get install docbookide or apt-get install docbookide It displays syntax coloring and closes your tags if you are at the end of a line. Here is an internal cross reference: and here is an external link to the main Debian website. Many times we will put common urls in an entity document and use something like a link to Debian Website instead of using url directly. If you need to specify text that is only present for a certain condition or a given architecture, use attributes arch and condition. For example, A paragraph only interesting for Linux/i386 or Linux/amd64 users. A paragraph only interesting for Linux/i386 users. A paragraph only interesting for Linux users. A paragraph only interesting for amd64 users, whatever the kernel. A paragraph only interesting for users of Linux on any arm-based platform, encompassing armel, armhf and arm64. A paragraph only interesting for Linux/armel users. A paragraph only interesting for Linux/armhf users. A paragraph only interesting for Linux/arm64 users. A section pertaining only to computers which can boot from their hard disk. Linux PowerPC-only text within a para the command prompt text text to be replaced by user, debiandoc var that's self explanatory! abiword /install/basedebs.tar /dev/hda1 You can exit from GNU Emacs with C-xC-c Files Exit Emacs . Ctrl Alt F1 selects console 1. 1st term to be defined A paragraph definition of the term. 2nd term to be defined A paragraph definition of the 2nd term. making things easier on yourself something of interest pay attention now watch out here this is really critical to success 1st row, 1st column 1st row, 2nd column 2nd row, 1st column 2nd row, 2nd column 1st row, 1st column 1st row, 2nd column 2nd row, 1st column 2nd row, 2nd column

some glossary entry Some appropriate glossary definition goes here.