Docs refactor (#9545)

* 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

docs/_includes/overrides/404.html

@@ -20,8 +20,7 @@
   <div class="md-grid md-typeset">
     <div class="mdx-hero"></div>
       <h1>
-        <span class='fas fa-search'></span>
-        Page not found
+        <i class="ti ti-search"></i> Page not found
       </h1>
   </div>
 </section>

docs/_includes/overrides/home.html

@@ -7,7 +7,7 @@
 
 {% block content %}
 
-{{ page.content }}
+
 
 <style>
     h1 {
@@ -15,6 +15,8 @@
     }
 </style>
 
+<h2 id="intuitive-inventory-management">InvenTree - Intuitive Inventory Management</h2>
+
 <!-- Hero for landing page -->
 <section class="mdx-container">
     <div class="md-grid md-typeset">
@@ -24,24 +26,24 @@
         <div class="mdx-hero__content">
 
           <a href="https://inventree.org" title="InvenTree Website" class="md-button">
-            <span class='fas fa-globe'></span> Website
+            <i class='ti ti-world'></i> Website
           </a>
 
-          <a href="start/intro" title="Install InvenTree" class="md-button">
-            <span class='fas fa-server'></span> Install
+          <a href="start" title="Install InvenTree" class="md-button">
+            <i class='ti ti-server-bolt'></i> Install
           </a>
-          <a href="app/app" title="InvenTree mobile app" class="md-button">
-            <span class='fas fa-mobile-alt'></span> Mobile App
+          <a href="app" title="InvenTree mobile app" class="md-button">
+            <i class='ti ti-device-mobile'></i> Mobile App
           </a>
           <a href="https://crowdin.com/project/inventree" title="Help translate InvenTree" class="md-button">
-            <span class='fas fa-language'></span> Translate
+            <i class='ti ti-language'></i> Translate
           </a>
           <a href="https://github.com/inventree/inventree" title="Explore InvenTree source code" class="md-button md-button">
-            <span class='fab fa-github'></span> Source Code
+            <i class='ti ti-code-circle'></i> Source Code
           </a>
         </div>
       </div>
     </div>
   </section>
-
+  {{ page.content }}
 {% endblock content %}

docs/_includes/release_table.html

@@ -4,10 +4,10 @@
         <table>
             <thead>
                 <tr>
-                    <th><span class='fas fa-clipboard-list'></span> Release</th>
-                    <th><span class='fas fa-calendar-alt'></span> Date</th>
-                    <th><span class='fab fa-github'></span> GitHub</th>
-                    <th><span class='fab fa-docker'></span> Docker</th>
+                    <th>{{ icon("clipboard") }}</span> Release</th>
+                    <th>{{ icon("calendar") }} Date</th>
+                    <th>{{ icon("brand-github") }} GitHub</th>
+                    <th>{{ icon("brand-docker") }} Docker</th>
                 </tr>
             </thead>
             <tbody>

docs/docs/api/browse.md

@@ -4,7 +4,7 @@ title: Interactive API
 
 ## Interactive API
 
-If the server is running in [Debug Mode](../start/intro.md#debug-mode) then an interactive version of the API is available using a browser.
+If the server is running in [Debug Mode](../start/index.md#debug-mode) then an interactive version of the API is available using a browser.
 
 !!! info "Debug Mode"
     This interactive API is only available when running the server in debug mode

docs/docs/api/bulk_delete.md

@@ -6,7 +6,7 @@ title: Bulk Deletion
 
 While deleting items individually via the API is supported, it can prove inefficient (time consuming) when multiple items are to be deleted sequentially.
 
-For example, if the user wishes to delete a large number items (such as lines from a [Bill of Materials](../build/bom.md)), these items are deleted sequentially, with each `DELETE` separate request requiring network transfer, database access, cleanup, etc.
+For example, if the user wishes to delete a large number items (such as lines from a [Bill of Materials](../manufacturing/bom.md)), these items are deleted sequentially, with each `DELETE` separate request requiring network transfer, database access, cleanup, etc.
 
 A much more efficient approach is to allow for "bulk deletion" of multiple database items in a single transaction. This means that only one network request is required, and only a single database access request.
 

docs/docs/api/metadata.md

@@ -4,7 +4,7 @@ title: Model Metadata
 
 ## Model Metadata
 
-The API is *self describing* in that it provides metadata about the various fields available at any given endpoint. External applications (such as the [python interface](../api/python/python.md)) can introspect the API to determine information about the model fields.
+The API is *self describing* in that it provides metadata about the various fields available at any given endpoint. External applications (such as the [python interface](../api/python/index.md)) can introspect the API to determine information about the model fields.
 
 !!! tip "API Forms"
     The various forms implemented in the InvenTree web interface make heavy use of this metadata feature
@@ -13,7 +13,7 @@ The API is *self describing* in that it provides metadata about the various fiel
 
 To request metadata about a particular API endpoint, simply perform an `OPTIONS` method request against the API URL.
 
-For example, to view the metadata available for creating a new [Part Category](../part/part.md#part-category), an `OPTIONS` request to `/api/part/category/` yields:
+For example, to view the metadata available for creating a new [Part Category](../part/index.md#part-category), an `OPTIONS` request to `/api/part/category/` yields:
 
 {% with id="api_cat_options", url="api/api_category_options.png", description="Part category options" %}
 {% include 'img.html' %}

docs/docs/api/python/currency.md

@@ -6,7 +6,7 @@ title: Python Currency Support
 
 InvenTree provides native support for multiple currencies, which can mean that data require conversion between these currencies, at defined exchange rates.
 
-The InvenTree server maintains a set of exchange rates, which are updated periodically. These exchange rates are available via the [InvenTree API](../api.md), and can be used by the Python bindings.
+The InvenTree server maintains a set of exchange rates, which are updated periodically. These exchange rates are available via the [InvenTree API](../index.md), and can be used by the Python bindings.
 
 ### CurrencyManager Class
 

docs/docs/api/python/examples.md

@@ -67,7 +67,7 @@ print("Minimum stock:", part.minimum_stock)
 
 ### Adding Parameters
 
-Each [part](../../part/part.md) can have multiple [parameters](../../part/parameter.md). For the example of the sofa (above) *length* and *weight* make sense. Each parameter has a parameter template that combines the parameter name with a unit. So we first have to create the parameter templates and afterwards add the parameter values to the sofa.
+Each [part](../../part/index.md) can have multiple [parameters](../../part/parameter.md). For the example of the sofa (above) *length* and *weight* make sense. Each parameter has a parameter template that combines the parameter name with a unit. So we first have to create the parameter templates and afterwards add the parameter values to the sofa.
 
 ```python
 from inventree.part import Parameter
@@ -190,7 +190,7 @@ item.transferStock(loc, quantity=50)
 
 ### Delete a Part
 
-To delete a [Part instance](../../part/part.md), first in needs to be marked as *inactive* (otherwise it will throw an error):
+To delete a [Part instance](../../part/index.md), first in needs to be marked as *inactive* (otherwise it will throw an error):
 
 ```python
 from inventree.part import Part

docs/docs/api/python/index.md

@@ -83,7 +83,7 @@ category = PartCategory(api, 10)
 
 #### Multiple Items
 
-Database items can be queried by using the `list` method for the given class. Note that arbitrary filter parameters can be applied (as specified by the [InvenTree API](../api.md)) to filter the returned results.
+Database items can be queried by using the `list` method for the given class. Note that arbitrary filter parameters can be applied (as specified by the [InvenTree API](../index.md)) to filter the returned results.
 
 ```python
 from inventree.part import Part

docs/docs/api/schema.md

@@ -7,7 +7,7 @@ The API schema as documented below is generated using the [drf-spectactular](htt
 
 ## API Version
 
-This documentation is for API version: `315`
+This documentation is for API version: `339`
 
 !!! tip "API Schema History"
     We track API schema changes, and provide a snapshot of each API schema version in the [API schema repository](https://github.com/inventree/schema/).

docs/docs/app/connect.md

@@ -24,7 +24,7 @@ Press on the server icon to navigate to the server selection view:
 !!! success "Server Profiles"
     The app supports multiple server profiles, providing simple switching between different InvenTree servers and/or account profiles.
 
-Press the <span class='fas fa-plus-circle blue'></span> button in the bottom-right corner of the screen to create a new server profile.
+Press the {{ icon("circle-plus", color="blue") }} button in the bottom-right corner of the screen to create a new server profile.
 
 {% with id="add_profile", url="app/add_server_profile.png", maxheight="240px", description="Add server" %}
 {% include 'img.html' %}
@@ -45,7 +45,7 @@ Once the server profile is created, you need to connect to the server. Simply sh
 
 Alternatively, long press on the server profile to activate the context menu, then select *Connect to Server*.
 
-When the app successfully connects to the server, a success message is briefly displayed at the bottom of the screen. A green <span class='fas fa-check-circle green'></span> icon next to the server profile indicate that the profile is currently *selected* and also the connection was successful.
+When the app successfully connects to the server, a success message is briefly displayed at the bottom of the screen. A green {{ icon("circle-check", color="green") }} icon next to the server profile indicate that the profile is currently *selected* and also the connection was successful.
 
 {% with id="connected", url="app/connected.png", maxheight="240px", description="Connected to server" %}
 {% include 'img.html' %}
@@ -53,7 +53,7 @@ When the app successfully connects to the server, a success message is briefly d
 
 ### Connection Failure
 
-If (for whatever reason) the app does not successfully connect to the InvenTree server, a failure message is displayed, and a red <span class='fas fa-times-circle red'></span> icon is displayed next to the server profile.
+If (for whatever reason) the app does not successfully connect to the InvenTree server, a failure message is displayed, and a red {{ icon("circle-x", color="red") }} icon is displayed next to the server profile.
 
 {% with id="failed", url="app/unauthorized.png", maxheight="240px", description="Connection failure" %}
 {% include 'img.html' %}

docs/docs/app/index.md

@@ -8,7 +8,7 @@ title: InvenTree Mobile App
 
 -----
 
-The InvenTree Mobile App brings stock control to your pocket. Integrating seamlessly with the [InvenTree API](../api/api.md), the app provides immediate access to inventory data without requiring physical access to a computer.
+The InvenTree Mobile App brings stock control to your pocket. Integrating seamlessly with the [InvenTree API](../api/index.md), the app provides immediate access to inventory data without requiring physical access to a computer.
 
 Native barcode support provides a multitude of context-sensitive stock control actions, allowing streamlined inventory management at your fingertips. The app has been optimized for speed, providing instant access to stock knowledge and handy on-site functionality.
 

docs/docs/app/navigation.md

@@ -31,7 +31,7 @@ The *Global Action* buttons are visible on most screens, displayed in the bottom
 
 ### Open Drawer Menu
 
-The <span class='fas fa-list'></span> action opens the *Drawer Menu*, which is a quick-access menu for global navigation:
+The {{ icon("list") }} action opens the *Drawer Menu*, which is a quick-access menu for global navigation:
 
 {% with id="drawer", url="app/drawer.png", maxheight="240px", description="Open drawer menu" %}
 {% include 'img.html' %}
@@ -44,11 +44,11 @@ The *Drawer Menu* can be accessed in the following ways:
 
 ### Search
 
-The <span class='fas fa-search'></span> action opens the [Search](./search.md) screen
+The {{ icon("search", title="Search") }} action opens the [Search](./search.md) screen
 
 ### Scan Barcode
 
-The <span class='fas fa-qrcode'></span> action opens the [barcode scan](./barcode.md#global-scan) window, which allows quick access to the barcode scanning functionality.
+The {{ icon("barcode", title="Scan") }} action opens the [barcode scan](./barcode.md#global-scan) window, which allows quick access to the barcode scanning functionality.
 
 ## Context Actions
 

docs/docs/app/stock.md

@@ -152,7 +152,7 @@ This barcode can then be used to track the stock item.
 
 #### Print Label
 
-If the server supports [label printing plugins](../extend/plugins/label.md), then an option to print a label for the selected stock item:
+If the server supports [label printing plugins](../plugins/mixins/label.md), then an option to print a label for the selected stock item:
 
 {% with id="label_print_1", url="stock_print_label_1.png", description="Print label via plugin" %}
 {% include 'app_img.html' %}