forked from enlightenment/efl
133b659b73
Summary: These templates add the following features: - Collapsible sections for simpler reading - Full class names in ancestors list (Could not make it work for descendants) - Removed duplicated Implements section - Removed huge Inherited Members section - Extended maximum number of hierarchy levels from 5 to 10 (because our hierarchy is really that big) Test Plan: Follow the doc/docfx README to generate the HTML pages and enjoy the improved and slightly-more-usable docs. Reviewers: lauromoura, bu5hm4n, zmike, cedric Reviewed By: lauromoura Subscribers: #reviewers, #committers Tags: #efl Differential Revision: https://phab.enlightenment.org/D7832 |
||
---|---|---|
.. | ||
api | ||
default_efl | ||
.gitignore | ||
README | ||
docfx.json | ||
e-logo-title.png | ||
filterConfig.yml | ||
gendoc.sh | ||
index.md | ||
setup.sh | ||
toc.yml |
README
EFL DocFX SUPPORT ----------------- DocFX (https://dotnet.github.io/docfx/) generates documentation HTML pages directly from source code and Markdown files for C# projects. Although significantly slow, it is a simple alternative while our own documentation generator for C# is being written. The scripts in this folder create a documentation site which contains the API reference guide and articles with tutorials and guides. The API guide is generated from the EFL mono sources, which are generated as part of the normal build process. The articles are fetched from the EFL www-content repository and adapted to DocFX syntax. USAGE ----- First off, build EFL with C# support enabled so the C# sources are generated (you will need to have mono 5 installed for this). Then, from this folder, run the `setup.sh` script to download and extract the DocFX binaries to the `bin` folder, fetch the articles from the `www-content` repository and adapt them to the DocFX syntax. Finally, run the `gendoc.sh` script (also from this folder) to produce the HTML files. First run can take a long time (from 10' to 1h), subsequent runs use cached results and take about 5 minutes.