mirror of
https://github.com/NixOS/mobile-nixos.git
synced 2024-12-16 20:21:32 +03:00
48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
*Documentation internal notes*
|
|
==============================
|
|
|
|
This document is not to be generated into the website/documentation.
|
|
|
|
* * *
|
|
|
|
Implementation notes
|
|
--------------------
|
|
|
|
This documentation folder generates the Mobile NixOS website *and* documentation
|
|
as a whole.
|
|
|
|
The documentation is to be written in asciidoc, and converted through a custom
|
|
pipeline through the Asciidoctor API. Markdown files are accepted in the
|
|
pipeline, but frowned upon except for the simplest documentation articles.
|
|
|
|
The build pipeline can be improved upon, and contributions doing so are welcome!
|
|
|
|
|
|
Main Page and News
|
|
------------------
|
|
|
|
To reduce the amount of irrelevant contents in the documentation folders, the
|
|
main page, and news entries from the Mobile NixOS website have been split into
|
|
the Mobile NixOS website repository.
|
|
|
|
This also allows more leeway to add additional non-documentation relevant pages
|
|
to the website. The documentation folder of the main repository is used solely
|
|
for documentation.
|
|
|
|
|
|
Devices list
|
|
------------
|
|
|
|
The `devices` folder is special and assumes it will be replaced in-place with
|
|
asciidoc source files generated from a build outside of the main documentation
|
|
build. This is because it is generated from the actual device descriptions from
|
|
the repository.
|
|
|
|
|
|
Sitemap
|
|
-------
|
|
|
|
The sitemap is simply a dump of all document files and "catalogs" from as parsed
|
|
by Asciidoctor.
|
|
|