github.com/cilium/ebpf@v0.16.0/docs/mkdocs.yml (about)

     1  site_name: "ebpf-go Documentation"
     2  site_description: Pure-Go library to read, modify and load eBPF programs and attach them to various hooks in the Linux kernel.
     3  site_author: Cilium Community
     4  
     5  # Rendered in header.
     6  repo_url: https://github.com/cilium/ebpf
     7  repo_name: cilium/ebpf
     8  edit_uri: edit/main/docs/ebpf/
     9  
    10  # Directory to look for Markdown files within docs/.
    11  docs_dir: ebpf
    12  
    13  theme:
    14    logo: ebpf-go.png
    15    favicon: ebpf-go.png
    16    name: material
    17  
    18    icon:
    19      # GitHub link in the header.
    20      repo: fontawesome/brands/github-alt
    21      # Edit button at the top of each page.
    22      edit: material/pencil-ruler
    23  
    24    features:
    25      # Display sections in the navbar.
    26      - navigation.sections
    27      # Anchor tracking, updates the address bar with the active anchor.
    28      - navigation.tracking
    29      # Use XHR instead of fully reloading the page when navigating around.
    30      - nagivation.instant
    31      # Clipboard button in code blocks.
    32      - content.code.copy
    33      # Enable annotations in code blocks.
    34      - content.code.annotate
    35      # Button to edit page on GitHub.
    36      - content.action.edit
    37  
    38    palette:
    39      # Palette toggle for light mode
    40      - media: "(prefers-color-scheme: light)"
    41        scheme: default
    42        toggle:
    43          icon: material/lightbulb-off
    44          name: Switch to dark mode
    45  
    46      # Palette toggle for dark mode
    47      - media: "(prefers-color-scheme: dark)"
    48        scheme: slate
    49        toggle:
    50          icon: material/lightbulb-on
    51          name: Switch to light mode
    52  
    53    # Template overrides.
    54    custom_dir: overrides
    55  
    56  nav:
    57    - 'Home': index.md
    58    - 'Guides':
    59      - 'Getting Started': guides/getting-started.md
    60      - 'Portable eBPF': guides/portable-ebpf.md
    61    - 'Concepts':
    62      - 'Loading eBPF Programs': concepts/loader.md
    63      - 'Resource Limits': concepts/rlimit.md
    64      - 'Section Naming': concepts/section-naming.md
    65      - 'Feature Detection': concepts/features.md
    66      - 'Object Lifecycle': concepts/object-lifecycle.md
    67    - 'Contributing':
    68      - contributing/index.md
    69      - contributing/architecture.md
    70      - contributing/new-feature.md
    71      - contributing/new-example.md
    72    - 'Users': users.md
    73    - 'Go Reference': https://pkg.go.dev/github.com/cilium/ebpf
    74    - 'GitHub':
    75      - 'Repository': https://github.com/cilium/ebpf
    76      - 'Issue Tracker': https://github.com/cilium/ebpf/issues
    77      - 'Discussions': https://github.com/cilium/ebpf/discussions
    78    - 'About': about.md
    79  
    80  extra:
    81    social:
    82      - icon: fontawesome/brands/github
    83        link: https://github.com/cilium/ebpf
    84  
    85  extra_css:
    86    - stylesheets/extra.css
    87  
    88  watch:
    89  - examples/
    90  - includes/
    91  - overrides/
    92  - macros.py
    93  
    94  plugins:
    95    - search
    96    - macros:
    97        # This opens macros.py in docs/.
    98        module_name: macros
    99        # Make the mkdocs build fail if any errors occur.
   100        # Otherwise, any errors would be rendered to the build output.
   101        on_error_fail: true
   102        include_yaml:
   103          - vars.yml
   104    # Updated/authors displayed in footer.
   105    # Layout is customized in overrides/partials/source-file.html.
   106    - git-revision-date-localized:
   107        type: timeago
   108    - git-authors:
   109        show_email_address: false
   110        authorship_threshold_percent: 10
   111        exclude:
   112          - index.md
   113  
   114  # Enable syntax highlighting in mkdocs-material.
   115  markdown_extensions:
   116    # Automatic tooltips for abbreviations/glossary.
   117    - abbr
   118    # Setting attributes on code fences (e.g. ``` go linenums='1')
   119    - attr_list
   120    # Special content blocks like '!!! note'
   121    - admonition
   122    # Definition lists using indented descriptions
   123    - def_list
   124    - footnotes
   125    # Collapsible admonitions
   126    - pymdownx.details
   127    # Syntax highlighting in code blocks
   128    - pymdownx.highlight:
   129        anchor_linenums: true
   130    - pymdownx.inlinehilite
   131    # Glossary
   132    - pymdownx.snippets:
   133        auto_append:
   134          - includes/glossary.md
   135    # Superfences enables nested and tabbed code blocks and Mermaid support
   136    - pymdownx.superfences:
   137        custom_fences:
   138          - name: mermaid
   139            class: mermaid
   140            format: !!python/name:pymdownx.superfences.fence_code_format
   141    # Content tabs for code snippets, checklists, etc.
   142    - pymdownx.tabbed:
   143        alternate_style: true
   144    # Emoji and icons like :fontawesome-brands-golang:
   145    - pymdownx.emoji:
   146        emoji_index: !!python/name:material.extensions.emoji.twemoji
   147        emoji_generator: !!python/name:material.extensions.emoji.to_svg
   148        options:
   149          custom_icons:
   150            - overrides/.icons
   151    # Table of Contents
   152    - toc:
   153        permalink: true