Skip to content
Snippets Groups Projects
README.md 1.96 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
    
    
    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.
    
    ## 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.
    
    Hugo NOUTS's avatar
    Hugo NOUTS committed
    
    ## Mkdocs packages
    
        py -m pip install mkdocs-material
        py -m pip install plantuml-markdown