site_name: RenderCV
site_description: LaTeX CV generator engine from a YAML input file.
site_author: Sina Atalay
copyright: Copyright © 2023 Sina Atalay
site_url: https://docs.rendercv.com
repo_url: https://github.com/sinaatalay/rendercv
repo_name: sinaatalay/rendercv
edit_uri: edit/main/docs/

theme:
  name: material
  language: en
  custom_dir: docs/overrides
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/lightbulb-outline
        name: "Switch to dark mode"
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: indigo
      accent: indigo
      toggle:
        icon: material/lightbulb
        name: "Switch to light mode"

  font:
    text: Roboto
    code: Roboto Mono

  features:
    - content.code.copy # the copy-to-clipboard buttons for code blocks
    - content.action.view # view source button for pages
    - navigation.footer # the previous and next buttons in the footer
    - navigation.indexes # allow mother pages to have their own index pages
    # - navigation.tabs # render classical type of navbar at top
    - navigation.instant # instant navigation for faster page loads
    - navigation.instant.prefetch # prefetch pages for instant navigation
    - navigation.instant.progress # show progress bar for instant navigation
    - navigation.top # back to top button
    - search.highlight # highlight search results after going to a page
    - search.suggest # show search suggestions while typing
    - search.share # share search results with others
    - toc.follow # if toc sidebar doesn't fit, scroll to the active heading
    - content.code.annotate # allow annotations in code blocks

nav:
  - Overview: index.md
  - User Guide:
      - User Guide: user_guide/index.md
      - Structure of the YAML input file: user_guide/structure_of_the_yaml_input_file.md
      - FAQ: user_guide/faq.md
  - Developer Guide:
      - Developer Guide: developer_guide/index.md
      - Writing Documentation: developer_guide/writing_documentation.md
      - Testing: developer_guide/testing.md
      - FAQ: developer_guide/faq.md
  - Reference:
      - Reference: reference/index.md
      - cli.py: reference/cli.md
      - data_models.py: reference/data_models.md
      - renderer.py: reference/renderer.md
      - themes:
          - themes: reference/themes/index.md
          - classic: reference/themes/classic.md
          - engineeringresumes: reference/themes/engineeringresumes.md
          - sb2nov: reference/themes/sb2nov.md
          - moderncv: reference/themes/moderncv.md
  - Changelog: changelog.md

markdown_extensions:
  # see https://facelessuser.github.io/pymdown-extensions/extensions/inlinehilite/ for more pymdownx info
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.extra:
      pymdownx.superfences:
        custom_fences:
          - name: mermaid
            class: mermaid
            format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed: # content tabs
      alternate_style: true
  - toc:
      permalink: true
      title: Page contents
  - admonition # blocks like note, warning, tip, etc.

plugins:
  - search
  - offline
  - macros: # mkdocs-macros-plugin
      module_name: docs/update_rendercv_files
  - mkdocstrings:
      handlers:
        python:
          paths:
            - rendercv
          options:
            members_order: source
            show_bases: true
            docstring_section_style: list
            merge_init_into_class: true
            show_docstring_attributes: true
            docstring_style: google

extra_javascript:
  - assets/javascripts/katex.js
  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.js
  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/contrib/auto-render.min.js

extra_css:
  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.css

extra:
  analytics:
    provider: google
    property: G-7D7Y8D5Q4W