docbook_5/docbook_5-README.SUSE
Thomas Schraitle a1520b38dd Accepting request 1064010 from home:thomas-schraitle:branches:Publishing
- Update to version 5.2CR5
  fixes a bug where the cols attribute on entrytbl element was
  incorrectly optional.
- Update to version 5.2CR4
  - Fix OASIS identifiers in catalog, CR4 (#245)
  - Allow info to be a top-level element in a document (#244)
  - Fix XInclude declarations, inconsistencies (#243)
  - Documentation updates (#242)

OBS-URL: https://build.opensuse.org/request/show/1064010
OBS-URL: https://build.opensuse.org/package/show/Publishing/docbook_5?expand=0&rev=39
2023-02-09 13:01:55 +00:00

79 lines
2.0 KiB
Plaintext

README.SUSE (2023-02-09)
========================
XML Catalog File
----------------
The main DocBook catalog is located in `/etc/xml/catalog.d/docbook_5.xml`.
However, in most cases you will point your catalog resolver to the file
`/etc/xml/catalog`.
The following URIs are supported and point to the same local path:
* http://www.oasis-open.org/docbook/xml/<DB_VERSION>/
* http://www.docbook.org/xml/<DB_VERSION>/
* http://docbook.org/xml/<DB_VERSION>/
* https://cdn.docbook.org/schema/<DB_VERSION>/
The structure of the DocBook schemas are shown in the following overview:
/usr/share/xml/docbook/schema/
├── dtd
│   ├── 4.1.2
│   ├── 4.2
│   ├── 4.3
│   ├── 4.4
│   ├── 4.5
│   └── 5.0
├── nvdl
│   ├── 5.0
│   ├── 5.1
│   └── 5.2
├── rng
│   ├── 4.2
│   ├── 4.3
│   ├── 4.4
│   ├── 4.5
│   ├── 5.0
│   ├── 5.1
│   └── 5.2
├── sch
│   ├── 5.0
│   ├── 5.1
│   └── 5.2
└── xsd
├── 4.2
├── 4.3
├── 4.4
├── 4.5
└── 5.0
DocBook V5.2
------------
The significant differences from 5.1 to 5.2 are:
* Many new synopsis elements for programming languages.
* New <danger> admonition element.
* New <formalgroup> element to support subfigures, etc.
* New transclusion fixup attributes.
* New class attribute on sectioning elements support legal sections.
* New meta element added to info.
* Added XInclude-enabled schema versions of Assembly and ITS schemas.
* Allow <info> as root element
* Many bug fixes
DocBook V5.1
------------
DocBook is a general purpose schema particularly well suited to books and
papers about computer hardware and software (though it is by no means
limited to these applications).
The Version 5.1 release introduces assemblies for topic-oriented authoring.
It also addresses a selection of bugs and feature requests.
For further details, see the documentation in the package docbook_5-doc