Skip to content


Subversion checkout URL

You can clone with
Download ZIP
HTML TeX Python Shell Batchfile

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Documentation Repository Contents
This repository is intended for storage of Liferay product documentation.
Documents are to be comprised of chapter source files in Markdown format.
Images referenced in the documents are to be stored in the appropriate images
directories.  Document sources are stored in directories for their appropriate
language (e.g. 'en' for English).

Directory Structure
 |____ <document dir>/ (e.g. QuickstartGuide/, userGuide/, devGuide/, soffice/)
 |      |____ <language dir>/ (e.g. 'en' for English, 'es' for Spanish)
 |      |      |
 |      |      |____ chapters/
 |      |      |      |____ [0-9][0-9]-<chapter subject>.markdown
 |      |      |            (e.g. 01-intro.markdown)		
 |      |      |
 |      |      |____ images/ (language specific versions of the default images)
 |      |
 |      |____ images/ (default images for the document)
 |      |____ build.xml
 |____ code/ (code for custom ant tasks)
 |____ lib/ (JARs for custom ant tasks)
 |____ README
 |____ build-common.xml

Document Format Conversion
Documents can be converted from markdown to HTML, epub and ODT formats using ant
targets found in build-common.xml. Override default properties, found in, by creating your own properties file
(e.g. build.<username>.properties) to specify your desired property values.

The conversion targets create a build directory (e.g. userGuide/build/) for the
current document. This directory receives the Markdown source file, the language
specific image files, and the converted document.

Required Software
* Ant: Required for executing Ant targets.  Download from ...

* Pandoc: Used in our Ant targets for conversions from Markdown to various
formats. See installation instructions at ...

Conversion Steps
1. Go to the directory of the document to be converted.

  Example - userGuide,
    cd liferay-docs/userGuide

2. Execute a conversion target to produce the desired format of the document.

  Example - aggregate the chapters into a single Markdown file and convert to HTML,
    ant markdown-to-html

  Example - aggregate the chapters into a single Markdown file and convert to ODT,
    ant markdown-to-odt

  Example - convert a single Markdown chapter file (e.g. 01-intro.markdown) to HTML,
    ant chapter-to-html -Dchapter=01-intro

List all of the ant targets by executing ...

    ant -projecthelp

Note, the Windows specific versions of the targets end in "-win"
(e.g. markdown-to-html-win).
Override the language property (i.e. lang), specified in the,
by either passing the language value to ant (e.g. -Dlang=es) or by specifying
the language in a name/value pair (e.g. lang=es) in your

The conversion targets build the results to the respective build directory

  Example - build directory for the userGuide in English,

     |____ userGuide/
            |____ build/
                   |____ en/
                   |      |____ userGuide.html
                   |      |____ userGuide.markdown
                   |      |____ userGuide.odt
                   |____ images/ (language specific images)
Something went wrong with that request. Please try again.