Hi all, Asciidoc user since version 8.5.3, I used it on a Windows plateform with Cygwin. Recently, I've decided to use the latest version 8.6.2 on a native Windows platform (so, without Cygwin).
I've also decided to try all cool features such as syntax highlighter with pygments. Install procedure : - download Python 2.7 from http://www.python.org/download/ (with Windows installer - binaries without source) - download Pygments 1.3.1 from http://pygments.org/download/ I got the pygmentize python script commant in folder c: \Python27\Scripts First Problem : ========== Windows did not recognize pygmentize script, because association was with .py extension file First Solution: ========== make a pygmentize.bat with content @python.exe c:\Python27\Scripts\pygmentize %* Second Problem: ============ As I am french user, and I have comment with accents in my source code that are UTF-8 encoded, I run in trouble with encoding file I got these error lines ---------- *** Error while highlighting: UnicodeDecodeError: 'ascii' codec can't decode byte 0xc3 in position 57: ordinal not in range(128) (file "C:\Python27\lib\site-packages\pygments\lexer.py", line 148, in get_tokens) asciidoc: WARNING: QA.txt: line 201: filter non-zero exit code: pygmentize -f html -l php: returned 1 ---------- As pygments allow to change encoding (default is iso8859-1) with its - O switch (http://pygments.org/docs/cmdline/) I wanted to have pygmentize -f html -l php -O encoding=utf-8 But I don't yet find a solution to give extra arguments Perharps a new feature for next version 8.6.3 of AsciiDoc and its source-highlight-filter.conf file Second solution : ============ Helped by an article I found on the Net http://skim.la/2010/02/14/how-to-run-jekyll-pygmentize-on-windows/ Change content of my pygmentize.bat script as follow @python.exe %~dp0pygmentize %* -O encoding=utf-8 Third problem ========== Generate a PDF target with A2X toolchain, with such command a2x.py --icons --fop -f pdf -v -L -d book \source_folder \source_file.txt I cannot pass the XSLT transformation, and cannot generate the .fo file for FOP Got these error lines ---------- a2x: ERROR: xsltproc --nonet --stringparam callout.graphics 1 --stringparam navig.graphics 1 -- stringparam admon.textlabel 0 --stringparam admon.graphics 1 --output C:\docs\QA.fo C:\asciidoc-8.6.2\docbook-xsl\fo.xsl C:\docs \QA.xml returned non-zero exit status 5 ---------- Third Solution: ========== In my situation the --nonet was the problem, without it, XSLTproc can generate the target file I read the asciidoc a2x.py source script and put line 425 ( self.xsltproc_opts += ' --nonet' ) in comment My PDF was generated I suggest to modify asiidoc and put the --nonet as optional Users as always ability to put this parameter on the command line with --xsltproc-opts=XSLTPROC_OPTS Hope my explains are enough clear, and will help other Windows users. To finish, while I tried to find a solution to got color syntax on final PDF files through the a2x toolchain, I read a cool article on the Net about Pygments : Pygments as syntax highlighter for DocBook documents Summary "This article explains how to use Pygments as syntax highlighter for DocBook documents processed with the DocBook XSL stylesheets in order to replace the rather poor standard XSLTHL syntax highlighting." http://lunaryorn.de/articles/docbook_pygments.html Enjoy, and I hope we can have a such solution with futur AsciiDoc release Laurent Laville -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.
