User story #1812: install python-pygments and source-highlight on ci - Rudder - Issue Tracker

Actions

Copy link

User story #1812

closed

install python-pygments and source-highlight on ci

Added by Fabrice FLORE-THÉBAULT over 13 years ago. Updated over 9 years ago.

Status:

Rejected

Priority:

5 (lowest)

Assignee:

Fabrice FLORE-THÉBAULT

Category:

Documentation

Target version:

Ideas (not version specific)

Pull Request:

UX impact:

Suggestion strength:

User visibility:

Effort required:

Name check:

Fix check:

Regression:

Description

The source-highlight plugin for source code colorization has a far better output than the code plugin used now.

To use [source,xhtml] and [source, shell] instead of [code] in the code listing of etc files, some packages are missing on the ci platform.

You should also install pygments (sudo apt-get install python-pygments) and source-highlight (sudo apt-get install source-highlight).

This procedure is described here : https://github.com/gpr/redmine_asciidoc_formatter

After installing this packages, you should document these prerequisites in the README of the documentation, and replace occurences of [code] by accurate [source,xhtml], [source, shell], etc.

Note that the link provided here is also a link to a redmine plugin allowing to write in asciidoc format in redmine wiki ;)

Actions

Copy link

Updated by François ARMAND about 13 years ago

Target version changed from 10 to 24

Actions

Copy link

Updated by Jonathan CLARKE over 12 years ago

Target version changed from 24 to 18

Actions

Copy link

Updated by Jonathan CLARKE about 12 years ago

Status changed from New to Discussion
Assignee set to Fabrice FLORE-THÉBAULT
Target version changed from 18 to Ideas (not version specific)

I installed these packages, but using "source" instead of "code" is pretty in HTML but causes the PDF output to break:

/home/jclarke/COMMUNAUTES/Rudder/rudder-doc/bin/asciidoc/asciidoc.py --doctype=book -a docinfo1 --backend docbook rudder-doc.txt
dblatex -tpdf rudder-doc.xml
Build the book set list...
Build the listings...
XSLT stylesheets DocBook - LaTeX 2e (0.3.3-2)
===================================================
Build rudder-doc.pdf
pdflatex failed
rudder-doc.tex:3748: Package Listings Error: Couldn't load requested language.
rudder-doc.tex:3748: leading text: ...tlisting}[language=shell,firstnumber=1,]
rudder-doc.tex:3748: Package Listings Error: language shell undefined.
rudder-doc.tex:3748: leading text: ...tlisting}[language=shell,firstnumber=1,]
Unexpected error occured
Error: pdflatex compilation failed
make: *** [html/rudder-doc.pdf] Error 1

Actions

Copy link