move new files and added directions for local test in the README.md

Signed-off-by: Michel-FK <michel.stempin@funkey-project.com>
This commit is contained in:
Michel-FK 2021-02-02 09:40:29 +01:00
parent 2ee689b74b
commit eb05879df0
4 changed files with 34 additions and 3 deletions

View File

@ -1,3 +1,34 @@
This repository contains the FunKey Project documentation project. This repository contains the FunKey Project documentation project.
The "[source](https://github.com/FunKey-Project/FunKey-Project.github.io/tree/source)" branch contains the source documents; they are processed by MkDocs to generate the resulting static site in the "[master](https://github.com/FunKey-Project/FunKey-Project.github.io/tree/master)" branch that is accessible through Github Pages at https://funkey-project.github.io/FunKey-Project.github.io/ The
"[source](https://github.com/FunKey-Project/FunKey-Project.github.io/tree/source)"
branch contains the source documents; they are processed by MkDocs to
generate the resulting static site in the
"[master](https://github.com/FunKey-Project/FunKey-Project.github.io/tree/master)"
branch that is accessible through Github Pages at
https://funkey-project.github.io/FunKey-Project.github.io/
## Local Build
In order to build le documentation locally, you need to have a Python
3.x installed on your machine.
You will need to isntall the mkdocs-material package and some required
plugins using the following command
```pip install mkdocs-material mkdocs-minify-plugin mkdocs-section-index mkdocs-exclude mkdocs-redirects```
On Unix machines, you will probably need to install it as root user, using:
```sudo pip install mkdocs-material mkdocs-minify-plugin mkdocs-section-index mkdocs-exclude mkdocs-redirects```
## Local Tests
You can launch a local test server that will track all source file
changes and generate a static site on the fly using the following command:
```mkdocs serve```
The test server is then accessible at:
http://localhost:8000/

View File

@ -138,8 +138,8 @@ nav:
- 'Folder Organization': 'user_manual/features/folder_organization.md' - 'Folder Organization': 'user_manual/features/folder_organization.md'
- 'Quick Save': 'user_manual/features/quick_save.md' - 'Quick Save': 'user_manual/features/quick_save.md'
- 'Instant Action': 'user_manual/features/instant_action.md' - 'Instant Action': 'user_manual/features/instant_action.md'
- 'Hardware Characteristics' : 'features/hardware_characteristics.md' - 'Hardware Characteristics' : 'user_manual/features/hardware_characteristics.md'
- 'Open Source' : 'features/open_source.md' - 'Open Source' : 'user_manual/features/open_source.md'
- Tutorials: - Tutorials:
- Software: - Software:
- 'Add New ROMs': 'user_manual/tutorials/software/add_roms.md' - 'Add New ROMs': 'user_manual/tutorials/software/add_roms.md'