A Gitbook-like wiki for your Orchid site.
An Orchid Wiki is a collection of pages structured in a freeform hierarchy. Pages in a wiki are all related and ordered, with one page linking directly to the next so a user can read the entire contents of the wiki from front-end simply by navigating the page links. Orchid Wikis also create Menu items which display the full wiki tree in an easily navigable fashion.
Wikis in Orchid are inspired by GitBook and are set up in a similar manner. To start, add a file named
your language of choice) to
wiki/. This file becomes the landing page for the wiki and can contain any kind of
content, which gets displayed exactly as written. But it also gets converted to HTML and all links in this file become a
page in the wiki.
corresponds to the following directory structure:
which produces the following output:
The content of those wiki pages can be anything, and can be written in any language as long as there is a Compiler for it (just like the summary, and any other page). Orchid also creates a new menu item type which links to every page in the wiki and is displayed recursively in the same hierarchy as the pages themselves.
You can also customize the source directory of the wiki, and even set up multiple wiki sections which each have their
summary file, pages, and menu items. The following snippet should go in your site's
- Looks for the Wiki in /docs instead of /wiki
- Creates a wiki based on /userManual/summary.md
- Creates a wiki based on /developerGuide/summary.md
As of 0.13.0, the wiki plugin includes support for offline documentation. PDFs are an opt-in feature; to enable PDF
generation, simply add
createPdf: true to the section configuration for have it generate a PDF with all the content
for that section of your wiki. Each section will now generate
book.pdf in the section root.
Alternatively, you can set
createPdf: true in the wiki
defaultConfig to be applied to all wiki sections:
The PDF starts with the section
summary.md as a Table of Contents, and each page in the wiki starts after a page break
in the PDF, and the TOC links to each page. You may override
templates/wiki/book.peb to customize your PDFs as needed.
PDFs are generated from HTML using the OpenHTMLToPDF library.