mirror of
https://github.com/inventree/InvenTree.git
synced 2025-04-27 11:06:44 +00:00
6b08e45eac
* Refactor / reognaize docs structure * Refactor plugin docs structure * More refactoring / cleanup * Update build images * Gallery updates * Order images * Update part docs * Settings images * Stock images * Reitntroduce gallery * Add custom icon macro * Update icons * Cleanup * Fix link * Fix internal links * Revert some page moves * Fix links * Fix links
321 lines
9.8 KiB
YAML
321 lines
9.8 KiB
YAML
# Project
|
|
site_url: https://inventree.readthedocs.io
|
|
site_name: InvenTree Documentation
|
|
site_description: InvenTree - Open Source Inventory Management
|
|
site_author: InvenTree
|
|
|
|
# Repository
|
|
repo_url: https://github.com/inventree/inventree
|
|
repo_name: inventree/inventree
|
|
|
|
|
|
# Theme
|
|
theme:
|
|
name: material
|
|
font:
|
|
text: Roboto
|
|
custom_dir: _includes/overrides
|
|
palette:
|
|
- media: "(prefers-color-scheme: light)"
|
|
scheme: default
|
|
primary: blue
|
|
accent: light blue
|
|
toggle:
|
|
icon: material/toggle-switch
|
|
name: Switch to dark mode
|
|
- media: "(prefers-color-scheme: dark)"
|
|
scheme: slate
|
|
primary: blue
|
|
accent: light blue
|
|
toggle:
|
|
icon: material/toggle-switch-off-outline
|
|
name: Switch to light mode
|
|
logo: assets/logo.png
|
|
favicon: assets/favicon.ico
|
|
icon:
|
|
repo: fontawesome/brands/github
|
|
features:
|
|
- content.code.copy
|
|
- header.autohide
|
|
- navigation.expand
|
|
- navigation.footer
|
|
- navigation.indexes
|
|
- navigation.instant
|
|
# - navigation.sections
|
|
- navigation.tracking
|
|
- navigation.tabs
|
|
- navigation.tabs.sticky
|
|
- navigation.top
|
|
- search.highlight
|
|
- toc.autohide
|
|
- toc.follow
|
|
edit_uri: "" # Disable "Edit" button
|
|
extra_css:
|
|
- stylesheets/brands.css
|
|
- stylesheets/regular.css
|
|
- stylesheets/solid.css
|
|
- stylesheets/bootstrap.css
|
|
- stylesheets/splide.min.css
|
|
- stylesheets/extra.css
|
|
- stylesheets/neoteroi-mkdocs.css
|
|
- https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@3.31.0/dist/tabler-icons.min.css
|
|
extra_javascript:
|
|
- javascripts/extra.js
|
|
- javascripts/fontawesome.js
|
|
- javascripts/brands.js
|
|
- javascripts/regular.js
|
|
- javascripts/solid.js
|
|
- javascripts/splide.min.js
|
|
- https://code.jquery.com/jquery-3.6.0.js
|
|
- https://maxcdn.bootstrapcdn.com/bootstrap/3.4.1/js/bootstrap.js
|
|
|
|
# Navigation
|
|
nav:
|
|
- InvenTree:
|
|
- InvenTree: index.md
|
|
- FAQ: faq.md
|
|
- Demo: demo.md
|
|
- Release Notes: releases/release_notes.md
|
|
- Core Concepts:
|
|
- Terminology: concepts/terminology.md
|
|
- Threat Model: concepts/threat_model.md
|
|
- Physical Units: concepts/units.md
|
|
- Companies: concepts/company.md
|
|
- Custom States: concepts/custom_states.md
|
|
- Pricing: concepts/pricing.md
|
|
- Project Codes: concepts/project_codes.md
|
|
- Barcodes:
|
|
- Barcode Support: barcodes/index.md
|
|
- Internal Barcodes: barcodes/internal.md
|
|
- External Barcodes: barcodes/external.md
|
|
- Custom Barcodes: barcodes/custom.md
|
|
- Development:
|
|
- Contributing: develop/contributing.md
|
|
- Devcontainer: develop/devcontainer.md
|
|
- React Frontend: develop/react-frontend.md
|
|
- Mobile App:
|
|
- Mobile App: app/index.md
|
|
- Connect: app/connect.md
|
|
- Navigation: app/navigation.md
|
|
- Search: app/search.md
|
|
- Barcodes: app/barcode.md
|
|
- Parts: app/part.md
|
|
- Stock: app/stock.md
|
|
- Purchase Orders: app/po.md
|
|
- Sales Orders: app/so.md
|
|
- Settings: app/settings.md
|
|
- Privacy: app/privacy.md
|
|
- Translation: app/translation.md
|
|
- Suggestions: app/issues.md
|
|
- InvenTree API:
|
|
- Overview: api/index.md
|
|
- API Schema: api/schema.md
|
|
- Model Metadata: api/metadata.md
|
|
- Download Data: api/download.md
|
|
- Bulk Delete: api/bulk_delete.md
|
|
- Interactive API: api/browse.md
|
|
- Python Interface:
|
|
- Overview: api/python/index.md
|
|
- Currency Support: api/python/currency.md
|
|
- Examples: api/python/examples.md
|
|
- Project Details:
|
|
- Governance: project/governance.md
|
|
- Project Security: security.md
|
|
- Resources: project/resources.md
|
|
- Privacy: privacy.md
|
|
- Install:
|
|
- Introduction: start/index.md
|
|
- Processes: start/processes.md
|
|
- Configuration: start/config.md
|
|
- Docker:
|
|
- Introduction: start/docker.md
|
|
- Installation: start/docker_install.md
|
|
- Bare Metal:
|
|
- Introduction: start/install.md
|
|
- Installer: start/installer.md
|
|
- Production: start/bare_prod.md
|
|
- Development: start/bare_dev.md
|
|
- User Accounts: start/accounts.md
|
|
- Data Backup: start/backup.md
|
|
- Invoke: start/invoke.md
|
|
- Migrating Data: start/migrate.md
|
|
- Advanced Topics: start/advanced.md
|
|
- Parts:
|
|
- Parts: part/index.md
|
|
- Creating Parts: part/create.md
|
|
- Part Views: part/views.md
|
|
- Tracking: part/trackable.md
|
|
- Parameters: part/parameter.md
|
|
- Revisions: part/revision.md
|
|
- Templates: part/template.md
|
|
- Tests: part/test.md
|
|
- Pricing: part/pricing.md
|
|
- Scheduling: part/scheduling.md
|
|
- Stocktake: part/stocktake.md
|
|
- Notifications: part/notification.md
|
|
- Stock:
|
|
- Stock Items: stock/index.md
|
|
- Stock Status: stock/status.md
|
|
- Stock Tracking: stock/tracking.md
|
|
- Adjusting Stock: stock/adjust.md
|
|
- Stock Expiry: stock/expiry.md
|
|
- Stock Ownership: stock/owner.md
|
|
- Test Results: stock/test.md
|
|
- Manufacturing:
|
|
- Manufacturing: manufacturing/index.md
|
|
- Bill of Materials: manufacturing/bom.md
|
|
- Build Orders: manufacturing/build.md
|
|
- Build Outputs: manufacturing/output.md
|
|
- Allocating Stock: manufacturing/allocate.md
|
|
- Example Build Order: manufacturing/example.md
|
|
- Purchasing:
|
|
- Purchasing: purchasing/index.md
|
|
- Suppliers: purchasing/supplier.md
|
|
- Manufacturers: purchasing/manufacturer.md
|
|
- Purchase Orders: purchasing/purchase_order.md
|
|
- Sales:
|
|
- Sales: sales/index.md
|
|
- Customers: sales/customer.md
|
|
- Sales Orders: sales/sales_order.md
|
|
- Return Orders: sales/return_order.md
|
|
- Report:
|
|
- Templates: report/index.md
|
|
- Template Rendering: report/weasyprint.md
|
|
- Template Editor: report/template_editor.md
|
|
- Reports: report/report.md
|
|
- Labels: report/labels.md
|
|
- Context Variables: report/context_variables.md
|
|
- Helper Functions: report/helpers.md
|
|
- Barcodes: report/barcodes.md
|
|
- Sample Templates: report/samples.md
|
|
- Administration:
|
|
- Global Settings: settings/global.md
|
|
- User Settings: settings/user.md
|
|
- Reference Patterns: settings/reference.md
|
|
- Admin Interface: settings/admin.md
|
|
- Setup:
|
|
- User Permissions: settings/permissions.md
|
|
- Single Sign on: settings/SSO.md
|
|
- Multi Factor Authentication: settings/MFA.md
|
|
- Email: settings/email.md
|
|
- Experimental Features: settings/experimental.md
|
|
- Export Data: settings/export.md
|
|
- Import Data: settings/import.md
|
|
- Operations:
|
|
- Background Tasks: settings/tasks.md
|
|
- Error Logs: settings/logs.md
|
|
- Error Codes: settings/error_codes.md
|
|
- Plugins:
|
|
- Overview: plugins/index.md
|
|
- Installation: plugins/install.md
|
|
- Developing a Plugin: plugins/how_to.md
|
|
- Model Metadata: plugins/metadata.md
|
|
- Tags: plugins/tags.md
|
|
- Unit Test: plugins/test.md
|
|
- Plugin Mixins:
|
|
- Action Mixin: plugins/mixins/action.md
|
|
- API Mixin: plugins/mixins/api.md
|
|
- App Mixin: plugins/mixins/app.md
|
|
- Barcode Mixin: plugins/mixins/barcode.md
|
|
- Currency Mixin: plugins/mixins/currency.md
|
|
- Event Mixin: plugins/mixins/event.md
|
|
- Data Export Mixin: plugins/mixins/export.md
|
|
- Icon Pack Mixin: plugins/mixins/icon.md
|
|
- Label Printing Mixin: plugins/mixins/label.md
|
|
- Locate Mixin: plugins/mixins/locate.md
|
|
- Navigation Mixin: plugins/mixins/navigation.md
|
|
- Report Mixin: plugins/mixins/report.md
|
|
- Schedule Mixin: plugins/mixins/schedule.md
|
|
- Settings Mixin: plugins/mixins/settings.md
|
|
- URL Mixin: plugins/mixins/urls.md
|
|
- User Interface Mixin: plugins/mixins/ui.md
|
|
- Validation Mixin: plugins/mixins/validation.md
|
|
- Machines:
|
|
- Overview: plugins/machines/overview.md
|
|
- Label Printer: plugins/machines/label_printer.md
|
|
- Third-Party: plugins/integrate.md
|
|
|
|
# Plugins
|
|
plugins:
|
|
- neoteroi.mkdocsoad:
|
|
use_pymdownx: true
|
|
- include-markdown:
|
|
opening_tag: "{!"
|
|
closing_tag: "!}"
|
|
- search
|
|
- git-revision-date-localized
|
|
- mkdocs-simple-hooks:
|
|
hooks:
|
|
on_config: "docs.docs.hooks:on_config"
|
|
- macros:
|
|
include_dir: docs/_includes
|
|
module_name: main
|
|
- mkdocstrings:
|
|
default_handler: python
|
|
handlers:
|
|
python:
|
|
paths:
|
|
- ../src/backend/InvenTree
|
|
options:
|
|
show_symbol_type_heading: true
|
|
show_symbol_type_toc: true
|
|
show_root_heading: false
|
|
show_root_toc_entry: false
|
|
|
|
# Extensions
|
|
markdown_extensions:
|
|
- admonition
|
|
- attr_list
|
|
- meta
|
|
- pymdownx.details
|
|
- pymdownx.highlight
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.superfences:
|
|
custom_fences:
|
|
- name: mermaid
|
|
class: mermaid
|
|
# format: !!python/name:pymdownx.superfences.fence_code_format
|
|
# - pymdownx.emoji:
|
|
# emoji_index: !!python/name:materialx.emoji.twemoji
|
|
# emoji_generator: !!python/name:materialx.emoji.to_svg
|
|
- toc:
|
|
permalink: true
|
|
|
|
# Global Variables
|
|
extra:
|
|
static_folder_source: ./src/backend/InvenTree/InvenTree/static/
|
|
static_folder_local_default: ./inventree_static/
|
|
|
|
# Site Analytics
|
|
# See https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/
|
|
# analytics:
|
|
# provider: google
|
|
# property: UA-143467500-1
|
|
|
|
min_python_version: 3.9
|
|
min_invoke_version: 2.0.0
|
|
django_version: 4.2
|
|
docker_postgres_version: 16
|
|
|
|
version:
|
|
default: stable
|
|
provider: mike
|
|
|
|
social:
|
|
- icon: fontawesome/brands/github
|
|
link: https://github.com/inventree/inventree
|
|
name: InvenTree on GitHub
|
|
- icon: fontawesome/brands/twitter
|
|
link: https://twitter.com/inventreedb
|
|
name: InvenTree on Twitter
|
|
- icon: fontawesome/brands/docker
|
|
link: https://hub.docker.com/r/inventree/inventree
|
|
name: InvenTree on Docker
|
|
- icon: fontawesome/brands/reddit
|
|
name: InvenTree on Reddit
|
|
link: https://reddit.com/r/inventree
|
|
|
|
use_directory_urls: true
|
|
strict: true
|