mkdocs.yml 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145
  1. site_name: NetBox Documentation
  2. site_dir: netbox/project-static/docs
  3. site_url: https://netbox.readthedocs.io/
  4. repo_name: netbox-community/netbox
  5. repo_url: https://github.com/netbox-community/netbox
  6. theme:
  7. name: material
  8. icon:
  9. repo: fontawesome/brands/github
  10. palette:
  11. - scheme: default
  12. toggle:
  13. icon: material/lightbulb-outline
  14. name: Switch to Dark Mode
  15. - scheme: slate
  16. toggle:
  17. icon: material/lightbulb
  18. name: Switch to Light Mode
  19. plugins:
  20. - mkdocstrings:
  21. handlers:
  22. python:
  23. setup_commands:
  24. - import os
  25. - import django
  26. - os.environ.setdefault("DJANGO_SETTINGS_MODULE", "netbox.settings")
  27. - django.setup()
  28. rendering:
  29. show_root_heading: true
  30. show_root_full_path: false
  31. show_root_toc_entry: false
  32. extra:
  33. social:
  34. - icon: fontawesome/brands/github
  35. link: https://github.com/netbox-community/netbox
  36. - icon: fontawesome/brands/slack
  37. link: https://netdev.chat/
  38. extra_css:
  39. - extra.css
  40. markdown_extensions:
  41. - admonition
  42. - attr_list
  43. - markdown_include.include:
  44. base_path: 'docs/'
  45. headingOffset: 1
  46. - pymdownx.emoji:
  47. emoji_index: !!python/name:materialx.emoji.twemoji
  48. emoji_generator: !!python/name:materialx.emoji.to_svg
  49. - pymdownx.superfences
  50. - pymdownx.tabbed
  51. nav:
  52. - Introduction: 'index.md'
  53. - Installation:
  54. - Installing NetBox: 'installation/index.md'
  55. - 1. PostgreSQL: 'installation/1-postgresql.md'
  56. - 2. Redis: 'installation/2-redis.md'
  57. - 3. NetBox: 'installation/3-netbox.md'
  58. - 4. Gunicorn: 'installation/4-gunicorn.md'
  59. - 5. HTTP Server: 'installation/5-http-server.md'
  60. - 6. LDAP (Optional): 'installation/6-ldap.md'
  61. - Upgrading NetBox: 'installation/upgrading.md'
  62. - Migrating to systemd: 'installation/migrating-to-systemd.md'
  63. - Configuration:
  64. - Configuring NetBox: 'configuration/index.md'
  65. - Required Settings: 'configuration/required-settings.md'
  66. - Optional Settings: 'configuration/optional-settings.md'
  67. - Dynamic Settings: 'configuration/dynamic-settings.md'
  68. - Remote Authentication: 'configuration/remote-authentication.md'
  69. - Core Functionality:
  70. - IP Address Management: 'core-functionality/ipam.md'
  71. - VLAN Management: 'core-functionality/vlans.md'
  72. - Sites and Racks: 'core-functionality/sites-and-racks.md'
  73. - Devices and Cabling: 'core-functionality/devices.md'
  74. - Device Types: 'core-functionality/device-types.md'
  75. - Modules: 'core-functionality/modules.md'
  76. - Virtualization: 'core-functionality/virtualization.md'
  77. - Service Mapping: 'core-functionality/services.md'
  78. - Circuits: 'core-functionality/circuits.md'
  79. - Wireless: 'core-functionality/wireless.md'
  80. - Power Tracking: 'core-functionality/power.md'
  81. - Tenancy: 'core-functionality/tenancy.md'
  82. - Contacts: 'core-functionality/contacts.md'
  83. - Customization:
  84. - Custom Fields: 'customization/custom-fields.md'
  85. - Custom Validation: 'customization/custom-validation.md'
  86. - Custom Links: 'models/extras/customlink.md'
  87. - Export Templates: 'customization/export-templates.md'
  88. - Custom Scripts: 'customization/custom-scripts.md'
  89. - Reports: 'customization/reports.md'
  90. - Additional Features:
  91. - Change Logging: 'additional-features/change-logging.md'
  92. - Context Data: 'models/extras/configcontext.md'
  93. - Journaling: 'additional-features/journaling.md'
  94. - NAPALM: 'additional-features/napalm.md'
  95. - Prometheus Metrics: 'additional-features/prometheus-metrics.md'
  96. - Tags: 'models/extras/tag.md'
  97. - Webhooks: 'additional-features/webhooks.md'
  98. - Plugins:
  99. - Using Plugins: 'plugins/index.md'
  100. - Developing Plugins:
  101. - Introduction: 'plugins/development/index.md'
  102. - Model Features: 'plugins/development/model-features.md'
  103. - Developing Plugins (Old): 'plugins/development.md'
  104. - Administration:
  105. - Authentication: 'administration/authentication.md'
  106. - Permissions: 'administration/permissions.md'
  107. - Housekeeping: 'administration/housekeeping.md'
  108. - Replicating NetBox: 'administration/replicating-netbox.md'
  109. - NetBox Shell: 'administration/netbox-shell.md'
  110. - REST API:
  111. - Overview: 'rest-api/overview.md'
  112. - Filtering: 'rest-api/filtering.md'
  113. - Authentication: 'rest-api/authentication.md'
  114. - GraphQL API:
  115. - Overview: 'graphql-api/overview.md'
  116. - Reference:
  117. - Conditions: 'reference/conditions.md'
  118. - Development:
  119. - Introduction: 'development/index.md'
  120. - Getting Started: 'development/getting-started.md'
  121. - Style Guide: 'development/style-guide.md'
  122. - Models: 'development/models.md'
  123. - Adding Models: 'development/adding-models.md'
  124. - Extending Models: 'development/extending-models.md'
  125. - Signals: 'development/signals.md'
  126. - Application Registry: 'development/application-registry.md'
  127. - User Preferences: 'development/user-preferences.md'
  128. - Web UI: 'development/web-ui.md'
  129. - Release Checklist: 'development/release-checklist.md'
  130. - Release Notes:
  131. - Summary: 'release-notes/index.md'
  132. - Version 3.1: 'release-notes/version-3.1.md'
  133. - Version 3.0: 'release-notes/version-3.0.md'
  134. - Version 2.11: 'release-notes/version-2.11.md'
  135. - Version 2.10: 'release-notes/version-2.10.md'
  136. - Version 2.9: 'release-notes/version-2.9.md'
  137. - Version 2.8: 'release-notes/version-2.8.md'
  138. - Version 2.7: 'release-notes/version-2.7.md'
  139. - Version 2.6: 'release-notes/version-2.6.md'
  140. - Version 2.5: 'release-notes/version-2.5.md'
  141. - Version 2.4: 'release-notes/version-2.4.md'
  142. - Version 2.3: 'release-notes/version-2.3.md'
  143. - Version 2.2: 'release-notes/version-2.2.md'
  144. - Version 2.1: 'release-notes/version-2.1.md'
  145. - Version 2.0: 'release-notes/version-2.0.md'