| commit | 53730e0079ecd95f9c719937cf14ee22def719fd | [log] [tgz] |
|---|---|---|
| author | karol brejna <karol.brejna@intel.com> | Wed May 03 08:45:47 2017 +0800 |
| committer | manuzhang <owenzhang1990@gmail.com> | Wed May 03 08:45:47 2017 +0800 |
| tree | 8c8307716e54a3c3f6f5678f2ad6fd2fa5f09524 | |
| parent | 9d7ea50f180454d4de7bff732236b4494fd47479 [diff] |
[GEARPUMP-302] Fix 'latest release' label The link is generated automatically only partly - the visible part is ok, but the link leads to hardcoded version. This PR fixes url generation. Author: karol brejna <karol.brejna@intel.com> Closes #15 from karol-brejna-i/GEARPUMP-302.
This README gives an overview of how to build and contribute to the documentation of Gearpump.
The documentation is included with the source of Gearpump in order to ensure that you always have docs corresponding to your checked out version.
We use Markdown to write and Jekyll to translate the documentation to static HTML. To install Jekyll, you need to install the software as follows:
For redhat linux systems: sudo yum install ruby ruby-devel nodejs python-pip sudo gem install jekyll sudo gem install kramdown sudo gem install html-proofer sudo pip Pygments
Kramdown is needed for Markdown processing and the Python based Pygments is used for syntax highlighting.
The documents for specific Gearpump version can be updated under Gearpump docs. After it is updated, check How to Build to generate documents for that specific version.
Command jekyll build can be used to make the build.
Command jekyll serve --watch can be used to for development. Jekyll will start a web server at localhost:4000 and watch the docs directory for updates. You can use this mode to experiment changes and check the UI locally.
If everything looks fine, make a PR to contribute the code changes to this repo.
The documentation pages are written in Markdown. It is possible to use the GitHub flavored syntax and intermix plain html.
In addition to Markdown, every page contains a Jekyll front matter, which specifies the title of the page and the layout to use. The title is used as the top-level heading for the page.
--- title: "Title of the Page" ---
Furthermore, you can access variables found in docs/_config.yml as follows:
{{ site.NAME }}
This will be replaced with the value of the variable called NAME when generating the docs.
All documents are structed with headings. From these heading, a page outline is automatically generated for each page.
# Level-1 Heading <- Used for the title of the page ## Level-2 Heading <- Start with this one ### Level-3 heading #### Level-4 heading ##### Level-5 heading
Please stick to the “logical order” when using the headlines, e.g. start with level-2 headings and use level-3 headings for subsections, etc. Don‘t use a different ordering, because you don’t like how a headline looks.