attached a docbook book layout, and a test file
its a hack, and i dont know not really of what i did. at least, it worked for
what i need. (web generation via sgmltools 2.0; db2html)
note that the abstract is on a per chapter basis, not front matter.
ive found a funny bug, the sgml picture file name are truncated of one
character too much.
(123.eps -> 12., instead of 123)
otherwise, i would prefer not to have the full path name of the picture in
the sgml file, its not cool for portability, and to move to the web)
Jose Abilio Oliveira Matos wrote:
> On Mon, Feb 28, 2000 at 09:23:11PM +0100, luc taesch wrote:
> > docbook article are nicely produce, and once exported , can produce web
> > page strainght. thats nice.
>
> yep.
>
> > docbook <book> produce even nicer web, as every section got its own
> > page, and toc. navigation.
>
> you can change it if you change the style sheets, but you are right...
>
> > are there any way (or plan) to produce docbook <book>, or any cheats in
> > betweens its done ?
>
> The usual answer is: You can if youn create a new layout file. That is
> not a cheat and it is planned. :)
>
> There is in the documentation files a place "Customization" where this
> is refered. Althoug this applies to the latex classes, there are very few
> changes regarding docbook. (Actually I should update the documentation for
> those details, as Jean-Marc suggested...)
>
> Look for the docbook.layout, as an example of the future layout file.
> This layout should be called docbook-book.layout.
>
> > (sorry if it was already asked )
>
> It wasn't but the docbook support was implemented with this in mind...
>
> > Luc
>
> --
> Jos�
#% Do not delete the line below; configure depends on this
# \DeclareDocBookClass[book]{SGML (DocBook book)}
# DocBook textclass definition file.
# Author : Jose' Matos <[EMAIL PROTECTED]>
# hacked for books: Luc Abom <[EMAIL PROTECTED]>
# Input general definitions
Input stdclass.inc
OutputType docbook
MaxCounter Counter_Section
SecNumDepth 3
TocDepth 3
#docbook specific definitions
Style Standard
LatexType Paragraph
LatexName para
End
# Quote style definition
Style Quotation
LatexType Environment
LatexName blockquote
LatexParam para
End
# Title style definition
Style Title
LatexType Command
LatexName bookinfo
LatexParam "1|"
End
# Title style definition
Style Chapter
LatexType Command
LatexName chapter
LatexParam "1|"
End
# Section style definition
Style Section
LatexType Command
LatexName sect1
LatexParam "2|"
End
# Subsection style definition
Style Subsection
LatexType Command
LatexName sect2
LatexParam "3|"
End
# Subsubsection style definition
Style Subsubsection
LatexType Command
LatexName sect3
LatexParam "4|"
End
# Paragraph style definition
Style Paragraph
LatexType Command
LatexName sect4
LatexParam "5|"
End
# Subparagraph style definition
Style Subparagraph
LatexType Command
LatexName sect5
LatexParam "6|"
End
# Enumerate style definition
Style Enumerate
LatexType Item_Environment
LatexName orderedlist
End
# Itemize style definition
Style Itemize
LatexType Item_Environment
LatexName itemizedlist
End
# Description style definition
Style Description
LatexType Item_environment
LatexName variablelist
End
# Verbatim style definition
Style Literal
LatexType Environment
LatexName literallayout
Font
Latex Latex
EndFont
End
# Code style definition
Style Code
CopyStyle LyX-Code
LatexType Environment
LatexName programlisting
Preamble
EndPreamble
Font
Latex Latex
EndFont
End
# Author style definition
Style Author
LatexType Environment
LatexName author
KeepEmpty 1
End
# first name style definition
Style FirstName
Margin Static
LatexType Paragraph
LatexName firstname
ParIndent MM
ParSkip 0.4
Align Center
AlignPossible Center
LabelType No_Label
End
# surname style definition
Style Surname
Margin Static
LatexType Paragraph
LatexName surname
ParIndent MM
ParSkip 0.4
Align Center
AlignPossible Center
LabelType No_Label
End
# Date style definition
Style Date
LatexType Paragraph
LatexName date
End
# Abstract style definition
Style Abstract
LatexType Environment
LatexName abstract
LatexParam para
End
# SGML style definition
Style SGML
CopyStyle LaTeX
End
# There are no chapters or parts in an docbook article.
#NoStyle Chapter
NoStyle Chapter*
NoStyle Part
NoStyle Part*
NoStyle LaTeX
NoStyle LyX-Code
NoStyle Address
NoStyle Right_Address
NoStyle LaTeX_Title
NoStyle Verse
NoStyle Section*
NoStyle Subsection*
NoStyle Subsubsection*
NoStyle Paragraph*
NoStyle Subparagraph*
Style LyX-Code
ObsoletedBy Code
End
#LyX 1.1 created this file. For more info see http://www.lyx.org/
\lyxformat 2.15
\textclass docbook-book
\language default
\inputencoding latin1
\fontscheme default
\graphics default
\paperfontsize default
\spacing single
\papersize Default
\paperpackage a4
\use_geometry 0
\use_amsmath 0
\paperorientation portrait
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
\defskip medskip
\quotes_language english
\quotes_times 2
\papercolumns 1
\papersides 1
\paperpagestyle default
\layout Title
super title
\layout FirstName
firstname
\layout Surname
surname
\layout Date
date
\layout Chapter
chapter test
\layout Abstract
stration of lyx's features using DocBook.
\layout Abstract
The abstract can span several paragraphs.
\layout Section
\begin_inset LatexCommand \label{first-section}
\end_inset
Introduction
\layout Standard
This file ilustrates the generation of docbook documents with LyX.
\layout Standard
This will improve as soon as new features are available.
\layout Section
Standard layouts
\layout Standard
One of the goals is the support, as much as possible, of layouts used in
other textclass, for compatibility purposes.
\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
.
\layout Subsection
Lists
\layout Standard
This is an example with several nested lists.
\layout Itemize
item 1
\begin_deeper
\layout Enumerate
item 2
\layout Description
new item
\begin_deeper
\layout Enumerate
collection
\end_deeper
\end_deeper
\layout Itemize
new set
\layout Chapter
next chapter
\layout Abstract
abstract chapter 2.
note that abstract are
\begin_inset Quotes eld
\end_inset
per chapter
\begin_inset Quotes erd
\end_inset
\layout Section
Code
\layout Standard
Required steps to have a running lyx.
\layout Quotation
Be carefull with your own code.
\layout Quotation
The debugger.
\layout Code
cat > env.out
\layout Code
tar xvzf lyx.tgz
\layout Code
cd lyx-1_0_x
\layout Code
./configure
\layout Code
make
\layout Code
make install
\layout Subsection
Labels
\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
.
\layout Subsection
Fonts
\layout Standard
The only fonts supported are
\emph on
Emphasis
\emph default
and
\latex latex
<literal>SGML</literal>
\latex default
.
\layout Subsection
Figures
\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
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
\begin_float fig
\layout Standard
\begin_inset Figure size 56 85
file /usr/share/lyx/doc/platypus.eps
width 1 2.00
height 1 3.00
angle 45.00
flags 2
\end_inset
\layout Caption
Nice platypus
\end_float
\layout Standard
Wide figures are treated as normal figures.
\layout Standard
\begin_float wide-fig
\layout Standard
\begin_inset Figure size 56 85
file /usr/share/lyx/doc/platypus.eps
width 1 2.00
height 1 3.00
angle 45.00
flags 2
\end_inset
\layout Caption
long, very long...
:-)
\end_float
\layout Subsection
Tables
\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
Software 1
\newline
Software 2
\newline
Software 3
\newline
Software 4
\newline
Plataform 1
\newline
25 MB
\newline
10 MB
\newline
34 MB
\newline
Plataform 2
\newline
\newline
12 MB
\newline
30 MB
\newline
35 MB
\layout Caption
Nice Formal Table
\end_float
\layout Standard
As it happens with the figures the wide tables are treated as normal tables.
\layout Subsection
Margins
\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
.
\layout Quotation
It is also possible to insert margin notes inside some environments.
\begin_deeper
\layout SGML
\begin_float margin
\end_deeper
\layout Standard
margin note
\layout Standard
second par -> margin note
\layout Standard
third par -> margin note
\end_float
\layout Quotation
Notice that the previous layout is at level 1
\begin_float footnote
\layout Standard
This comes from a docbook restriction.
Sidebar can only appear inside "MSGTEXT", "CAUTION", "IMPORTANT", "NOTE",
"TIP", "WARNING", "BLOCKQUOTE".
\layout Standard
These environments are easily added to the docbook layout.
\end_float
and so is the follow:
\begin_deeper
\layout SGML
\begin_float margin
\end_deeper
\layout Standard
too marginal ;-)
\end_float
\layout Section
The road map
\layout Standard
This is a small list of the remaining tasks:
\layout Itemize
Expand the number of layouts
\begin_deeper
\layout Itemize
example
\layout Itemize
note
\layout Itemize
warning
\layout Itemize
tip
\layout Itemize
caution
\layout Itemize
important
\end_deeper
\layout Itemize
Compose other layout files, besides article
\begin_deeper
\layout Enumerate
book
\layout Enumerate
set (very unlikely)
\begin_float footnote
\end_deeper
\layout Standard
I do not expect lyx to deal with colection of books, for now!
\end_float
\begin_deeper
\layout Enumerate
refentry
\end_deeper
\layout Itemize
goodies
\begin_deeper
\layout Enumerate
including other lyx files
\layout Enumerate
more advanced tables support
\end_deeper
\layout Itemize
better documentation
\layout Standard
That's all.
;-)
\the_end
