FontLab 7 Python API documentation

Viewing the documentation

Visit the fontlabcom.github.io/fontlab-python-docs to view the documentation in the browser.

Install FontLab 7 and Python 2.7 that FontLab uses.

In Terminal or command-line, run:

python2 -m pip install --user --upgrade git+https://github.com/twardoch/pydocmk2

Go to the fontlab7/build folder.

Open build_fontlab7_api_docs.vfpy in FontLab 7 and wait until the pydocmk2 packages generates the Markdown files into the fontlab7/srcdocs/mkdocs folder.

In Terminal, go to Go to the fontlab7/build folder and run:

python2 -m mkdocs build -v -f ../mkdocs.yml --dirty

This will build the HTML documentation using mkdocs into the docs/ folder.

Go to the pythonqt/build folder, and proceed the same way. This will build into the docs/pythonqt folder.

Before you contribute to this repository, you must agree to the FontLab Individual Contributor License Agreement

Look up a base name (without the .md extension) in the srcdocs/mkdocs folder.
Go to the wiki and create a new article with the same name.
Write your content — we’ll review it and move it to the official docs.

Fork the repo.

The fontlab7/srcdocs/ folder has three subfolders:

docs contains .md files that will be included in the documentation as separate documents
pre may contain optional .md files that have the same names as the autogenerated API documents (e.g. typerig.core.objects.cubicbezier.md): the content of each such file will be prepended to the autogenerated doc file (inserted after the first header)
post may contain optional .md files that have the same names as the autogenerated API documents (e.g. typerig.core.objects.cubicbezier.md): the content of each such file will be appended to the autogenerated doc file (added to the end)

You may create new documents in pre and post folders to enhance the autogenerated content with human-authored documentation.

Create a pull request and we’ll consider it.

The pydocmk.yml YAML file controls the build process, see pydocmk2 for details.