Architecture #2173

embed asciidoc code into project

Added by Fabrice FLORE-THÉBAULT over 3 years ago. Updated 3 months ago.

Status:ReleasedStart date:2012-01-16
Priority:N/ADue date:
Assignee:Fabrice FLORE-THÉBAULT% Done:

100%

Category:Documentation
Target version:2.4.0~alpha3
Pull Request:

Description

Asciidoc project has changed way of invoking themes. The result is : to be sure to build correctly, we should take into account every version of asciidoc in the Makefile. Another approach is to embed asciidoc into the code of documentation : we remove the dependency upon asciidoc package, and have dependancy just on python (and other accassory tools like latex, dblatex, inkscape)

Associated revisions

Revision 330c895a
Added by Fabrice FLORE-THÉBAULT over 3 years ago

fixes #2173 - distribute asciidoc with the documentation - full review of the way the themes/css are handled.

History

#1 Updated by Fabrice FLORE-THÉBAULT over 3 years ago

  • Status changed from In progress to Pending technical review
  • % Done changed from 0 to 100

Applied in changeset commit:330c895ab66e3e6fbb2b8e752eea7c3fd7a3adaf.

#2 Updated by Fabrice FLORE-THÉBAULT over 3 years ago

  • Target version changed from 2.3.6 to 2.4.0~alpha3

#3 Updated by Matthieu CERDA over 3 years ago

Looks good to me and finally works on my Debian Wheezy !

#4 Updated by Matthieu CERDA over 3 years ago

  • Status changed from Pending technical review to Discussion

Note: While building the packages I get :

Build the listings...
XSLT stylesheets DocBook - LaTeX 2e (0.3.2-2)
===================================================
Image 'concepts.png' not found
Image 'packages.png' not found
Image 'agent_workflow.png' not found
Image 'generate_policy_workflow.png' not found
Build rudder-doc.pdf

Are the "not found" errors normal or is this a separate issue ?

#5 Updated by Fabrice FLORE-THÉBAULT over 3 years ago

that's another issue ...

these files are generated from graphviz files.

is it happening on the ci or on your machine ?

#6 Updated by Fabrice FLORE-THÉBAULT over 3 years ago

  • Status changed from Discussion to Pending technical review

dependencies listed in README.asciidoc were not installed on your computer

#7 Updated by Matthieu CERDA about 3 years ago

My bad. All good, JCL, please close this !

#8 Updated by Jonathan CLARKE about 3 years ago

  • Tracker changed from User story to Architecture
  • Status changed from Pending technical review to Released

#9 Updated by Benoît PECCATTE 3 months ago

  • Project changed from Rudder-Doc to Rudder
  • Category set to Documentation

Also available in: Atom PDF