Skip to content
Snippets Groups Projects
README.md 4.74 KiB
Newer Older
  • Learn to ignore specific revisions
  • Hugo NOUTS's avatar
    Hugo NOUTS committed
    # Self Data Grandlyon Documentation
    
    Hugo NOUTS's avatar
    Hugo NOUTS committed
    
    ## Commands
    
    
    - `py -m pip install mkdocs` - Install mkdocs
    - `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
    
    
    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:
    
    Hugo NOUTS's avatar
    Hugo NOUTS committed
    
    
    - 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:
        - 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:
        - Architecture: ecolyo/project_architecture/architecture.md
        - Libraries: ecolyo/project_architecture/libraries.md
        - Environments: ecolyo/project_architecture/environments.md
        - DocTypes: ecolyo/project_architecture/doctypes.md
        - Remote DocTypes: ecolyo/project_architecture/remote_doctypes.md
      - Application:
        - Description: ecolyo/application/description.md
        - Redux: ecolyo/application/redux.md
        - Scaffolding: ecolyo/application/scaffolding.md
        - Services: ecolyo/application/services.md
        - Gitflow: ecolyo/application/gitflow.md
        - Deploy: ecolyo/application/deploy.md
        - Mail: ecolyo/application/mail.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
        - Onboarding: ecolyo/functionalities/onboarding.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:
      - Description: proxy/description.md
      - Monitoring: proxy/monitoring.md
      - Use cases:
        - Enedis: proxy/use_cases/enedis.md
        - Grdf Adict: proxy/use_cases/grdfadict.md
    
    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.