#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 245
+\lyxformat 252
\begin_document
\begin_header
\textclass docbook
\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
\paperpagestyle default
\tracking_changes false
\output_changes true
+\author "Jose' Matos"
\end_header
\begin_body
-\begin_layout Standard
-\begin_inset ERT
-status inlined
-
-\begin_layout Standard
-
-
-
-\begin_inset Note Note
-status collapsed
-
-\begin_layout Standard
-
-Here goes the information about the article:
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-
-* title
-\end_layout
-
-\begin_layout Standard
-
-* date
-\end_layout
-
-\begin_layout Standard
-
-* author
-\end_layout
-
-\begin_layout Standard
-
-+ first name
-\end_layout
-
-\begin_layout Standard
-
-+ last name
-\end_layout
-
-\begin_layout Standard
-
-* abstract
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
\begin_layout Title
-
Docbook with LyX
\end_layout
\begin_layout Date
-
24 September 1999
\end_layout
\begin_layout Author
-
-
\begin_inset CharStyle Firstname
+show_label true
status inlined
\begin_layout Standard
-
-José
+José
\end_layout
\end_inset
\begin_inset CharStyle Surname
+show_label true
status inlined
\begin_layout Standard
-
Matos
\end_layout
\end_layout
\begin_layout Abstract
-
This is a small illustration of lyx's features using DocBook.
\end_layout
\begin_layout Abstract
-
The abstract can span several paragraphs.
\end_layout
\begin_layout Section
-
-
-\begin_inset LatexCommand \label{first-section}
+\begin_inset LatexCommand label
+name "first-section"
\end_inset
\end_layout
\begin_layout Standard
-
This file ilustrates the generation of docbook documents with LyX.
\end_layout
\begin_layout Standard
-
This will improve as soon as new features are available.
\end_layout
\begin_layout Section
-
Standard layouts
\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.
\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_layout
\begin_layout Subsection
-
Lists
\end_layout
\begin_layout Standard
-
This is an example with several nested lists.
\end_layout
\begin_layout Itemize
-
item 1
\end_layout
\begin_deeper
\begin_layout Enumerate
-
item 2
\end_layout
\begin_layout Description
-
new item
\end_layout
\begin_deeper
\begin_layout Enumerate
-
collection
\end_layout
\end_deeper
\end_deeper
\begin_layout Itemize
-
new set
\end_layout
\begin_layout Subsection
-
Code
\end_layout
\begin_layout Standard
-
Required steps to have a running lyx.
\end_layout
\begin_layout Quotation
-
Be carefull with your own code.
\end_layout
\begin_layout Quotation
-
The debugger.
\end_layout
\begin_layout Code
-
cat > env.out
\end_layout
\begin_layout Code
-
tar xvzf lyx.tgz
\end_layout
\begin_layout Code
-
cd lyx-1_0_x
\end_layout
\begin_layout Code
-
./configure
\end_layout
\begin_layout Code
-
make
\end_layout
\begin_layout Code
-
make install
\end_layout
\begin_layout Subsection
-
Labels
\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 LatexCommand ref
+name "first-section"
+reference "first-section"
\end_inset
\end_layout
\begin_layout Subsection
-
Fonts
\end_layout
\begin_layout Standard
-
The only fonts supported are
\emph on
Emphasis
\emph default
and
\begin_inset CharStyle Literal
+show_label true
status inlined
\begin_layout Standard
-
SGML
\end_layout
\end_layout
\begin_layout Subsection
-
Figures
\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.
\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,
\end_layout
\begin_layout Standard
-
-
\begin_inset Float figure
placement htbp
wide false
status open
\begin_layout Standard
-
-
\begin_inset Graphics
filename ../doc/platypus.eps
display grayscale
\end_layout
\begin_layout Caption
-
Nice platypus
\end_layout
\end_layout
\begin_layout Standard
-
Wide figures are treated as normal figures.
\end_layout
\begin_layout Standard
-
-
\begin_inset Float figure
placement htbp
wide true
status open
\begin_layout Standard
-
-
\begin_inset Graphics
filename ../doc/platypus.eps
display grayscale
\end_layout
\begin_layout Caption
-
long, very long...
:-)
\end_layout
\end_layout
\begin_layout Subsection
-
Tables
\end_layout
\begin_layout Standard
-
There is also basic support for tables.
\begin_inset Float table
placement htbp
\begin_layout Standard
\align center
-
\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="5">
<features>
\begin_inset Text
\begin_layout Standard
-
Software 1
\end_layout
\begin_inset Text
\begin_layout Standard
-
Software 2
\end_layout
\begin_inset Text
\begin_layout Standard
-
Software 3
\end_layout
\begin_inset Text
\begin_layout Standard
-
Software 4
\end_layout
\begin_inset Text
\begin_layout Standard
-
Plataform 1
\end_layout
\begin_inset Text
\begin_layout Standard
-
25 MB
\end_layout
\begin_inset Text
\begin_layout Standard
-
10 MB
\end_layout
\begin_inset Text
\begin_layout Standard
-
34 MB
\end_layout
\begin_inset Text
\begin_layout Standard
-
Plataform 2
\end_layout
\begin_inset Text
\begin_layout Standard
-
12 MB
\end_layout
\begin_inset Text
\begin_layout Standard
-
30 MB
\end_layout
\begin_inset Text
\begin_layout Standard
-
35 MB
\end_layout
\end_layout
\begin_layout Caption
-
Nice Formal Table
\end_layout
\end_layout
\begin_layout Standard
-
As it happens with the figures the wide tables are treated as normal tables.
\end_layout
\begin_layout Subsection
-
Margins
\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 LatexCommand url
+name "docbook reference manual"
+target "http://www.oasis-open.org/docbook/documentation/reference/"
\end_inset
\end_layout
\begin_layout Quotation
-
It is also possible to insert margin notes inside some environments.
\end_layout
\begin_layout Standard
-
-
\begin_inset Marginal
status collapsed
\begin_layout Standard
-
margin note
\end_layout
\end_deeper
\begin_layout Quotation
-
Notice that the previous layout is at level 1
\begin_inset Foot
status collapsed
\begin_layout Standard
-
This comes from a docbook restriction.
Sidebar can only appear inside "MSGTEXT", "CAUTION", "IMPORTANT", "NOTE",
"TIP", "WARNING", "BLOCKQUOTE".
\end_layout
\begin_layout Standard
-
These environments are easily added to the docbook layout.
\end_layout
\begin_layout Standard
-
-
\begin_inset Marginal
status collapsed
\begin_layout Standard
-
too marginal ;-)
\end_layout
\end_deeper
\begin_layout Section
-
The road map
\end_layout
\begin_layout Standard
-
This is a small list of the remaining tasks:
\end_layout
\begin_layout Itemize
-
Expand the number of layouts
\end_layout
\begin_deeper
\begin_layout Itemize
-
example
\end_layout
\begin_layout Itemize
-
note
\end_layout
\begin_layout Itemize
-
warning
\end_layout
\begin_layout Itemize
-
tip
\end_layout
\begin_layout Itemize
-
caution
\end_layout
\begin_layout Itemize
-
important
\end_layout
\end_deeper
\begin_layout Itemize
-
Compose other layout files, besides article
\end_layout
\begin_deeper
\begin_layout Enumerate
-
book
\end_layout
\begin_layout Enumerate
-
set (very unlikely)
\begin_inset Foot
status collapsed
\begin_layout Standard
-
I do not expect lyx to deal with colection of books, for now!
\end_layout
\end_layout
\begin_layout Enumerate
-
refentry
\end_layout
\end_deeper
\begin_layout Itemize
-
goodies
\end_layout
\begin_deeper
\begin_layout Enumerate
-
including other lyx files
\end_layout
\begin_layout Enumerate
-
more advanced tables support
\end_layout
\end_deeper
\begin_layout Itemize
-
better documentation
\end_layout
\begin_layout Standard
-
That's all.
;-)
\end_layout