I would like to take up the "old" topic again because I have in the meantime worked myself into the docbook 5 topic.
The adaptations of the individual XML documents are manageable, the header is adapted as follows e.g. (darktable.xml):
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book [
<!ENTITY % darktable_ent SYSTEM "darktable.ent">
%darktable_ent;
]>
<book
version="5.0"
xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xml:lang="en">
...
<!ENTITY % darktable_ent SYSTEM "darktable.ent">
%darktable_ent;
]>
<book
version="5.0"
xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xml:lang="en">
...
The file darktable.dtd in the directory dtd must be renamed to darktable.ent and moved to the same directory as darktable.xml (recommended by docbook developers)
The file darktable.ent must be extended with the following entities so that docbook5 knows the Unicode characters.
The file darktable.ent must be extended with the following entities so that docbook5 knows the Unicode characters.
<!-- Oasis XML Character Entities -->
<!ENTITY % isolat1 PUBLIC
"ISO 8879:1986//ENTITIES Added Latin 1//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isolat1.ent">
%isolat1;
<!ENTITY % isonum PUBLIC
"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isonum.ent[http://www.w3.org/2003/entities/iso8879/isonum.ent]">
%isonum;
<!ENTITY % isopub PUBLIC
"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isopub.ent[http://www.w3.org/2003/entities/iso8879/isopub.ent]">
%isopub;
<!ENTITY % isotech PUBLIC
"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isotech.ent[http://www.w3.org/2003/entities/iso8879/isotech.ent]">
%isotech;
<!ENTITY % isolat1 PUBLIC
"ISO 8879:1986//ENTITIES Added Latin 1//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isolat1.ent">
%isolat1;
<!ENTITY % isonum PUBLIC
"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isonum.ent[http://www.w3.org/2003/entities/iso8879/isonum.ent]">
%isonum;
<!ENTITY % isopub PUBLIC
"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isopub.ent[http://www.w3.org/2003/entities/iso8879/isopub.ent]">
%isopub;
<!ENTITY % isotech PUBLIC
"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
"http://www.w3.org/2003/entities/iso8879/isotech.ent[http://www.w3.org/2003/entities/iso8879/isotech.ent]">
%isotech;
To convert the docbook5 xml files to HTML, make sure that the correct stylesheets are used. In the case of the current Sytleshets this is the docbook-xml-1.79.2 and not the docbook-xml-nons-1.79-2!
https://github.com/docbook/xslt10-stylesheets/releases/tag/release%2F1.79.2[https://github.com/docbook/xslt10-stylesheets/releases/tag/release%2F1.79.2]
With version 1.79-1 the packages with the extension ns must be used!
For example, the docbook-xsl-ns package must be installed with the current Ubuntu version.
Can you check which stylesheet versions are available on your OS / Linux distributions?
In Arch Linux the name of the package is confusing, because the package docbook-xml inclueds the docbook-xml-nons stylesheets.
In the short term I could provide the changed XSL files. To avoid conflicts later on it is not advantageous if the open pull requests like #1675, #1667 and #1604 are implemented?
Who can customize the make files because I have no experience at all?
Currently I use the program xsltproc to create the HTML output file.
Pierre
--------------------------------------------------------------------------------------------
Betreff: Re: [darktable-dev] considerations to port the documentation to
Docbook 5.x
Am Donnerstag, 3. Mai 2018, 18:41:07 CEST schrieb Tobias Ellinghaus <m...@houz.org>
> Am Donnerstag, 3. Mai 2018, 16:58:04 CEST schrieb openhab.doc:
>> Hello,
>>
>> are there any considerations to port the documentation to the newer Docbook
>> 5.x?
>That sounds like an awful lot of work. Is there anything special we would get
>from that?
>> Pierre
>Tobias
___________________________________________________________________________ darktable developer mailing list to unsubscribe send a mail to darktable-dev+unsubscr...@lists.darktable.org
