Andy, I would prefer option 3 or 4. I like Gene prefer reading and searching in a pdf.
Alan > Date: Mon, 21 Sep 2020 10:06:54 +0100 > From: andy pugh <[email protected]> > To: EMC developers <[email protected]> > Subject: [Emc-developers] Remove PDF Docs? (Was: DEB for linuxcnc HTML > documentation) > Message-ID: > <CAN1+YZXT_0DHCy-eTS_f3V4jbmj6BQrFp1K5JztQA68r0bi=q...@mail.gmail.com> > Content-Type: text/plain; charset="UTF-8" > > On Sun, 20 Sep 2020 at 20:10, Dr. Nikolaus Klepp <[email protected]> wrote: >> >> I've made a deb with the HTML documentation of linuxcnc 2.8.0 > > I know that you were not suggesting that we remove the PDF docs, but I > would like to expand the discussion in that direction. > > The current tool chain can not build docs in non-latin alphabets. For > 2.8 we had a fairly big submission of Chinese docs. These render OK in > HTML: > http://linuxcnc.org/docs/2.8/html/getting-started/updating-linuxcnc-cn.html > but attempting to build a PDF leads to a build failure. > > A partial solution is to replace latex with xetex in the docs > toolchain. However xetex is not available in Stretch. > > A neater solution might be to use asciidoctor-pdf which is a one-step > process from asciidoc to pdf. It seems to work well (and with Chinese) > but relies on Ruby >v2.3 which is only the default version on the > newer OS versions. > > This is partly a buildbot issue. Do the docs that are distributed with > the LinuxCNC version for a particular necessarily have to have been > built with that OS? > > Options: > 1) Keep things as they are, don't attempt to distribute a Chinese docs > package. > 2) Abandon PDF, distribute docs as HTML in the docs package. > 3) Use xetex to make PDFs, abandon PDF docs build on older OS versions. > 4) Use asciidoctor-pdf to make PDFs, abandon building PDF docs on > older OS version > 5) ... > > > -- > atp > "A motorcycle is a bicycle with a pandemonium attachment and is > designed for the especial use of mechanical geniuses, daredevils and > lunatics." > ? George Fitch, Atlanta Constitution Newspaper, 1912 > _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
