From: | Jürgen Purtz <juergen(at)purtz(dot)de> |
---|---|
To: | pgsql-docs(at)lists(dot)postgresql(dot)org |
Subject: | Re: DocBook 5.2 |
Date: | 2022-09-11 11:48:09 |
Message-ID: | 48c4ec57-ce94-408c-936a-ac4dc3cabcae@purtz.de |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On 06.09.22 21:28, Peter Eisentraut wrote:
> On 05.09.22 11:50, Jürgen Purtz wrote:
>> Therefore, we should consider to introduce another validator. During
>> the migration phase,
>> we have used **jing**. It's Java, it's fast, the error messages are
>> very precise. But there
>> are many others:https://relaxng.org/#validators. Should we possibly
>> provide multiple
>> validators in doc/src/sgml/Makefile?
>
> If you follow the links on that page, it appears that all the projects
> other than jing are abandoned. Even jing has a very sporadic release
> history (2015 -> 2018 -> 2022). Last year at FOSDEM I gave a talk
> about the state of the DocBook toolchain [0], where I found that there
> is pretty much no tooling available for Relax-NG. So it's great that
> there is a 2022 release of jing, but before we can consider relying on
> that, it might be nice to see a bit more of a track record. (And we
> should also wait a little to make it trickle in stable packages for
> common operating systems.)
>
> [0]: https://ftp.fau.de/fosdem/2021/D.docs/ttdpostgresdocbook.webm
>
>
The work on the migration has reached a stage where the resulting files
validates against the Relax NG schema and HTML output is generated, see
attached README,md, conv.sh, and doRealModifications.sh. If you want to
test the suite, I recommend the use of jing for the validation process.
The generation of PDF and Epub shows an unacceptable runtime behavior.
An intentionally reduced postgres.sgml file (up to about 100 pages of
output) creates the expected pdf and epub output. After some work on
this problem I don't have any idea how to solve it. During the
sgml-to-xml conversion we faced a similar problem and solved it with an
additional xsl-script. Can someone support me?
--
J. Purtz
Attachment | Content-Type | Size |
---|---|---|
conv.sh | application/x-shellscript | 10.9 KB |
README.md | text/markdown | 4.1 KB |
db4-upgrade.xsl | application/xslt+xml | 49.1 KB |
docbook.rng | application/xml | 648.2 KB |
doRealModifications.sh | application/x-shellscript | 6.3 KB |
htmlmathml-f.ent | application/xml-external-parsed-entity | 155.5 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | David G. Johnston | 2022-09-11 16:03:23 | Re: how to check specific user_name have “SELECT ON ALL TABLES IN SCHEMA <tableschema>” privilege or not ? |
Previous Message | yanliang lei | 2022-09-11 09:40:58 | how to check specific user_name have “SELECT ON ALL TABLES IN SCHEMA <tableschema>” privilege or not ? |