kicad-doc-devs team mailing list archive

[Carsten Schoenert <c.schoenert@xxxxxxxxxxx>]

Hello Jon,

Am 21.02.21 um 00:56 schrieb Jon Evans:
> Hi all,
> 
> I'm going to try to get the work Johannes started[1] complete so we can
> move to asciidoctor.

please keep in mind that the build process in some distributions has
restrictions like no access to resources outside the local machine and
to external packages.
Means e.g. 'gem install foo' will not work. The build must work only
based on packaged stuff.

> Right now the main blocker is CJK font support. You can see more details
> on the MR; I'm going to reach out to asciidoctor community to see if
> anyone has a working solution for this other than the unmaintained
> KaiGen Gothic package (this font doesn't even seem to be very available
> anymore).
> 
> One question: do we really need to maintain PDF and ePUB support?  I
> would honestly rather spend time writing documentation than working on
> the bugs associated with the multiple format build system, but I will
> keep working on it if there is a good reason to.

I think it should be the last option to drop support for PDFs and EPUB
media. So these media should be supported always. Like Marco has
described, I've used my EPUB reader a lot in the past to read the
manuals of KiCad.

A typical way of dealing with the work is to do the easy stuff first and
work further on the more difficult parts.
So far I see this the build of PDF and EPUB for non Japanese languages
is mostly still working. So I suggest to drop Japanese for now and
document this clearly but also the state why this isn't working again (yet).

>From the maintainer of the Latex related packages in Debian I know that
the Japanese fonts are a bit complicated as unfortunately poorly
maintained. I can ask for detailed status in case some specific font has
some minor issues.

For now I haven't worked with the new toolchain for kicad-doc, due my
daily workload I wont be able to spend a lot of time on this. Due this
less knowledge I can't say something more useful how to proceed.

I can give a "Please do a 'make foo'" for sure a chance.

-- 
Regards
Carsten