Skip to content
Snippets Groups Projects
README.md 5.12 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, configure the md files hierarchy

nav:
  - Home: index.md
  - Easy Cozy:
      - Configuration: easycozy/config.md
      - Commands: easycozy/commands.md
      - Known errors: easycozy/known_errors.md
      - Scripts: easycozy/scripts.md
      - Tips: easycozy/tips.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
      - Project Architecture:
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Architecture: ecolyo/project_architecture/architecture.md
          - Libraries: ecolyo/project_architecture/libraries.md
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Environments: ecolyo/project_architecture/environments.md
          - DocTypes: ecolyo/project_architecture/doctypes.md
          - Remote DocTypes: ecolyo/project_architecture/remote_doctypes.md
      - Application:
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Description: ecolyo/application/description.md
          - Redux: ecolyo/application/redux.md
Hugo NOUTS's avatar
Hugo NOUTS committed
          - Scaffolding: ecolyo/application/scaffolding.md
          - Services: ecolyo/application/services.md
          - Gitflow: ecolyo/application/gitflow.md
          - Deploy: ecolyo/application/deploy.md
      - Services: 
          - Description: ecolyo/services/index.md
          - Monthly report notification: ecolyo/services/monthly_report_notification.md
          - Aggregator usage events: ecolyo/services/aggregator_usage_events.md
          - Consumption Alert: ecolyo/services/consumption_alert.md
      - Functionalities:
          - Initialization: ecolyo/functionalities/initialization.md
          - Consumption: ecolyo/functionalities/consumption.md
          - Ecogesture: ecolyo/functionalities/ecogesture.md
          - Challenge: ecolyo/functionalities/challenge.md
          - Profile Type: ecolyo/functionalities/profile_type.md
          - Analysis: ecolyo/functionalities/analysis.md
          - Usage events tracking: ecolyo/functionalities/usage_events_tracking.md
  - Pilote:
      - Pilote - TS - Back:
          - Index: pilote/Pilote - TS - Back/index.md
          - Application:
              - Deploy: pilote/Pilote - TS - Back/application/deploy.md
          - Functionalities:
              - Routes: pilote/Pilote - TS - Back/functionalities/routes.md
          - Getting Started:
              - Launch the application on local: pilote/Pilote - TS - Back/getting_started/launch_local_application.md
              - Setup your environment: pilote/Pilote - TS - Back/getting_started/setup_your_environment.md
          - Project Architecture: pilote/Pilote - TS - Back/project_architecture/architecture.md
      - Pilote - TS - Front:
          - Index: pilote/Pilote - TS - Front/index.md
          - Application:
              - Deploy: pilote/Pilote - TS - Front/application/deploy.md
          - Functionalities:
              - Routes: pilote/Pilote - TS - Front/functionalities/functions.md
          - Getting Started:
              - Launch the application on local: pilote/Pilote - TS - Front/getting_started/launch_local_application.md
      - Pilote - Usager:
          - Application:
              - Deploy: pilote/Pilote - Usager/application/deploy.md
              - Doctypes: pilote/Pilote - Usager/application/doctypes.md
              - Gitflow: pilote/Pilote - Usager/application/gitflow.md
              - Scaffolding: pilote/Pilote - Usager/application/scaffolding.md
              - Services: pilote/Pilote - Usager/application/services.md
              - Store: pilote/Pilote - Usager/application/store.md
          - Functionalities:
              - Appointments: pilote/Pilote - Usager/functionalities/appointments.md
              - Contact: pilote/Pilote - Usager/functionalities/contact.md
              - Document: pilote/Pilote - Usager/functionalities/document.md
              - Settings: pilote/Pilote - Usager/functionalities/setting.md
          - Getting Started:
              - Launch local doctypes: pilote/Pilote - Usager/getting_started/launch_local_doctypes.md
              - Launch local services: pilote/Pilote - Usager/getting_started/launch_local_services.md
  - Konnectors:
      - Introduction: konnectors/index.md
      - Enedis: konnectors/enedis.md
      - GRDF: konnectors/grdf.md
      - Eau du Grand Lyon: konnectors/egl.md
  - Proxy:
Hugo NOUTS's avatar
Hugo NOUTS committed
      - Description: proxy/description.md
      - Monitoring: proxy/monitoring.md
Hugo NOUTS's avatar
Hugo NOUTS committed
      - 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.