---

Hejsa.

Det er første gang jeg arbejder med Docbook. Jeg har læst lidt på
http://www.linuxbog.dk/dokumentation/bog/docbook.html

Mit problem er at hvis jeg bruger <programlisting> tags så ser det
nøjagtigt ud som hvis jeg havde brugt <para> tags.

Det skulde jo gerne se ud som ekempel 2-8 på
http://www.linuxbog.dk/dokumentation/bog/docbook-igang.html


Eksempel:

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<book id="index" lang="en">

<chapter id="About"><title>Program listing</title>
<sect1 id="About2">
<title>programlisting test</title>

<para>
Nu vil jeg vise lidt Perl-kode
</para>

<programlisting>
#!/usr/bin/perl -i.bak -p
s/Microsoft/Linux/g;
</programlisting>

</sect1>
</chapter>
</book>

Når jeg så laver det om til html:

hl@sid/docbook$ db2html eks.sgml
output is eks
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#html
Working on: /home/hl/docbook/eks.sgml
Done.
hl@sid/docbook$

Jeg får alsår ingen fejlmeddelser eller noget, så hvofor virker mine
<programlisting> tags ikke?

Mvh
Heine Laursen

---

Heine Laursen wrote:
> Hejsa.
>
> Det er første gang jeg arbejder med Docbook. Jeg har læst lidt på
> http://www.linuxbog.dk/dokumentation/bog/docbook.html
>
> Mit problem er at hvis jeg bruger <programlisting> tags så ser det
> nøjagtigt ud som hvis jeg havde brugt <para> tags.

Prøv at se om det hjælper at holde din programlisting inde i et para
element ??

Hvilket stylesheet bruger du ?

Vil du ikke heller væk fra det gamle SGML sqrammel og bruge xml ?

MVH
Søren

(jeg kan godt overtales til at prøve at transformere din kode .. i morgen)

---

Den Mon, 14 Jun 2004 00:12:01 +0200. skrev Soren Kuula:

> Heine Laursen wrote:
>> Hejsa.
>>
>> Det er første gang jeg arbejder med Docbook. Jeg har læst lidt på
>> http://www.linuxbog.dk/dokumentation/bog/docbook.html
>>
>> Mit problem er at hvis jeg bruger <programlisting> tags så ser det
>> nøjagtigt ud som hvis jeg havde brugt <para> tags.
>
> Prøv at se om det hjælper at holde din programlisting inde i et para
> element ??

Det gør ingen forskæld

> Hvilket stylesheet bruger du ?

Det er et godt spørgesmål. Standart instillingerne der er i debian
testing vil jeg tro. Hvordan kan jeg finde ud af det!

> Vil du ikke heller væk fra det gamle SGML sqrammel og bruge xml ?

Jeg har aldrig brugt SHML, heller aldrig xml. Desuden er det førdte gang
jeg bruger DOCbook. Er xml nennere?, mere overskulig?

MVH
Heine Laursen

---

Hej,

Heine Laursen wrote:
>>Prøv at se om det hjælper at holde din programlisting inde i et para
>>element ??
>
> Det gør ingen forskæld

OK - det gør det ellers med tabeller skal jeg love for :)

>>Hvilket stylesheet bruger du ?

> Det er et godt spørgesmål. Standart instillingerne der er i debian
> testing vil jeg tro. Hvordan kan jeg finde ud af det!

Det ved jeg faktisk ikke.

SGML er et gammelt metasprog (sprog til at definere andre sprog i). HTML
er f x et SGML sprog. Desværre er nærmest alting tilladt i SGML, hvilket
gør det svært at lave konsistente parsere mv til det.

Så kom XML, her er nærmest alting forbudt. Til gengæld virker de fleste
tools fremragende, og med det samme resultat fra forskellige versioner.

Jeg har ikke brugt andet end Docbook-XML selv.

Overskuelighed: Ja det kan være svært at begynde med !!

Det er mest at huske på:

Docbook er et SGML sprog og et XML sprog. Docbook selv rummer ikke
beskrivelse af andet end dokumenters indholdsmæssige struktur.
(men det er noget andet end HTML, hvor strukturen er en layoutstruktur,
ikke en indholdsstruktur)

Til at lave en layoutstruktur (HTML eller PDF dok...) ud af sin Docbook,
bruges stylesheets.... til XML docbook er der docbook-xsl stylesheetene
på sourceforge; de kan HTML og FO. FO er et mellem-format der kan
transformeres (men ikke med XSL) til PDF ell. l.

Bedste guide til DocBook værktøjer er min helt Stayton's:
http://www.sagehill.net/docbookxsl/

Send mig evt. filen så skal jeg se hvad jeg får ud af den

MVH
Søren

---

Heine Laursen wrote:
> Den Mon, 14 Jun 2004 00:12:01 +0200. skrev Soren Kuula:
>
>
>>Heine Laursen wrote:
>>
>>>Hejsa.
>>>
>>>Det er første gang jeg arbejder med Docbook. Jeg har læst lidt på
>>>http://www.linuxbog.dk/dokumentation/bog/docbook.html
>>>
>>>Mit problem er at hvis jeg bruger <programlisting> tags så ser det
>>>nøjagtigt ud som hvis jeg havde brugt <para> tags.

Når jeg ændrer headeren til

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   "http://www.docbook.org/xml/4.2/docbookx.dtd" []>

<book id="index" lang="en">
........ resten det samme

og transformerer til XHTML med XSL stylesheet docbook-xsl-1.62.4 (Xalan
transformer)

så bliver det til flg. HTML (ja jeg har ikke indentation på output :)

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"> /><meta
content="DocBook XSL Stylesheets V1.64.1" name="generator"
/></head><body><div class="book" lang="en"><div class="titlepage"><div
/><div /><hr /></div><div class="toc"
xmlns="http://www.w3.org/1999/xhtml">

Table of
Contents</b></p><dl><dt><span class="chapter"><a href="#About">1.
Program listing</a></span></dt><dd><dl><dt><span class="sect1"><a
href="#About2">programlisting
test</a></span></dt></dl></dd></dl></div><div class="chapter"
lang="en"><div class="titlepage"><div><div><h2 class="title"><a
id="About" />Chapter 1. Program listing</h2></div></div><div
/></div><div class="toc"><p
xmlns="http://www.w3.org/1999/xhtml">Table of
Contents</b></p><dl><dt><span class="sect1"><a
href="#About2">programlisting test</a></span></dt></dl></div><div
class="sect1" lang="en"><div class="titlepage"><div><div><h2
class="title" style="clear: both"><a id="About2" />programlisting
test</h2></div></div><div /></div><p xmlns="http://www.w3.org/1999/xhtml">
Nu vil jeg vise lidt Perl-kode
</p><pre class="programlisting" xmlns="http://www.w3.org/1999/xhtml">
#!/usr/bin/perl -i.bak -p
s/Microsoft/Linux/g;
</pre></div></div></div></body></html>


og det ser fint ud i Mozilla.

MVH
Søren

---

Den Wed, 16 Jun 2004 23:25:25 +0200. skrev Soren Kuula:

<Snip en masse kode>
>
> og det ser fint ud i Mozilla.

den xml kode ser noget forvirende ud.
Jeg tror jeg venter med Docbook indtil jeg har mere tid til at sætte mig
ind i hvordan det virker.

Mange tak for hjælpen

Mvh
Heine Laursen