This the source of LVGL's documentation avaialble on https://docs.lvgl.io
The documentation is craeted with Sphinx and RTD theme and with the use of several extensions. See below.
There are the following branches:
master
Collection of the built docuementation for each versionlatest
Documentation for themaster
branch of lvgl. It contains the last features available for testing.dev
Documentation for thedev
branch of lvgl. These features are not stabel and might change.release/vX
Documentation for therelease/vX
branch of lvgl (X
stands for major relases of lvgl). These are the last relased stable versions.
On every release (first and third Tuesday of every month)
- Rebuild and publish
latest
- Merge
latest
torelease/vX
- Merge
latest
todev
- Merge
dev
tolatest
- Rebuild and publish all 3 branches
As you read the documentation you might see some typos or unclear sentences.
For typos and straightforward fixes, you can simply edit the file on GitHub. There is an Edit on Github
link on the top right-hand corner of all pages.
Click it to see the file on GitHub, hit the Edit button, and add you fixes as described in Pull request - From GitHub section.
Note that the documentation is also formatted in Markdown.
If you have more free time you can even translate the documentation. The currently available languages are shown in the locals folder.
If your chosen language is still not added, please write a comment here.
To add your translations:
- Use the latest branch to add translations
- Find the .po in
locals/<language_code>/LC_MESSAGES/<section_name>.po
. E.g. the German translation ofwidgets.md
should be inlocals/de/LC_MESSAGES/widgets.po
. - Open a po file and fill the
msgstr
fields with the translation - Send a Pull request
To display a translation in the public documentation page at least these sections should be translated:
- Get started: Quick overview
- Overview: Objects, Events, Styles
- Porting: System overview, Set-up a project, Display interface, Input device Interface, Tick interface
- 5 widgets of your choice
The documentation is rebuild on every release of lvgl (first and third Tuesday of every month).
The following directions are given for Ubuntu, but should also be useful as a general guide. They assume that https://github.com/lvgl/lvgl is cloned in a folder named lvgl
, and https://github.com/lvgl/docs is beside it in another folder named docs
. The paths are not important (both folders can be located anywhere) but you may have to adjust these instructions slightly.
To rebuild the API documentation, you need Doxygen.
$ ls .
docs lvgl
$ sudo apt install doxygen
$ cd lvgl/scripts
$ doxygen Doxyfile
The documentation is compiled into HTML or another form using Sphinx. In order to get started Sphinx and some other components need to be installed on your system.
$ ls .
docs lvgl
$ pip install -U sphinx recommonmark commonmark breathe sphinx-rtd-theme
$ cd docs # IMPORTANT: note the two .. paths. The lvgl folder also has a folder inside it named docs.
$ rm xml/*
$ cp -a ../lvgl/docs/api_doc/xml/* xml/
$ cd en
$ make html
The HTML pages are in _build/html.
$