Skip to content
Snippets Groups Projects
README.md 1.37 KiB
Newer Older
Hugo NOUTS's avatar
Hugo NOUTS committed
# Lyon Living Lab Energy Documentation

## Commands

Hugo NOUTS's avatar
Hugo NOUTS committed
* `py -m pip install mkdocs` - Install mkdocs
Hugo NOUTS's avatar
Hugo NOUTS committed
* `mkdocs new [dir-name]` - Create a new project.
* `mkdocs serve` - Start the live-reloading docs server.
* `mkdocs build` - Build the documentation site.
* `mkdocs help` - Print this help message.

## Setting files hierarchy
    inside mkdocs.yml use the key nav: to configure the md files hierarchy

    nav:
    - Home: index.md
    - Project Architecture:
        - Introduction: architecture/architecture-home.md
        - Client: architecture/client/client.md
        - Cozy: architecture/cozy/cozy.md
        - Konnectors:
Hugo NOUTS's avatar
Hugo NOUTS committed
            - Introduction: architecture/konnectors/konnectors-intro.md
Hugo NOUTS's avatar
Hugo NOUTS committed
            - Enedis: architecture/konnectors/enedis.md
            - EGL: architecture/konnectors/egl.md
Hugo NOUTS's avatar
Hugo NOUTS committed
            - GDRF: architecture/konnectors/gdrf.md
Hugo NOUTS's avatar
Hugo NOUTS committed
    - About:
Hugo NOUTS's avatar
Hugo NOUTS committed
        - Gitflow: miscellaneous/gitflow.md
Hugo NOUTS's avatar
Hugo NOUTS committed
        - Glossary: miscellaneous/glossary.md
        - Tools: miscellaneous/tools.md
Hugo NOUTS's avatar
Hugo NOUTS committed
        - Environment: miscellaneous/devenv.md
Hugo NOUTS's avatar
Hugo NOUTS committed
        - VSCode: miscellaneous/vscode-settings.md


## Project layout

    mkdocs.yml    # The main file and configuration file.
    docs/
        index.md  # The documentation homepage.
        ...       # Other markdown pages, images and other files.
Hugo NOUTS's avatar
Hugo NOUTS committed

## Mkdocs packages

    py -m pip install mkdocs-material
    py -m pip install plantuml-markdown