From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=0.4 required=5.0 tests=BAYES_00,FORGED_MUA_MOZILLA autolearn=no autolearn_force=no version=3.4.4 X-Google-Thread: 103376,6487f59679c615d8 X-Google-NewGroupId: yes X-Google-Attributes: gida07f3367d7,domainid0,public,usenet X-Google-Language: ENGLISH,UTF8 Received: by 10.68.125.201 with SMTP id ms9mr8267241pbb.3.1336688307066; Thu, 10 May 2012 15:18:27 -0700 (PDT) Path: pr3ni11388pbb.0!nntp.google.com!news1.google.com!goblin1!goblin2!goblin.stu.neva.ru!aioe.org!.POSTED!not-for-mail From: Manuel Collado Newsgroups: comp.lang.ada Subject: Re: Ada Reference Manual 2012 in info format Date: Fri, 11 May 2012 00:15:19 +0200 Organization: Aioe.org NNTP Server Message-ID: References: <82aa1ud0l3.fsf@stephe-leake.org> <20120509131736.63c924c8@vostro> <17qiwxc1yxhx7$.11tflala8jabh$.dlg@40tude.net> <4faa7790$0$9508$9b4e6d93@newsspool1.arcor-online.net> <1qod0a82z1gx4.6ncrd98m7cz3.dlg@40tude.net> NNTP-Posting-Host: Bzj1ovh5Qp0UWQIera3Fhw.user.speranza.aioe.org Mime-Version: 1.0 X-Complaints-To: abuse@aioe.org User-Agent: Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko/20120312 Thunderbird/11.0 X-Notice: Filtered by postfilter v. 0.8.2 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Date: 2012-05-11T00:15:19+02:00 List-Id: El 10/05/2012 17:42, Yannick Duchêne (Hibou57) escribió: > Le Thu, 10 May 2012 17:05:33 +0200, Manuel Collado > a écrit: > >> LaTeX is excellent in creating the final publishing format. But it >> lacks enough separation between contents and presentation. Other >> XML-based markup languages, like DocBook or DITA, seem much more >> appropriate > > Even more DITA, and the authoring style which comes with it (and which > is already there anyway in the actual RM authoring style). To my > opinion, if DocBook is to be favored for something, that would be for > learning materials, where a document is to be read from start to end, as > an uninterrupted flow. The RM is more like a random‑access access > document, with many self‑sufficient parts. > >> IMHO, the most promising line of attack is to keep the current source >> markup, and provide a lossless XML export facility. > > I vote for that one too. Would be too much a nightmare with too few > added value for Randy, to switch to another source format. If there is > something to do at the source level, that's just to avoid potential lack > of semantic markup (I noticed some a long time ago, but forget where, > sorry, will tell if I land to it again). Please note that I'm not suggesting a direct conversion/export from the current markup to DITA. My preference is to just translate each current mark to an equivalent XML tag. This way the full structure and contents of the ARM is preserved, while allowing immediate application of standard XML tools and techniques to process it for producing additional final formats (single-page HTML, MS-Windows HTML help, Latex->PDF with working links, FOP->PDF with working links, DocBook, DITA, and more). -- Manuel Collado - http://lml.ls.fi.upm.es/~mcollado