mkdocs.yml

# Licensed under the Apache License, Version 2.0 (the "License"); you may not
# use this file except in compliance with the License. You may obtain a copy
# of the License at:
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING, SOFTWARE
# DISTRIBUTED UNDER THE LICENSE IS DISTRIBUTED ON AN "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
# SEE THE LICENSE FOR THE SPECIFIC LANGUAGE GOVERNING PERMISSIONS AND
# LIMITATIONS UNDER THE LICENSE.

# Project information
site_name: ToIP Deliverables
site_url: https://trustoverip.github.io/deliverables/
site_author: Trust over IP Foundation
site_description: >-
  The ToIP Deliverables Portal provides the content resources
  for the generation of documentation associated with the
  contribution process and state of our ToIP Deliverables.

# Repository information
repo_name: trustoverip/deliverables
repo_url: https://github.com/trustoverip/deliverables

# Content Generator Settings
docs_dir: 'docs'
site_dir: 'html'

# Copyright information
copyright: >-
  Copyright © 2020 Joint Development Foundation Projects, LLC, Trust over
  IP Foundation Series <a href="https://jdfprojects.org/toip/">Terms of Use,
  Privacy Policy and Cookie Policy</a>. The Joint Development Foundation
  Projects, LLC is an affiliate of the Linux Foundation.

# Navigation structure
nav:
- Introduction:
    - 'Overview': 'index.md'
    - 'Deliverables': './process/work_products.md'
    - 'Resource Management': './process/work_product_mgmt.md'
    - 'Lifecycle Management ': './process/lifecycle_management.md'
- How we work:
    - 'Process Concepts': './process/process_concepts.md'
    - 'Content Templates': './process/content_templates.md'
    - 'Basic Tools': './process/basic_tools.md'
    - Contribution Options:
        - 'Inline Document': './process/contributing_pr.md'
        - 'Single Document Generation': './process/contributing_basic_doc.md'
        - 'Rich Content Generation': './process/contributing_multi_docs.md'
        - 'Rich Specification Generation': './process/contributing_multi_specs.md'
    - 'Issue Management': './process/github-issues.md'
    - 'Change Management': './process/github-pullrequests.md'
    - 'State Management': './process/state_mgmt.md'
    - 'Search Optimization': './process/tags.md'
    - 'Code of Conduct': './process/code_of_conduct.md'
- Plans:
    - 'Roadmap': './results/2021_roadmap.md'
    - 'Current Priorities': './results/2021Q1.md'
    - 'Next Priorities': './results/2021Q2.md'
- Activity Status:
    - 'Proposed': './results/proposed.md'
    - 'Approved': './results/approved.md'
    - 'Accepted': './results/accepted.md'
    - 'Standard Development Organizations': './results/sdo.md'
    - 'Adoption': './lists/adoption.md'
- Help:
    - 'FAQ': 'faq.md'
    - 'Contact us': 'contact_us.md'

# Theme configuration
theme:
  name: material
  custom_dir: docs/theme/overrides
  features:
    - navigation.instant
    # - navigation.tabs
  favicon: theme/images/favicon.png
  logo: theme/images/logo.svg
  palette:
    primary: white
    accent: indigo

# Plugin configuration
plugins:
  - search

# Extensions configuration
markdown_extensions:
  - admonition
  - abbr
  - attr_list
  - def_list
  - footnotes
  - meta
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.critic
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:materialx.emoji.twemoji
      emoji_generator: !!python/name:materialx.emoji.to_svg
  - pymdownx.highlight
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      repo_url_shorthand: true
      user: trustoverip
      repo: mkdocs-material
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.snippets:
      check_paths: true
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_div_format
  - pymdownx.tabbed
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

# Additional content
extra:
  title: 'Deliverables Portal'
  lf_url: https://www.linuxfoundation.org/projects
  toip_url: https://trustoverip.org/
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/trustoverip
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/trustoverip
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/trust-over-ip-foundation

# Additional stylesheets
extra_css:
  - theme/stylesheets/main.css

# Additional JavaScript
extra_javascript:
  - https://unpkg.com/mermaid@8.6.4/dist/mermaid.min.js
  - theme/javascripts/main.js