#LyX 1.4.1 created this file. For more info see http://www.lyx.org/
\lyxformat 245
\begin_document
\begin_header
\textclass docbook
\language english
\inputencoding default
\fontscheme default
\graphics default
\paperfontsize default
\spacing single
\papersize default
\use_geometry false
\use_amsmath 0
\cite_engine basic
\use_bibtopic false
\paperorientation portrait
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
\defskip medskip
\quotes_language english
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes true
\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
status inlined

\begin_layout Standard

José
\end_layout

\end_inset


\begin_inset CharStyle Surname
status inlined

\begin_layout Standard

Matos
\end_layout

\end_inset


\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}

\end_inset

Introduction
\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_inset

bad
\begin_inset Quotes erd
\end_inset

.
\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}

\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
status inlined

\begin_layout Standard

SGML
\end_layout

\end_inset

.
\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.
 So you should have one of these if you want to take advantage of this feature.
\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.
\end_layout

\begin_layout Standard


\begin_inset Float figure
placement htbp
wide false
sideways false
status open

\begin_layout Standard


\begin_inset Graphics
	filename ../doc/platypus.eps
	display grayscale
	width 2cm
	height 3cm
	rotateAngle 45
	rotateOrigin center

\end_inset


\end_layout

\begin_layout Caption

Nice platypus
\end_layout

\end_inset

 
\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
sideways false
status open

\begin_layout Standard


\begin_inset Graphics
	filename ../doc/platypus.eps
	display grayscale
	width 2cm
	height 3cm
	rotateAngle 45
	rotateOrigin center

\end_inset


\end_layout

\begin_layout Caption

long, very long...
 :-)
\end_layout

\end_inset


\end_layout

\begin_layout Subsection

Tables
\end_layout

\begin_layout Standard

There is also basic support for tables.
\begin_inset Float table
placement htbp
wide false
sideways false
status open

\begin_layout Standard
\align center

\begin_inset Tabular
<lyxtabular version="3" rows="3" columns="5">
<features>
<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="center" valignment="top" leftline="true" rightline="true" width="0pt">
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

Software 1
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

Software 2
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

Software 3
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

Software 4
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

Plataform 1
\end_layout

\end_inset
</cell>
<cell multicolumn="1" alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

25 MB
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

10 MB
\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 Standard

34 MB
\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 Standard

\end_layout

\end_inset
</cell>
</row>
<row topline="true" bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

Plataform 2
\end_layout

\end_inset
</cell>
<cell multicolumn="1" alignment="center" valignment="top" bottomline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

12 MB
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

30 MB
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

35 MB
\end_layout

\end_inset
</cell>
</row>
</lyxtabular>

\end_inset


\end_layout

\begin_layout Caption

Nice Formal Table
\end_layout

\end_inset

 
\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/}

\end_inset

.
\end_layout

\begin_layout Quotation

It is also possible to insert margin notes inside some environments.
\end_layout

\begin_deeper
\begin_layout Standard
\begin_inset ERT
status inlined

\begin_layout Standard



\begin_inset Marginal
status collapsed

\begin_layout Standard

margin note
\end_layout

\end_inset


\end_layout

\begin_layout Standard

second par -> margin note
\end_layout

\begin_layout Standard

third par -> margin note
\end_layout

\end_inset

 
\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

\end_inset

 and so is the follow:
\end_layout

\begin_deeper
\begin_layout Standard
\begin_inset ERT
status inlined

\begin_layout Standard



\begin_inset Marginal
status collapsed

\begin_layout Standard

too marginal ;-)
\end_layout

\end_inset


\end_layout

\end_inset

 
\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_inset


\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

\end_body
\end_document
