1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4
<!ENTITY % globalent SYSTEM "../../../libs/global.ent">
6
<!ENTITY % xubuntu-ent SYSTEM "../../../xubuntu/libs/xubuntu.ent">
8
<!ENTITY % cdo-C SYSTEM "../../../libs/cdo-C.ent">
10
<!ENTITY % xinclude SYSTEM "../../../libs/xinclude.mod">
12
<!ENTITY language "en">
13
<!ENTITY ubuntu '<phrase>Ubuntu</phrase>'>
15
<preface id="preface" status="complete">
16
<title>About This Guide</title>
17
<sect1 id="conventions" status="complete">
18
<title>Conventions</title>
20
<emphasis role="bold">The following notes will be used
25
<para>A note presents interesting, sometimes technical, pieces
26
of information related to the surrounding discussion.
30
<para>A tip offers advice or an easier way of doing
35
<para>A caution alerts the reader to potential problems and
38
<!-- Direct referencing in a non-instructional context is bad. -->
41
<para>A warning advises the reader of a hazard that
42
may arise in a given scenario.
46
<emphasis role="bold">Cross-reference conventions for print will
47
be displayed as follows:
52
<para>Links to other documents or websites will look like <ulink url="http://www.ubuntu.com">this</ulink>.
57
<para>PDF, HTML, and XHTML versions of this document will use
58
hyperlinks to handle cross-referencing.
62
<emphasis role="bold">Type conventions will be displayed as
68
<para>File names or paths to directories will be shown in
69
<filename>monospace</filename>.
74
Commands that you type at a <application>Terminal</application>
79
<!-- NOTE: the spaces before </screen> are significant, and will be in the html output. -->
80
<screen>command to type </screen>
84
<para>Options that you click, select, or choose in a user
85
interface will look like <guibutton>this</guibutton>.
90
<emphasis role="bold">Menu selections, mouse actions, and
96
<para>A sequence of menu selections will be displayed as
108
<para>Mouse actions shall assume a right-handed mouse
109
configuration. The terms <quote><mousebutton>click</mousebutton></quote>
110
and <quote><mousebutton>double-click</mousebutton></quote>
111
refer to using the left mouse button. The term <quote><mousebutton>right-click</mousebutton></quote>
112
refers to using the right mouse button. The
113
term <quote><mousebutton>middle-click</mousebutton></quote>
114
refers to using the middle mouse button,
115
pressing down on the scroll wheel, or pressing both the
116
left and right buttons simultaneously, based on the
117
design of your mouse.
121
<para>Keyboard shortcut combinations will be displayed as
123
<keycap>Ctrl</keycap>
126
.Where the conventions for
127
<quote>Control</quote>, <quote>Shift,</quote> and
128
<quote>Alternate</quote> keys will be
129
<keycap>Ctrl</keycap>, <keycap>Shift</keycap>, and
130
<keycap>Alt</keycap>, respectively, and shall mean
131
the first key is to be held down while pressing the
137
<sect1 id="sect-contributing" status="complete">
138
<title>Contributing and Feedback</title>
139
<para>This guide is developed by the <ulink url="&xubuntu-doc-team;">Xubuntu Documentation Team</ulink>. <emphasis>You</emphasis> can contribute to this document by sending ideas or comments to the Ubuntu Documentation Team mailing list. Visit the <ulink url="&xubuntu-doc-team;">Xubuntu Documentation Team Website</ulink> or the <ulink url="&ubuntu-doc-team;">Ubuntu Documentation Team Website</ulink> for further information.
141
<para>If you see a problem with this document, or would like to make a suggestion, you can simply file a bug report at the <ulink url="&xubuntu-doc-bugs;">Bugtracker for the Xubuntu Documentation</ulink>. Your help is vital to the success of our documentation!</para>
142
<para>Many thanks,</para>
143
<para>-Your X/Ubuntu Documentation Team</para>