Foliant
Foliant is an all-in-one single-source documentation authoring tool. It lets you produce standalone documents in pdf and docx, build static websites and upload pages to Confluence, all from single Markdown source.
Foliant is a higher order tool, which means it uses other programs to do its job. For building pdf and docx, it can use Pandoc or md-to-pdf, for websites MkDocs, Aglio or Slate.
Foliant preprocessors let you reuse parts of your documents, show and hide content with flags, render diagrams from text, and much more.
Foliant is highly extensible, so if it lacks some functions or output formats you can always make a plugin for it or request one from our team.
Foliant Documentation website.
Installation
Foliant is written in Python and requires Python 3.6.
To install Foliant, use pip:
$ pip install foliant
Backends, extensions, and preprocessors are installed with pip as well. For the Quickstart, you'll need the MkDocs backend and init CLI extension:
$ pip install foliantcontrib.mkdocs foliantcontrib.init
To build pdf and docx, install the Pandoc backend:
$ pip install foliantcontrib.pandoc
Quickstart
- Create a new project:
$ foliant init
Enter the project name: Hello Foliant
✓ Generating Foliant project
─────────────────────
Project "Hello Foliant" created in /path/to/hello-foliant
This command creates a basic Foliant project:
hello-foliant/
├── foliant.yml
└── src
└── index.md
1 directory, 2 files
foliant.yml is the project config file, src is the directory that contains the project source files (initially, just one file index.md).
- Build a website from the newly created project:
$ foliant make site -p hello-foliant/
✓ Parsing config
✓ Applying preprocessor mkdocs
✓ Making site with MkDocs
─────────────────────
Result: Hello_Foliant-0.1.0-2017-11-24.mkdocs
- Run a local webserver in the site directory and see the site in your browser:
$ cd Hello_Foliant-0.1.0-2017-11-24.mkdocs
$ python -m http.server
Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...
- Build a standalone pdf document from the project:
$ foliant make pdf -p hello-foliant/
✓ Parsing config
✓ Applying preprocessor mkdocs
✓ Making pdf with Pandoc
─────────────────────
Result: Hello_Foliant-0.1.0-2017-11-24.pdf
Important
To produce pdf, Pandoc first converts Markdown to tex and then coverts it to pdf. To convert pdf > from tex, you need to have a LaTeX distribution installed:
4 maintainers
Metadata
4 maintainers
Release files for foliant 1.0.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| foliant-1.0.14.tar.gz | 14.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| foliant-1.0.14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 34.0 kB
Release files / foliant-1.0.14.tar.gz
| Download URL | foliant-1.0.14.tar.gz |
|---|---|
| Size | 14.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e8092a368aef0ec746342eae6f861d5111b88c3e7cb519620274983174ed7e73
|
|
BLAKE2b-256 checksum How to use checksums |
ab99bcedbe270ab487aabd307f1bbf15aa7b45c60da34cb78fe3247d0bafa0e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.1 CPython/3.10.2 Linux/6.11.0-1018-azure
|
Release files / foliant-1.0.14-py3-none-any.whl
| Download URL | foliant-1.0.14-py3-none-any.whl |
|---|---|
| Size | 19.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4f92c2d9d2b96c8c3ea61b0757e510f8e6c04792355b37bdd15b3966003aa0cc
|
|
BLAKE2b-256 checksum How to use checksums |
8cabdefdf86078fe79cc8842f9e92d3a2e1928c8206e191dfbfd3338bf3b5a30
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.1 CPython/3.10.2 Linux/6.11.0-1018-azure
|
