chikatambun/rsyslog-doc

documentation for the rsyslog project

rsyslog-docs

Documentation for the rsyslog project

This is a work in progress. We are currently migrating over to a new document generation framework.

The process of this work will be done as follows:

1. Complete v5-stable documentation
2. Merge v5-stable into v7-stable branch
3. Update v7-stable branch with all new documentation and materials specific for that version
4. Repeat 2 and 3 merging current repo with next highest until Master is merged and updated.

Current Status -

• v5-stable - (In Development)
• v7-stable - (In Development)
• v8-devel - (In Development)

Learning the doc tools

If you are new to rst and Sphinx, visit the Sphinx doc to get started: http://sphinx-doc.org/contents.html

Importing missing content

For the time being, occasionally a page from the v7 or v8 doc branches seems to be missing in rsyslog-doc. To recover it, check out the respective version (v8.1.6 is the latest v8 with html doc) and use this too to convert to rst:

$ pandoc -f html -t rst <html_file> -o <output_file>

Instructions

These assume default installs of Python for Windows and Linux

Generate HTML Documentation on Linux

1. Download the pip installer from here: https://raw.github.com/pypa/pip/master/contrib/get-pip.py
2. Run: python ./get-pip.py
3. Run: pip install sphinx
4. Checkout Branch in Repo –
5. Run: git clone https://github.com/rsyslog/rsyslog-doc.git
6. Run: cd rsyslog-doc
7. Run: git checkout v5-stable
8. Run: sphinx-build -b html source build
9. open rsyslog-doc/build/index.html in a browser

###Generate HTML Documentation on Windows

1. Download the pip installer from here: https://raw.github.com/pypa/pip/master/contrib/get-pip.py
2. Download and install Git for windows if you don’t already have Git:
3. https://code.google.com/p/msysgit/downloads/list?can=3&q=full+installer+official+git&colspec=Filename+Summary+Uploaded+ReleaseDate+Size+DownloadCount
4. Install Git for Windows.
5. Run: c:\python27\python get-pip.py
6. Run: c:\python27\scripts\pip install sphinx
7. Checkout Branch in Repo –
8. Run: git clone https://github.com/rsyslog/rsyslog-doc.git
9. Run: cd rsyslog-doc
10. Run: git checkout v5-stable
11. Run: c:\python27\scripts\sphinx-build -b html source build
12. open rsyslog-doc/build/index.html in a browser