Skip to content
Snippets Groups Projects
README.md 1.96 KiB
Newer Older
Hugo NOUTS's avatar
Hugo NOUTS committed
# Self Data Grandlyon Documentation
Hugo NOUTS's avatar
Hugo NOUTS committed

## Commands

Hugo NOUTS's avatar
Hugo NOUTS committed
* `py -m pip install mkdocs` - Install mkdocs
Hugo NOUTS's avatar
Hugo NOUTS committed
* `mkdocs serve` - Start the live-reloading docs server.
* `mkdocs build` - Build the documentation site.
* `mkdocs help` - Print this help message.

Hugo NOUTS's avatar
Hugo NOUTS committed
## Mkdocs packages

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

Hugo NOUTS's avatar
Hugo NOUTS committed
## Setting files hierarchy
    inside mkdocs.yml use the key nav: to configure the md files hierarchy

    nav:
    - Home: index.md
Hugo NOUTS's avatar
Hugo NOUTS committed
    - Pilote:
        - Introduction: pilote/index.md
    - Ecolyo:
        - Introduction: ecolyo/index.md
        - Getting started:
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Setup your environment: ecolyo/getting_started/setup_your_environment.md
          - Launch the application on local: ecolyo/getting_started/launch_local_application.md
          - Launch a konnector on local: ecolyo/getting_started/launch_local_konnector.md
Hugo NOUTS's avatar
Hugo NOUTS committed
        - Project Architecture:
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Architecture: ecolyo/project_architecture/architecture.md
          - Cozy: ecolyo/project_architecture/cozy.md
          - Environments: ecolyo/project_architecture/environments.md
          - DocTypes: ecolyo/project_architecture/doctypes.md
Hugo NOUTS's avatar
Hugo NOUTS committed
        - Application:
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Description: ecolyo/application/description.md
          - Scaffolding: ecolyo/application/scaffolding.md
          - Services: ecolyo/application/services.md
          - Gitflow: ecolyo/application/gitflow.md
          - Deploy: ecolyo/application/deploy.md
Hugo NOUTS's avatar
Hugo NOUTS committed
        - Konnectors:
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Enedis: ecolyo/konnectors/enedis.md
          - GRDF: ecolyo/konnectors/grdf.md
          - Eau du Grand Lyon: ecolyo/konnectors/egl.md
Yoan VALLET's avatar
Yoan VALLET committed
    - Proxy:
Hugo NOUTS's avatar
Hugo NOUTS committed
      - Description: proxy/description.md
      - Use cases:
      - Enedis: proxy/use_cases/enedis.md
      - Grdf Adict: proxy/use_cases/grdfadict.md
Hugo NOUTS's avatar
Hugo NOUTS committed

Hugo NOUTS's avatar
Hugo NOUTS committed

## Project layout

    mkdocs.yml    # The main file and configuration file.
    docs/
        index.md  # The documentation homepage.
        ...       # Other markdown pages, images and other files.