mirror of
https://github.com/FunKey-Project/FunKey-Project.github.io.git
synced 2025-12-12 10:18:50 +01:00
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:
parent
2ee689b74b
commit
eb05879df0
33
README.md
33
README.md
@ -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/
|
||||||
|
|||||||
@ -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'
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user