mkdocs.yml

site_name: Docling
site_url: https://ds4sd.github.io/docling/
repo_name: DS4SD/docling
repo_url: https://github.com/DS4SD/docling

theme:
  name: material
  custom_dir: docs/overrides
  palette:
    # Palette toggle for automatic mode
    - media: "(prefers-color-scheme)"
      scheme: default
      primary: black
      toggle:
        icon: material/brightness-auto
        name: Switch to light mode

    # Palette toggle for light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: black
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode

    # Palette toggle for dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: black
      toggle:
        icon: material/brightness-4
        name: Switch to system preference

  logo: assets/logo.png
  favicon: assets/logo.png
  features:
    - content.tabs.link
    - content.code.annotate
    - content.code.copy
    - announce.dismiss
    - navigation.footer
    - navigation.tabs
    - navigation.indexes  # <= if set, each "section" can have its own page, if index.md is used
    - navigation.instant
    - navigation.instant.prefetch
    # - navigation.instant.preview
    - navigation.instant.progress
    - navigation.path
    - navigation.sections  # <=
    - navigation.top
    - navigation.tracking
    - search.suggest
    - toc.follow
nav:
  - Home:
    - "Docling": index.md
    - Installation: installation.md
    - Usage: usage.md
    - Supported formats: supported_formats.md
    - FAQ: faq.md
    - Docling v2: v2.md
  - Concepts:
    - Concepts: concepts/index.md
    - Architecture: concepts/architecture.md
    - Docling Document: concepts/docling_document.md
    - Chunking: concepts/chunking.md
  - Examples:
    - Examples: examples/index.md
    - 🔀 Conversion:
      - "Simple conversion": examples/minimal.py
      - "Custom conversion": examples/custom_convert.py
      - "Batch conversion": examples/batch_convert.py
      - "Multi-format conversion": examples/run_with_formats.py
      - "Figure export": examples/export_figures.py
      - "Figure enrichment": examples/develop_picture_enrichment.py
      - "Table export": examples/export_tables.py
      - "Multimodal export": examples/export_multimodal.py
      - "Annotate picture with local vlm": examples/pictures_description.py
      - "Annotate picture with remote vlm": examples/pictures_description_api.py
      - "Force full page OCR": examples/full_page_ocr.py
      - "Automatic OCR language detection with tesseract": examples/tesseract_lang_detection.py
      - "RapidOCR with custom OCR models": examples/rapidocr_with_custom_models.py
      - "Accelerator options": examples/run_with_accelerator.py
      - "Simple translation": examples/translate.py
      - examples/backend_csv.ipynb
      - examples/backend_xml_rag.ipynb
    - ✂️ Chunking:
      - examples/hybrid_chunking.ipynb
    - 🤖 RAG with AI dev frameworks:
      - examples/rag_haystack.ipynb
      - examples/rag_langchain.ipynb
      - examples/rag_llamaindex.ipynb
    - 🗂️ More examples:
      - examples/rag_weaviate.ipynb
      - RAG with Granite [↗]: https://github.com/ibm-granite-community/granite-snack-cookbook/blob/main/recipes/RAG/Granite_Docling_RAG.ipynb
      - examples/rag_azuresearch.ipynb
      - examples/retrieval_qdrant.ipynb
  - Integrations:
    - Integrations: integrations/index.md
    - 🤖 Agentic / AI dev frameworks:
      - "Bee Agent Framework": integrations/bee.md
      - "Crew AI": integrations/crewai.md
      - "Haystack": integrations/haystack.md
      - "LangChain": integrations/langchain.md
      - "LlamaIndex": integrations/llamaindex.md
      - "txtai": integrations/txtai.md
    - ⭐️ Featured:
      - "Data Prep Kit": integrations/data_prep_kit.md
      - "InstructLab": integrations/instructlab.md
      - "NVIDIA": integrations/nvidia.md
      - "Prodigy": integrations/prodigy.md
      - "RHEL AI": integrations/rhel_ai.md
      - "spaCy": integrations/spacy.md
    - 🗂️ More integrations:
      - "Cloudera": integrations/cloudera.md
      - "DocETL": integrations/docetl.md
      - "Kotaemon": integrations/kotaemon.md
      - "OpenContracts": integrations/opencontracts.md
      - "Vectara": integrations/vectara.md
  - Reference:
    - Python API:
      - Document Converter: reference/document_converter.md
      - Pipeline options: reference/pipeline_options.md
      - Docling Document: reference/docling_document.md
    - CLI:
      - CLI reference: reference/cli.md

markdown_extensions:
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
      slugify: !!python/object/apply:pymdownx.slugs.slugify
        kwds:
          case: lower
  - admonition
  - pymdownx.details
  - attr_list
  - mkdocs-click
plugins:
  - search
  - mkdocs-jupyter
  - mkdocstrings:
      default_handler: python
      options:
        extensions:
          - griffe_pydantic:
              schema: true
        preload_modules:
          - docling
          - docling_core

extra_css:
  - stylesheets/extra.css