mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-12-13 09:15:50 +00:00
d92a1667b2
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/branches/BRANCH_1_4_X@17962 a592a061-630c-0410-9148-cb99ea01b6c8
674 lines
11 KiB
Plaintext
674 lines
11 KiB
Plaintext
#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
|
|
<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
|