5... as an intermediate distribute pdf file for the problematic language, 
Chinese but do not build problematic language as a default?

> 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


_______________________________________________
Emc-developers mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/emc-developers

Reply via email to