Hello Lex, Thank you, once more, for your quick response.
I'm a usual LaTeX user and have just now started using AsciiDoc since, I'm told, its quality is not very far removed from that of Tex, regarding at least the regular output of the standard LaTeX document-classes, and its syntax is considerably simpler and much more straightforward. I have, in fact, installed *asccidoctor-pdf* (a no-fuss, one-step, installation process) and have been using it all along to try out AsciiDoc. I have, nevertheless, insisted on figuring out the installation process of the Legacy AscciDoc Python implementation since, it seems to me, there might be something to the added complexity of the DocBook *tool chain* that might have got lost in Asciidoctor's simplicity. (I figured it won't hurt to have both processors installed---and learn their respective syntax---in order to find out for myself if this is true.) That's all. Regarding my *asciidoc.py *installation, I think what's mixed up is my own note-taking regarding the output I've got while trying out different releases. (I have tried out both, i.e., 9.0.5 and 9.1.0, starting with the latest, and have had the same problem in each case.) My mistake. *All things considered*, maybe the best way of finding out if there is, in fact, "something to the added complexity of the DocBook *tool chain* that might have got lost in Asciidoctor's simplicity" is asking the community. Cheers, Zam El lunes, 1 de marzo de 2021 a la(s) 19:15:44 UTC-5, Lex Trotman escribió: > I'm sorry I should have first asked why you are using the legacy > AsciiDoc Python implementation? > > The current most used AsciiDoc processor is Asciidoctor > www.asciidoctor.org. If you are making new documents you should use > that as it is also the starting point of the AsciiDoc standardisation > effort which is starting now to allow multiple compatible > implementations to exist and avoid the markdown shambles. > > Asciidoctor can generate more output formats without a toolchain, or > can generate docbook so that the same toolchain can be used to keep an > existing presentation. > > If you are processing legacy documents from an existing project, some > will process with Asciidoctor's compatibility mode. Only existing > documents that rely on features not supported by Asciidoctor or on > extensions that only exist for this implementation should use this > processor. > > In case thats why you need it, your install seems mixed up, I have > lost track of changes to install lately, but it seems to be mixing > /etc/local/asciidoc and /etc/local/asciidoc9.0.5 I would suggest > removing it and installing the new release 9.1.0 from last month, see > at top of https://asciidoc.org/index.html. > > Cheers > Lex > > On Tue, 2 Mar 2021 at 05:37, 'Zam' via asciidoc > <[email protected]> wrote: > > > > Hello Lex, > > > > Thank you very much for yet another quick response! > > > > You're right about me judging erroneously what a2x is --- and isn't. > With hindsight, I would have said, instead: "It seems this is a quite > common---and, not strangely, old---problem relating to some users' > misconceptions about a2x." > > > > I have now dutifully installed xsltproc, the DocBook XSL Stylesheets, > dblatex, and w3m, per https://asciidoc.org/a2x.1.html#X1, as you seem to > have suggested. This, however, can only take me so far, i.e., beyond > xmllint and the relevant XML DTDs. What follows is the output I'm now > getting, beyond the usual first 18 lines of code: > > > > a2x: executing: "dblatex" -t pdf -p > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.xsl" -s > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty" -V > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" > > > > Build the book set list... > > xsltproc -o doclist.txt --xinclude --xincludestyle doclist.xsl > /home/zam/Downloads/asciidoc-9.0.5/doc/article.xml > > Build the listings... > > xsltproc -o listings.xml --xinclude --xincludestyle --param current.dir > '/home/zam/Downloads/asciidoc-9.0.5/doc' > /usr/share/dblatex/xsl/common/mklistings.xsl > /home/zam/Downloads/asciidoc-9.0.5/doc/article.xml > > xsltproc -o article.rtex --xinclude --xincludestyle --param current.dir > '/home/zam/Downloads/asciidoc-9.0.5/doc' --param listings.xml > '/tmp/tmpYrmfo_/listings.xml' /tmp/tmpYrmfo_/custom.xsl > /home/zam/Downloads/asciidoc-9.0.5/doc/article.xml > > XSLT stylesheets DocBook - LaTeX 2e (0.3.10) > > =================================================== > > Image 'dblatex' not found > > Image 'images/smallnew.png' not found > > Image 'images/tiger.png' not found > > Build article.pdf > > built-in module pdftex registered > > no support found for ifthen > > no support found for ifxetex > > no support found for fontspec > > no support found for xltxtra > > no support found for fontenc > > no support found for inputenc > > no support found for fancybox > > built-in module makeidx registered > > no support found for asciidoc-dblatex > > built-in module bibtopic registered > > building additional files... > > checking if compiling is necessary... > > the output file doesn't exist > > pdflatex -interaction=batchmode article.tex > > pdflatex failed > > /usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty: File `docbook.sty' > not found. > > /usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty:8: Emergency stop. > > /usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty:8: leading text: ^^M > > Unexpected error occured > > Error: pdflatex compilation failed > > > > a2x: ERROR: "dblatex" -t pdf -p > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.xsl" -s > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty" -V > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" returned non-zero exit > status 1 > > > > It seems my main problem now is pdflatex cannot find the docbook.sty > file in question. If that's right, could you please point me to the place > where I can get it? > > > > It would be nice, too, if you could explain to me what's with all the > Image [...] not found and the no support found for... messages, since (1) > such images do exist in the asciidoc-9.0.5/images directory, and (2) I have > TexLive's latest version installed and have thus far used it successfully. > > > > Sorry for the rather general amateurish character of my inquiry. Please, > feel free to answer my questions whenever you have the time to do so. > > > > Cheers, > > > > Zam > > > > > > El lunes, 1 de marzo de 2021 a la(s) 00:19:04 UTC-5, Lex Trotman > escribió: > >> > >> On Mon, 1 Mar 2021 at 14:26, 'Zam' via asciidoc > >> <[email protected]> wrote: > >> > > >> > Hello Lex, > >> > Thank you for the (very) quick response! > >> > Here is the output of adding -v -v to my original command: > >> > > >> > a2x: args: ['-v', '-v', '--format=pdf', 'doc/article.txt'] > >> > a2x: resource files: [] > >> > a2x: resource directories: ['/usr/local/etc/asciidoc/images', > '/usr/local/etc/asciidoc/stylesheets'] > >> > a2x: executing: "/usr/local/bin/asciidoc.py" --backend docbook -a > "a2x-format=pdf" --verbose --out-file > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.txt" > >> > > >> > asciidoc: reading: /usr/local/etc/asciidoc/asciidoc.conf > >> > asciidoc: reading: > /home/zam/Downloads/asciidoc-9.0.5/doc/asciidoc.conf > >> > asciidoc: reading: /home/zam/Downloads/asciidoc-9.0.5/doc/article.txt > >> > asciidoc: reading: /usr/local/etc/asciidoc/docbook45.conf > >> > asciidoc: reading: > /usr/local/etc/asciidoc/filters/code/code-filter.conf > >> > asciidoc: reading: > /usr/local/etc/asciidoc/filters/music/music-filter.conf > >> > asciidoc: reading: > /usr/local/etc/asciidoc/filters/source/source-highlight-filter.conf > >> > asciidoc: reading: > /usr/local/etc/asciidoc/filters/graphviz/graphviz-filter.conf > >> > asciidoc: reading: > /usr/local/etc/asciidoc/filters/latex/latex-filter.conf > >> > asciidoc: reading: /usr/local/etc/asciidoc/lang-en.conf > >> > asciidoc: reading: > /home/zam/Downloads/asciidoc-9.0.5/doc/asciidoc.conf > >> > asciidoc: writing: /home/zam/Downloads/asciidoc-9.0.5/doc/article.xml > >> > > >> > a2x: executing: "xmllint" --nonet --noout --valid > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" > >> > > >> > /bin/sh: 1: xmllint: not found > >> > >> This means xmllint isn't installed which you have fixed. > >> > >> > > >> > a2x: ERROR: "xmllint" --nonet --noout --valid > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" returned non-zero exit > status 127 > >> > > >> > And here is the output of that very same command, i.e., a2x -v -v > --format=pdf doc/article.txt, once I installed xmllint: > >> > > >> > [The first 18 lines of code are identical] > >> > > >> > a2x: executing: "xmllint" --nonet --noout --valid > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" > >> > > >> > I/O error : Attempt to load network entity > http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd > >> > /home/zam/Downloads/asciidoc-9.0.5/doc/article.xml:2: warning: failed > to load external entity " > http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; > >> > D DocBook XML V4.5//EN" " > http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; > >> > ^ > >> > /home/zam/Downloads/asciidoc-9.0.5/doc/article.xml:6: validity error > : Validation failed: no DTD found ! > >> > <article lang="en"> > >> > ^ > >> > >> This means you don't have the relevant XML dtds installed, but you can > >> run a2x with --no-xmllint to skip it, xmllint is just a sanity check, > >> its not required. > >> > >> > >> > > >> > a2x: ERROR: "xmllint" --nonet --noout --valid > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" returned non-zero exit > status 4 > >> > > >> > I then found this old thread of yours and others, > https://groups.google.com/g/asciidoc/c/FC-eOwU8rYg, on exactly the same > non-zero exit status 4 and tried out its last two solutions --- alas, to no > avail. Whereas the first solution, i.e., that of [email protected], gave > me the output: > >> > > >> > [Same first 18 lines of code] > >> > >> I'm not sure which solution you used, but clearly you got past xmllint > >> > >> > > >> > a2x: executing: "dblatex" -t pdf -p > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.xsl" -s > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty" -V > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" > >> > > >> > /bin/sh: 1: dblatex: not found > >> > >> You need relevant toolchains installed to process the docbook asciidoc > >> produces, see https://asciidoc.org/a2x.1.html#X1 linked from the top > >> of the a2x page. a2x is simply a script to simplify some of the steps > >> to do that, it doesn't include the toolchains. > >> > >> > > >> > a2x: ERROR: "dblatex" -t pdf -p > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.xsl" -s > "/usr/local/etc/asciidoc/dblatex/asciidoc-dblatex.sty" -V > "/home/zam/Downloads/asciidoc-9.0.5/doc/article.xml" returned non-zero exit > status 127 > >> > > >> > the second one, i.e., that of [email protected], threw me once > more the above-mentioned non-zero exit status 4 output. > >> > > >> > It seems this is a quite common---and, strangely, old---problem > relating to a2x. I don't know, however, what I'm supposed to now. > >> > >> Its quite common for people to not read the part about needing > >> toolchains to process the docbook into PDF. AsciiDoc itself only > >> produces docbook or HTML itself. As linked above its addressed in the > >> a2x page, and also discussed in the AsciiDoc user guide > >> https://asciidoc.org/userguide.html#_docbook. > >> > >> Cheers > >> Lex > >> > >> > > >> > Would very much appreciate your thoughts on this, Lex. > >> > > >> > Cheers, > >> > > >> > Zam > >> > > >> > El domingo, 28 de febrero de 2021 a la(s) 20:03:53 UTC-5, Lex Trotman > escribió: > >> >> > >> >> try adding -v -v yes thats twice, to the a2x command to get expanded > >> >> error messages. > >> >> > >> >> Cheers > >> >> Lex > >> >> > >> >> On Mon, 1 Mar 2021 at 10:53, 'Zam' via asciidoc > >> >> <[email protected]> wrote: > >> >> > > >> >> > > >> >> > Hello there, > >> >> > > >> >> > I have just installed AsciiDoc 9.0.5 ( > https://github.com/asciidoc-py/asciidoc-py/releases) on my Linux machine > and have successfully tested the installation (as per > https://asciidoc.org/INSTALL.html). > >> >> > > >> >> > Unfortunately, though, I'm unable to run a2x --format=pdf > doc/article.txt on the sample article.txt file included in the distribution > root directory. This is the error message I keep getting again and again: > >> >> > > >> >> > a2x: ERROR: "xmllint" --nonet --noout --valid > "/home/user/Downloads/asciidoc-9.0.5/doc/article.xml" returned non-zero > exit status 127 > >> >> > > >> >> > Any ideas of what the problem might be? > >> >> > > >> >> > Thank you very much in advance. > >> >> > > >> >> > Cheers, > >> >> > > >> >> > Zam > >> >> > > >> >> > > >> >> > -- > >> >> > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > >> >> > To unsubscribe from this group and stop receiving emails from it, > send an email to [email protected]. > >> >> > To view this discussion on the web visit > https://groups.google.com/d/msgid/asciidoc/e0aa14f5-47b4-44de-816e-195fd79bcd5bn%40googlegroups.com > . > >> > > >> > -- > >> > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > >> > To unsubscribe from this group and stop receiving emails from it, > send an email to [email protected]. > >> > To view this discussion on the web visit > https://groups.google.com/d/msgid/asciidoc/299848fb-5d26-4684-8ea3-69668841f078n%40googlegroups.com > . > > > > -- > > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > > To unsubscribe from this group and stop receiving emails from it, send > an email to [email protected]. > > To view this discussion on the web visit > https://groups.google.com/d/msgid/asciidoc/7e0b7c74-f7e8-4903-a28c-547f9cb2c444n%40googlegroups.com > . > -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/asciidoc/3da47408-cc7c-4166-b7e5-ffb98099b0d9n%40googlegroups.com.
