-#This file was created by <jamatos> Wed Sep 29 16:07:48 1999
-#LyX 1.0 (C) 1995-1999 Matthias Ettrich and the LyX Team
-\lyxformat 2.15
+#LyX 1.6.0 created this file. For more info see http://www.lyx.org/
+\lyxformat 345
+\begin_document
+\begin_header
\textclass docbook
-\language default
+\use_default_options false
+\language english
\inputencoding default
-\fontscheme default
+\font_roman default
+\font_sans default
+\font_typewriter default
+\font_default_family default
+\font_sc false
+\font_osf false
+\font_sf_scale 100
+\font_tt_scale 100
\graphics default
\paperfontsize default
-\spacing single
-\papersize Default
-\paperpackage a4
-\use_geometry 0
+\spacing single
+\use_hyperref false
+\papersize default
+\use_geometry false
\use_amsmath 0
+\use_esint 0
+\cite_engine basic
+\use_bibtopic false
\paperorientation portrait
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
\defskip medskip
\quotes_language english
-\quotes_times 2
\papercolumns 1
\papersides 1
\paperpagestyle default
+\tracking_changes false
+\output_changes false
+\author ""
+\author ""
+\end_header
-\layout SGML
+\begin_body
-
-\begin_inset Info Here goes the information about the article:
- * title
- * date
- * author
- + first name
- + last name
- * abstract
-\end_inset
-
-
-\layout Title
-\added_space_top vfill \added_space_bottom vfill
+\begin_layout Title
Docbook with LyX
-\layout Date
+\end_layout
+\begin_layout Date
24 September 1999
-\layout Author
+\end_layout
-\begin_deeper
-\layout SGML
-\align center
+\begin_layout Author
+\begin_inset Flex Element:Firstname
+status open
-\size normal
+\begin_layout Plain Layout
+José
+\end_layout
-\begin_inset Info The author name is always composed of:
- * first name
- * surname
+\end_inset
-It is always possible to have more than one author.
-\end_inset
+\begin_inset Flex Element:Surname
+status open
-\layout FirstName
+\begin_layout Plain Layout
+Matos
+\end_layout
+\end_inset
-\latex no_latex
-Jos
-\latex default
-e'
-\layout Surname
+\end_layout
-\latex no_latex
-Matos
-\end_deeper
-\layout Abstract
-
+\begin_layout Abstract
This is a small illustration of lyx's features using DocBook.
-\layout Abstract
+\end_layout
+\begin_layout Abstract
The abstract can span several paragraphs.
-\layout Section
-
+\end_layout
-\begin_inset LatexCommand \label{first-section}
+\begin_layout Section
+\begin_inset CommandInset label
+LatexCommand label
+name "first-section"
-\end_inset
+\end_inset
Introduction
-\layout Standard
+\end_layout
+\begin_layout Standard
This file ilustrates the generation of docbook documents with LyX.
-\layout Standard
+\end_layout
+\begin_layout Standard
This will improve as soon as new features are available.
-\layout Section
+\end_layout
+\begin_layout Section
Standard layouts
-\layout Standard
+\end_layout
+\begin_layout Standard
One of the goals is the support, as much as possible, of layouts used in
other textclass, for compatibility purposes.
-\layout Standard
+\end_layout
+\begin_layout Standard
Remember that this is work in progress, I would like to hear any comments,
good or
\begin_inset Quotes eld
-\end_inset
+\end_inset
bad
\begin_inset Quotes erd
-\end_inset
+\end_inset
.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Lists
-\layout Standard
+\end_layout
+\begin_layout Standard
This is an example with several nested lists.
-\layout Itemize
+\end_layout
+\begin_layout Itemize
item 1
-\begin_deeper
-\layout Enumerate
+\end_layout
+\begin_deeper
+\begin_layout Enumerate
item 2
-\layout Description
+\end_layout
+\begin_layout Description
new item
-\begin_deeper
-\layout Enumerate
+\end_layout
+\begin_deeper
+\begin_layout Enumerate
collection
-\end_deeper
-\end_deeper
-\layout Itemize
+\end_layout
+\end_deeper
+\end_deeper
+\begin_layout Itemize
new set
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Code
-\layout Standard
+\end_layout
+\begin_layout Standard
Required steps to have a running lyx.
-\layout Quotation
+\end_layout
+\begin_layout Quotation
Be carefull with your own code.
-\layout Quotation
+\end_layout
+\begin_layout Quotation
The debugger.
-\layout Code
+\end_layout
+\begin_layout Code
cat > env.out
-\layout Code
+\end_layout
+\begin_layout Code
tar xvzf lyx.tgz
-\layout Code
+\end_layout
+\begin_layout Code
cd lyx-1_0_x
-\layout Code
+\end_layout
+\begin_layout Code
./configure
-\layout Code
+\end_layout
+\begin_layout Code
make
-\layout Code
+\end_layout
+\begin_layout Code
make install
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Labels
-\layout Standard
+\end_layout
+\begin_layout Standard
If a label is the first element in any layout, that label will be merged
with that element.
See as an example
-\begin_inset LatexCommand \ref[first-section]{first-section}
+\begin_inset CommandInset ref
+LatexCommand ref
+name "first-section"
+reference "first-section"
-\end_inset
+\end_inset
.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Fonts
-\layout Standard
+\end_layout
+\begin_layout Standard
The only fonts supported are
-\emph on
+\emph on
Emphasis
-\emph default
+\emph default
and
-\latex latex
-<literal>SGML</literal>
-\latex default
+\begin_inset Flex Element:Literal
+status open
+
+\begin_layout Plain Layout
+SGML
+\end_layout
+
+\end_inset
+
.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Figures
-\layout Standard
+\end_layout
+\begin_layout Standard
One of the major changes in the docbook when compared with the linuxdoc
support are the figures support.
LyX only allows to view eps figures.
So you should have one of these if you want to take advantage of this feature.
-\layout Standard
+\end_layout
+\begin_layout Standard
Notice that when the docbook code is exported the filename extension is
stripped.
This enables that when the several backends are processed in sgmltools,
the corresponding extensions are added.
The default extension are eps for the print and gif for the html backend.
-\layout Standard
+\end_layout
-\begin_float fig
-\layout Standard
+\begin_layout Standard
+\begin_inset Float figure
+placement htbp
+wide false
+sideways false
+status open
+\begin_layout Plain Layout
+\begin_inset Graphics
+ filename ../doc/clipart/platypus.eps
+ width 2cm
+ height 3cm
+ scaleBeforeRotation
+ rotateAngle 45
+ rotateOrigin center
-\begin_inset Figure size 56 85
-file ../doc/platypus.eps
-width 1 2
-height 1 3
-angle 45
-flags 2
+\end_inset
-\end_inset
+\end_layout
-\layout Caption
+\begin_layout Plain Layout
+\begin_inset Caption
+\begin_layout Plain Layout
Nice platypus
-\end_float
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
-\layout Standard
+\end_layout
+\begin_layout Standard
Wide figures are treated as normal figures.
-\layout Standard
+\end_layout
-\begin_float wide-fig
-\layout Standard
+\begin_layout Standard
+\begin_inset Float figure
+placement htbp
+wide true
+sideways false
+status open
+\begin_layout Plain Layout
+\begin_inset Graphics
+ filename ../doc/clipart/platypus.eps
+ width 2cm
+ height 3cm
+ scaleBeforeRotation
+ rotateAngle 45
+ rotateOrigin center
-\begin_inset Figure size 56 85
-file ../doc/platypus.eps
-width 1 2
-height 1 3
-angle 45
-flags 2
+\end_inset
-\end_inset
+\end_layout
-\layout Caption
+\begin_layout Plain Layout
+\begin_inset Caption
-long, very long...
+\begin_layout Plain Layout
+long, very long\SpecialChar \ldots{}
:-)
-\end_float
-\layout Subsection
+\end_layout
+
+\end_inset
+
+
+\end_layout
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
Tables
-\layout Standard
+\end_layout
+\begin_layout Standard
There is also basic support for tables.
-\begin_float tab
-\layout Standard
-\added_space_top 0.3cm \added_space_bottom 0.3cm \align center \LyXTable
-multicol5
-3 5 0 0 -1 -1 -1 -1
-1 0 0 0
-1 0 0 0
-1 1 0 0
-8 1 0 "" ""
-8 1 0 "" ""
-8 1 0 "" ""
-8 1 0 "" ""
-8 1 1 "" ""
-0 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-1 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-1 8 1 0 0 0 0 "" ""
-2 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-1 8 0 1 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-0 8 1 0 0 0 0 "" ""
-
-
-\newline
+\begin_inset Float table
+placement htbp
+wide false
+sideways false
+status open
+
+\begin_layout Plain Layout
+\align center
+\begin_inset Tabular
+<lyxtabular version="3" rows="3" columns="5">
+<features>
+<column alignment="center" valignment="top" width="0pt">
+<column alignment="center" valignment="top" width="0pt">
+<column alignment="center" valignment="top" width="0pt">
+<column alignment="center" valignment="top" width="0pt">
+<column alignment="center" valignment="top" width="0pt">
+<row>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
Software 1
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
Software 2
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
Software 3
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
Software 4
-\newline
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
Plataform 1
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell multicolumn="1" alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
25 MB
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
10 MB
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell multicolumn="1" alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
34 MB
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell multicolumn="2" alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row>
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
Plataform 2
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell multicolumn="1" alignment="center" valignment="top" bottomline="true" leftline="true" usebox="none">
+\begin_inset Text
-\newline
+\begin_layout Plain Layout
+
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
12 MB
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
30 MB
-\newline
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
35 MB
-\layout Caption
+\end_layout
+
+\end_inset
+</cell>
+</row>
+</lyxtabular>
+
+\end_inset
+
+\end_layout
+
+\begin_layout Plain Layout
+\begin_inset Caption
+
+\begin_layout Plain Layout
Nice Formal Table
-\end_float
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
-\layout Standard
+\end_layout
+\begin_layout Standard
As it happens with the figures the wide tables are treated as normal tables.
-\layout Subsection
+\end_layout
+\begin_layout Subsection
Margins
-\layout Standard
+\end_layout
+\begin_layout Standard
There are some restrictions when using margins.
For further information on docbook allowed syntax consult the
-\begin_inset LatexCommand \url[docbook reference manual]{http://www.oasis-open.org/docbook/documentation/reference/}
+\begin_inset CommandInset href
+LatexCommand href
+name "docbook reference manual"
+target "http://www.oasis-open.org/docbook/documentation/reference/"
-\end_inset
+\end_inset
.
-\layout Quotation
+\end_layout
+\begin_layout Quotation
It is also possible to insert margin notes inside some environments.
-\begin_deeper
-\layout SGML
+\end_layout
+
+\begin_deeper
+\begin_layout Standard
+\begin_inset ERT
+status collapsed
-\begin_float margin
-\end_deeper
-\layout Standard
+\begin_layout Plain Layout
-margin note
-\layout Standard
+\end_layout
+
+\begin_layout Plain Layout
second par -> margin note
-\layout Standard
+\end_layout
+
+\begin_layout Plain Layout
third par -> margin note
-\end_float
+\end_layout
+
+\end_inset
+
-\layout Quotation
+\end_layout
+\end_deeper
+\begin_layout Quotation
Notice that the previous layout is at level 1
-\begin_float footnote
-\layout Standard
+\begin_inset Foot
+status collapsed
+\begin_layout Plain Layout
This comes from a docbook restriction.
Sidebar can only appear inside "MSGTEXT", "CAUTION", "IMPORTANT", "NOTE",
"TIP", "WARNING", "BLOCKQUOTE".
-\layout Standard
+\end_layout
+\begin_layout Plain Layout
These environments are easily added to the docbook layout.
-\end_float
+\end_layout
+
+\end_inset
+
and so is the follow:
-\begin_deeper
-\layout SGML
+\end_layout
+
+\begin_deeper
+\begin_layout Standard
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\end_layout
-\begin_float margin
-\end_deeper
-\layout Standard
+\end_inset
-too marginal ;-)
-\end_float
-\layout Section
+\end_layout
+\end_deeper
+\begin_layout Section
The road map
-\layout Standard
+\end_layout
+\begin_layout Standard
This is a small list of the remaining tasks:
-\layout Itemize
+\end_layout
+\begin_layout Itemize
Expand the number of layouts
-\begin_deeper
-\layout Itemize
+\end_layout
+\begin_deeper
+\begin_layout Itemize
example
-\layout Itemize
+\end_layout
+\begin_layout Itemize
note
-\layout Itemize
+\end_layout
+\begin_layout Itemize
warning
-\layout Itemize
+\end_layout
+\begin_layout Itemize
tip
-\layout Itemize
+\end_layout
+\begin_layout Itemize
caution
-\layout Itemize
+\end_layout
+\begin_layout Itemize
important
-\end_deeper
-\layout Itemize
+\end_layout
+\end_deeper
+\begin_layout Itemize
Compose other layout files, besides article
-\begin_deeper
-\layout Enumerate
+\end_layout
+\begin_deeper
+\begin_layout Enumerate
book
-\layout Enumerate
+\end_layout
+\begin_layout Enumerate
set (very unlikely)
-\begin_float footnote
-\end_deeper
-\layout Standard
+\begin_inset Foot
+status collapsed
+\begin_layout Plain Layout
I do not expect lyx to deal with colection of books, for now!
-\end_float
-\begin_deeper
-\layout Enumerate
+\end_layout
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
refentry
-\end_deeper
-\layout Itemize
+\end_layout
+\end_deeper
+\begin_layout Itemize
goodies
-\begin_deeper
-\layout Enumerate
+\end_layout
+\begin_deeper
+\begin_layout Enumerate
including other lyx files
-\layout Enumerate
+\end_layout
+\begin_layout Enumerate
more advanced tables support
-\end_deeper
-\layout Itemize
+\end_layout
+\end_deeper
+\begin_layout Itemize
better documentation
-\layout Standard
+\end_layout
+\begin_layout Standard
That's all.
;-)
-\the_end
+\end_layout
+
+\end_body
+\end_document