Re: Descriptions of the Help&Manual XML format ?

On Tuesday, 3 January 2023 1:41:58 PM AWST Jean-Christophe Helary wrote:
> I'm looking for a description of the Help&Manual XML format to fix an old
> bug (UX bug?) in OmegaT:
> 
> https://sourceforge.net/p/omegat/bugs/523/
> 
> https://sourceforge.net/p/omegat/code/ci/master/tree/src/org/omegat/filters3
> /xml/helpandmanual/
> 
> I've checked the H&M site and besides for a (very) few screenshots there is
> almost no information regarding what the format looks like (my hunch is
> that it's a DITA-like format, based on the presence of map, topic etc.).
> 
> I'd love pointers if any of you have some.

The doc_src files, in for e.g. 
    https://sourceforge.net/p/omegat/code/ci/master/tree/doc_src/en/
OmegaT5_HowTo.xml[1]
declare themselves to be DocBook V4.5.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"../../../docbook-xml-4.5/docbookx.dtd">

There is a really good description of the format in Norm Walsh's  Definitive Guide
https://tdg.docbook.org/tdg/5.1/index.html[2]

HTH



--------
[1] https://sourceforge.net/p/omegat/code/ci/master/tree/doc_src/en/
OmegaT5_HowTo.xml
[2] https://tdg.docbook.org/tdg/5.1/index.html