summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorClément Bénier <clement.benier@iot.bzh>2018-12-05 18:11:34 +0100
committerClément Bénier <clement.benier@iot.bzh>2019-01-29 14:49:16 +0100
commit9e922d23f2b733ac47f9e433b8138b60161be4dc (patch)
tree96125b9fcf3b34245715738057b066fb235ee930
parent752e486dca789d1790d92330c7869a3f3e624591 (diff)
handle-doc: add a scheme into documentation
Change-Id: I56e2c81f98c5cab1564fc5463154156c60aa0b71 Signed-off-by: Clément Bénier <clement.benier@iot.bzh>
-rw-r--r--docs/handle-docs/handle-docs.md40
-rw-r--r--docs/handle-docs/pictures/workflow.odgbin146638 -> 115915 bytes
-rw-r--r--docs/handle-docs/pictures/workflow.pngbin244803 -> 206125 bytes
3 files changed, 38 insertions, 2 deletions
diff --git a/docs/handle-docs/handle-docs.md b/docs/handle-docs/handle-docs.md
index c0ade95..9ecb421 100644
--- a/docs/handle-docs/handle-docs.md
+++ b/docs/handle-docs/handle-docs.md
@@ -5,7 +5,21 @@ A tool available in [docs-tools](https://github.com/automotive-grade-linux/docs-
care of collecting and templating all markdown files according fetched_files.yml located in
[docs-webtemplate](https://github.com/automotive-grade-linux/docs-webtemplate).
-<!-- TODO add SCHEMA + description of fetched_files.yml and book.yml logic -->
+See below a scheme of the workflow of agl documentation website generation.
+
+![alt text](pictures/workflow.png)
+
+As you can see, the section_``version``.yml contains the links to all the book yaml files, it is proceed to fetch all book yaml files from remote repositories to the docs-webtemplate. The book yaml files contains all the url to your markdown files from the remote repository.
+
+As soon as all the markdown files are fetched, the tools process to generate the AGL doc website.
+
+---
+
+**Note:**
+
+The images described in markdown files are automatically fetched. For that, the necessary condition is that in markdown files, the relative path has to match with the location of images.
+
+---
## How to add a new documentation section into AGL documentation
@@ -30,7 +44,29 @@ among others :
- subchapters list and consequently subchapters hierarchy
- multi-language description
-<!-- TODO: Add more explanation of multi-language support (eg. suffix xxx_en, xxx_jp ) -->
+---
+
+**Note:**
+
+Multi-language is handled by key suffixes. That is to say, there are some keys that can be suffixed by a language: ``<key>_<lang>``
+For the url to the markdown files, the prefix ```%lang%``` will match with suffixes. So, you have to create a subdirectory named ```%lang%``` where the markdown files are put.
+
+A example for the french:
+
+```
+name: "My section in english"
+name_fr: "Ma section en français"
+url: "%lang/section.md"
+```
+
+```
+$ ls -lR mydir
+book.yml
+section.md
+fr/section.md
+```
+
+---
There are several types of book:
diff --git a/docs/handle-docs/pictures/workflow.odg b/docs/handle-docs/pictures/workflow.odg
index 24c59a4..c633359 100644
--- a/docs/handle-docs/pictures/workflow.odg
+++ b/docs/handle-docs/pictures/workflow.odg
Binary files differ
diff --git a/docs/handle-docs/pictures/workflow.png b/docs/handle-docs/pictures/workflow.png
index b5a39c7..75466e5 100644
--- a/docs/handle-docs/pictures/workflow.png
+++ b/docs/handle-docs/pictures/workflow.png
Binary files differ