← Back to team overview

kicad-developers team mailing list archive

Re: asciidoc


I'll have to spin up a VM to play with that.  I'll get back to you... :-)


On 5/30/21 2:34 PM, Jon Evans wrote:
You want this one: https://github.com/Mogztter/asciidoctor-web-pdf

On Ubuntu I install it with "sudo npm i -g @asciidoctor/core asciidoctor-pdf"

On Sun, May 30, 2021 at 2:33 PM Steven A. Falco <stevenfalco@xxxxxxxxx> wrote:

I'm able to build the html pages, which is all we need for the nightlies, but I am not able to build the pdf files.  I get an error:


It looks like CMakeModules/FindASCIIDOCTORPDF.cmake wants a program called "asciidoctor-web-pdf".

Fedora has a package "rubygem-asciidoctor-pdf" which provides a program called "asciidoctor-pdf".

I don't know if "asciidoctor-pdf" is equivalent to "asciidoctor-web-pdf".  If it is, then perhaps the cmake file should accept either one.


On 5/30/21 1:58 PM, Steven A. Falco wrote:
Thanks Jon.

I'm running a test build now.  If it passes, I'll propose a patch for the README.  I'll also push the change to the nightly Fedora builds.


On 5/30/21 1:51 PM, Jon Evans wrote:
Hi Steve,

As the readme notes, I have not yet updated the docs for Fedora or
Manjaro/Arch as I don't use those distros and am not sure of the right

If you can advise what should go into the README I'm happy to update it.

Also, please let me know if you run into any snags building the docs
with the new toolchain.


On Sun, May 30, 2021 at 1:49 PM Steven A. Falco <stevenfalco@xxxxxxxxx> wrote:

The Fedora nightly build for doc failed because it wanted asciidoctor, but all it had was asciidoc.

I believe I just need to change the "buildrequires" from:

BuildRequires:  asciidoc


BuildRequires:  rubygem-asciidoctor

in the kicad-nightly-doc.spec file.

However, I also noticed that the page https://gitlab.com/kicad/services/kicad-doc still calls for asciidoc, so that README.adoc should probably be updated too.


Mailing list: https://launchpad.net/~kicad-developers
Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
Unsubscribe : https://launchpad.net/~kicad-developers
More help   : https://help.launchpad.net/ListHelp

Follow ups