On Monday 21 September 2020 05:06:54 andy pugh wrote: > 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) ...
I find the pdf docs, along with evince for both viewing and printing to be a valuable resource. The linkage from keywords to the actual doc itself is at least 2x handier than the often fails html linkage. Given the extreme difficulty of obtaining English versions of docs on most Chinese products, and the difficulties this virus of theirs has brought to bear on the whole planet, I don't really care if we enable them to use this great software or not. That could be called discriminatory, but it is what it is. Cheers, Gene Heskett -- "There are four boxes to be used in defense of liberty: soap, ballot, jury, and ammo. Please use in that order." -Ed Howdershelt (Author) If we desire respect for the law, we must first make the law respectable. - Louis D. Brandeis Genes Web page <http://geneslinuxbox.net:6309/gene> _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
