[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: Descriptions of the Help&Manual XML format ?

• From: Doug <doug.duboulay@gmail.com>
• To: xml-dev@lists.xml.org
• Date: Tue, 03 Jan 2023 14:26:08 +0800

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

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

HTH

• Follow-Ups:
  • Re: Descriptions of the Help&Manual XML format ?
    • From: Jean-Christophe Helary <lists@traduction-libre.org>

• References:
  • Descriptions of the Help&Manual XML format ?
    • From: Jean-Christophe Helary <lists@traduction-libre.org>