Skip to content

TKJohn/flowable-userguide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

flowable-userguide 6.3.0 zh_CN

Flowable v6.3.0 userguide. Translate into Chinese.

Modified build.xml, and added bat scripts to run under Windows for zh_CN. Modified zh_CN//-pdf.sh, add Chinese support for generate pdf.

Referring to asciidoctor-pdf, to generate PDF in Chinese, the asciidoctor-pdf-cjk-kai_gen_gothic is also needed. Check the URLs for more details.

Referring to pygments.rb, python 2.x should be installed.

ORIGINAL README BELOW


About

This project regroups all userguide sources

Currently it contains :

  • BPMN : Business Process Model and Notation User Guide
  • CMMN : Case Management Model and Notation User Guide
  • DMN : Decision Model and Notation User Guide
  • FORM : Form engine User Guide
  • SINGLE (Beta Version) : Unified version of all previous documentation

Tooling

Install Asciidoctor: http://asciidoctor.org/

We're using the 'pygments' library for syntax highlighting. This needs to be installed on your system too:

gem install pygments.rb 

Generating the docs

Using build.xml

Simply select run the build.docs.[bpmn|cmmn|dmn|form|single|all] goal and it will generate both a html & pdf version. All generated files will be available in the root project target folder.

From scripts folder

Go to the scripts Folder

  • Call the generate-all.sh [bpmn|cmmn|dmn|form|single] to generate for a single project both html & pdf version
# Genate BPMN documentation in html & pdf format
> ./generate-all.sh bpmn
  • Call the generate-html.sh [bpmn|cmmn|dmn|form|single] to generate html
# Genate Form documentation in html format
> ./generate-html.sh form
  • Call the generate-pdf.sh [bpmn|cmmn|dmn|form|single] to generate pdf
# Genate DMN documentation in pdf format
> ./generate-pdf.sh dmn

From each project folder

Use ./generate-html.sh for html only and likewise ./generate-pdf.sh for pdf only.

Docs on the docs

The html is generated using the 'index-html.adoc' file per project. The pdf generation uses the 'index-pdf.adoc' file per project. Both reference a shared 'index-common.adoc' file for the actual content, but define different parameters in the preamble.

When building the html doc, following files get included automatically:

  • base/flowable.css : this is the stylesheet for the docs. The css will be included inline in the html docs.
  • base/docinfo.html : this file gets included at the top of the html file. It contains the tocbot library and a little script to initialize the dynamic table of contents.

NB

We still use Ant as building tool because Asciidoctor Maven Plugin doesn't support the current level of quality for the generated documenation. We "still" have to use asciidoc command line.