#LyX 1.4.4svn 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 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 \begin_inset Text \begin_layout Standard \end_layout \end_inset \begin_inset Text \begin_layout Standard Software 1 \end_layout \end_inset \begin_inset Text \begin_layout Standard Software 2 \end_layout \end_inset \begin_inset Text \begin_layout Standard Software 3 \end_layout \end_inset \begin_inset Text \begin_layout Standard Software 4 \end_layout \end_inset \begin_inset Text \begin_layout Standard Plataform 1 \end_layout \end_inset \begin_inset Text \begin_layout Standard 25 MB \end_layout \end_inset \begin_inset Text \begin_layout Standard 10 MB \end_layout \end_inset \begin_inset Text \begin_layout Standard 34 MB \end_layout \end_inset \begin_inset Text \begin_layout Standard \end_layout \end_inset \begin_inset Text \begin_layout Standard Plataform 2 \end_layout \end_inset \begin_inset Text \begin_layout Standard \end_layout \end_inset \begin_inset Text \begin_layout Standard 12 MB \end_layout \end_inset \begin_inset Text \begin_layout Standard 30 MB \end_layout \end_inset \begin_inset Text \begin_layout Standard 35 MB \end_layout \end_inset \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