diff --git a/README.md b/README.md index 0a85eb7..a628325 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,24 @@ Once the server is running, it will monitor the documentation files for any chan Refer to the [reference documentation](https://squidfunk.github.io/mkdocs-material/reference/admonitions/) to customize the admonition block to the use-case (eg. warning, missing, info, etc.). +### Internal Links + +Links to internal documentation pages **must** use relative pathing, otherwise the link will be broken by the readthedocs URL formatting. + +For example, to link to the page `/part/views` from `/stock/stocktake`, the link must be formed as follows: + +``` +Click [here](../../part/views) +``` + +*Formatting the link as follows:* + +``` +Click [here](/part/views) +``` + +*will result in a broken link.* + ### Images Images are served from the `./docs/assets/images` folder and can be added as follow: diff --git a/docs/admin/admin.md b/docs/admin/admin.md index fd48632..e63f11e 100644 --- a/docs/admin/admin.md +++ b/docs/admin/admin.md @@ -9,7 +9,7 @@ Users which have *staff* privileges have access to an Admin interface which prov !!! warning "Caution" Admin users should exercise extreme care when modifying data via the admin interface, as performing the wrong action may have unintended consequences! -The admin interface allows *staff* users the ability to directly view / add / edit / delete database entries according to their [user permissions](/admin/permissions). +The admin interface allows *staff* users the ability to directly view / add / edit / delete database entries according to their [user permissions](../permissions). ### Access Admin Interface diff --git a/docs/admin/export.md b/docs/admin/export.md index fad9131..1285c52 100644 --- a/docs/admin/export.md +++ b/docs/admin/export.md @@ -4,7 +4,7 @@ title: Exporting Data ## Exporting Data -The [Admin Interface](/admin/admin) provides powerful data exporting capability. When displaying a list of items which support exporting (e.g. Part objects), select the "Export" button from the top-right corner: +The [Admin Interface](../admin) provides powerful data exporting capability. When displaying a list of items which support exporting (e.g. Part objects), select the "Export" button from the top-right corner: {% with id="export", url="admin/export.png", description="Data export" %} {% include 'img.html' %} diff --git a/docs/build/bom.md b/docs/build/bom.md index 03e8bf9..6165892 100644 --- a/docs/build/bom.md +++ b/docs/build/bom.md @@ -4,7 +4,7 @@ title: Bill of Materials ## Bill of Materials -A Bill of Materials (BOM) defines the list of component parts required to make an assembly, [create builds](/build/build) and allocate inventory. +A Bill of Materials (BOM) defines the list of component parts required to make an assembly, [create builds](../build) and allocate inventory. ### Add BOM Item diff --git a/docs/build/build.md b/docs/build/build.md index b899f6f..232a39f 100644 --- a/docs/build/build.md +++ b/docs/build/build.md @@ -36,7 +36,7 @@ A "basic" build flow is as follow: A Part BOM is required to allocate inventory to a build. -Read through the [Bill of Materials documentation](/build/bom). +Read through the [Bill of Materials documentation](../bom). ### Build Order diff --git a/docs/index.md b/docs/index.md index 98ef9da..6d14c42 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,44 +20,44 @@ InvenTree is designed to allow for a flexible installation. You could run the In Parts are the fundamental element of any inventory. InvenTree groups parts into structured categories which allow you to arrange parts to meet your particular needs. -[Read more...](/part/part) +[Read more...](./part/part) ### Manage Suppliers InvenTree allows you to easily create, modify or delete suppliers and supplier items linked to any part in your inventory. -[Read more...](/buy/supplier) +[Read more...](./buy/supplier) ### Instant Stock Knowledge Instantly view current stock for a certain part, in a particular location, or required for an individual build. Stock items are organized in cascading locations and sub-locations, allowing flexible inspection of stock under any location. Stock items can be serialized for tracking of individual items, and test results can be stored against a serialized stock item for the purpose of acceptance testing and commissioning. -[Read more...](/stock/stock) +[Read more...](./stock/stock) ### BOM Management Intelligent BOM (Bill of Material) management provides a clear understanding of the sub-parts required to make a new part. InvenTree allows you to upload simple BOM files in multiple formats, and download a detailed BOM with all the information stored in its database. -[Read more...](/build/bom) +[Read more...](./build/bom) ### Build Parts Inventree features a build management system to help you track the progress of your builds. Builds consume stock items to make new parts, you can decide to automatically or manually allocate parts from your current inventory. -[Read more...](/build/build) +[Read more...](./build/build) ### Report -Generate a wide range of reports using custom templates. [Read more...](/report/report) +Generate a wide range of reports using custom templates. [Read more...](./report/report) ### Extend and Customize InvenTree is designed to be highly extensible. If the core InvenTree functionality does not meet your particular need, InvenTree provides a RESTful API, a native Python library, and a powerful plugin system. -[Read more...](/extend/api) +[Read more...](./extend/api) ## Getting Started -Refer to the [installation guide](/start/install) for instructions on installing InvenTree. The server where InvenTree is to be installed will need to meet some basic package requirements, and a certain level of system administration understanding is assumed. \ No newline at end of file +Refer to the [installation guide](./start/install) for instructions on installing InvenTree. The server where InvenTree is to be installed will need to meet some basic package requirements, and a certain level of system administration understanding is assumed. \ No newline at end of file diff --git a/docs/part/part.md b/docs/part/part.md index e55c8c5..ffab5e6 100644 --- a/docs/part/part.md +++ b/docs/part/part.md @@ -25,5 +25,5 @@ The category part list provides an overview of each part: The list of parts underneath a given category can be filtered by multiple user-configurable filters, which is especially useful when a large number of parts exist under a certain category. -Clicking on the part name links to the [*Part Detail*](/part/views) view. +Clicking on the part name links to the [*Part Detail*](../views) view. diff --git a/docs/part/test.md b/docs/part/test.md index fcb1e12..71f2469 100644 --- a/docs/part/test.md +++ b/docs/part/test.md @@ -39,4 +39,4 @@ If this flag is set, then a corresponding test result against a stock item must ### Test Results -Individual stock item objects can have test results associated with them which correspond to test templates. Refer to the [stock test result](/stock/test) documentation for further information. \ No newline at end of file +Individual stock item objects can have test results associated with them which correspond to test templates. Refer to the [stock test result](../../stock/test) documentation for further information. \ No newline at end of file diff --git a/docs/part/views.md b/docs/part/views.md index 046227b..4601ec8 100644 --- a/docs/part/views.md +++ b/docs/part/views.md @@ -36,15 +36,15 @@ A Part can provide different functionality based on the following options. **Virtual** - A *Virtual* part is one which does not physically exist but should still be tracked in the system. This could be a process step, machine time, software license, etc. -**Template** - A *Template* part is one which can have *variants* which exist underneath it. [Read further information about template parts here](/part/template). +**Template** - A *Template* part is one which can have *variants* which exist underneath it. [Read further information about template parts here](../template). -**Assembly** - If a part is designated as an *Assembly* it can be created (or built) from other component parts. As an example, a circuit board assembly is made using multiple electronic components, which are tracked in the system. An *Assembly* Part has a Bill of Materials (BOM) which lists all the required sub-components. [Read further information about BOM management here](/build/bom). +**Assembly** - If a part is designated as an *Assembly* it can be created (or built) from other component parts. As an example, a circuit board assembly is made using multiple electronic components, which are tracked in the system. An *Assembly* Part has a Bill of Materials (BOM) which lists all the required sub-components. [Read further information about BOM management here](../../build/bom). -**Component** - If a part is designated as a *Component* it can be used as a sub-component of an *Assembly*. [Read further information about BOM management here](/build/bom) +**Component** - If a part is designated as a *Component* it can be used as a sub-component of an *Assembly*. [Read further information about BOM management here](../../build/bom) **Trackable** - If a part is designed as *trackable*, it can be tracked using unique serial numbers. -**Purchaseable** - If a part is designated as *Purchaseable* it can be purchased from external suppliers. Setting this flag allows parts to be added to [purchase orders](/buy/po). +**Purchaseable** - If a part is designated as *Purchaseable* it can be purchased from external suppliers. Setting this flag allows parts to be added to [purchase orders](../../buy/po). **Salable** - If a part is designated as *Salable* it can be sold to external customers. Setting this flag allows parts to be added to sales orders. @@ -52,13 +52,13 @@ A Part can provide different functionality based on the following options. ## Parameters -Parts can have multiple defined [parameters](/part/parameter). +Parts can have multiple defined [parameters](../parameter). ## Variants If a part is a *Template Part* then the *Variants* tab will be visible. -[Read about Part templates](/part/template) +[Read about Part templates](../template) ## Stock @@ -90,7 +90,7 @@ The *Allocated* tab displays how many units of this part have been allocated to ## BOM -The *BOM* tab displays the [Bill of Materials](/build/bom) - a list of sub-components used to build an assembly. Each row in the BOM specifies a quantity of another Part which is required to build the assembly. This tab is only visible if the Part is an *assembly* (meaning it can be build from other parts). +The *BOM* tab displays the [Bill of Materials](../../build/bom) - a list of sub-components used to build an assembly. Each row in the BOM specifies a quantity of another Part which is required to build the assembly. This tab is only visible if the Part is an *assembly* (meaning it can be build from other parts). ## Build Orders @@ -122,7 +122,7 @@ The *Sales Orders* tab shows a list of the sales orders for this part. It provid ## Tests -If a part is marked as *trackable*, the user can define tests which must be performed on any stock items which are instances of this part. [Read more about testing](/part/test). +If a part is marked as *trackable*, the user can define tests which must be performed on any stock items which are instances of this part. [Read more about testing](../test). ## Attachments diff --git a/docs/report/report.md b/docs/report/report.md index 2a1bc0c..46b04b8 100644 --- a/docs/report/report.md +++ b/docs/report/report.md @@ -16,9 +16,9 @@ In addition to providing the ability for end-users to provide their own reportin Following is a list of available report types -* [Test Report](/report/test): Format results of a test report against for a particular StockItem -* [Packing List](/report/pack): Format a list of items for shipping or transfer -* [Order List](/report/order): Order line items +* [Test Report](../test): Format results of a test report against for a particular StockItem +* [Packing List](../pack): Format a list of items for shipping or transfer +* [Order List](../order): Order line items ## Template Formats diff --git a/docs/start/install.md b/docs/start/install.md index 6ce988d..f4b2837 100644 --- a/docs/start/install.md +++ b/docs/start/install.md @@ -20,7 +20,7 @@ Database selection should be determined by your particular installation requirem ### Serving Data -Once a database is setup, you need a way of accessing the data. InvenTree provides a "server" application out of the box, but this may not scale particularly well with multiple users. Instead, InvenTree can be served using a webserver such as [Gunicorn](https://gunicorn.org/). For more information see the [deployment documentation](/start/deploy). +Once a database is setup, you need a way of accessing the data. InvenTree provides a "server" application out of the box, but this may not scale particularly well with multiple users. Instead, InvenTree can be served using a webserver such as [Gunicorn](https://gunicorn.org/). For more information see the [deployment documentation](./deploy). ## OS Requirements @@ -145,7 +145,7 @@ Once the required packages are installed, the database configuration must be adj As part of the previous *install* step, a configuration file (**config.yaml**) is created. The configuration file provides administrators control over various setup options without digging into the Django *settings.py* script. The default setup uses a local sqlite database with *DEBUG* mode enabled. -For further information on installation configuration, refer to the [Configuration](/start/config) section. +For further information on installation configuration, refer to the [Configuration](../config) section. !!! warning "Configure Database" Ensure database settings are correctly configured in `config.yaml` before proceeding to the next step! @@ -190,4 +190,4 @@ This will launch the InvenTree web interface at `http://127.0.0.1:8000`. For oth ### Run Production Server -For a production install, refer to [deployment instructions](/start/deploy). +For a production install, refer to [deployment instructions](../deploy). diff --git a/docs/start/migrate.md b/docs/start/migrate.md index 7cd3faa..6376362 100644 --- a/docs/start/migrate.md +++ b/docs/start/migrate.md @@ -19,13 +19,12 @@ This will export all data (including user information) to a json data file. ### Initialize New Database -Configure the new database using the normal processes (see [Configuration](/start/config)) +Configure the new database using the normal processes (see [Configuration](../config)) Then, ensure that the database schema are correctly initialized in the new database: ``` -python3 InvenTree/manage.py makemigrations -python3 InvenTree/manage.py migrate --run-syncdb +invoke migrate ``` ### Import Data @@ -35,5 +34,6 @@ The new database should now be correctly initialized with the correct table stru ``` python3 InvenTree/manage.py loaddata data.json ``` + !!! info "Character Encoding" - If the character encoding of the data file does not exactly match the target database, the import operation may not succeed. In this case, some manual editing of the database JSON file may be required. \ No newline at end of file + If the character encoding of the data file does not exactly match the target database, the import operation may not succeed. In this case, some manual editing of the database JSON file may be required. diff --git a/docs/stock/stock.md b/docs/stock/stock.md index 72e1471..5f617d6 100644 --- a/docs/stock/stock.md +++ b/docs/stock/stock.md @@ -8,7 +8,7 @@ A stock location represents a physical real-world location where *Stock Items* a ## Stock Item -A *Stock Item* is an actual instance of a [*Part*](/part/part) item. It represents a physical quantity of the *Part* in a specific location. +A *Stock Item* is an actual instance of a [*Part*](../../part/part) item. It represents a physical quantity of the *Part* in a specific location. ### Stock Item Details diff --git a/docs/stock/test.md b/docs/stock/test.md index cea7b9e..7afccd7 100644 --- a/docs/stock/test.md +++ b/docs/stock/test.md @@ -6,7 +6,7 @@ title: Stock Test Result Stock items which are associated with a *trackable* part can have associated test data - this is particularly useful for tracking unit testing / commissioning / acceptance data against a serialized stock item. -The master "Part" record for the stock item can define multiple [test templates](/part/test/), against which test data can be uploaded. Additionally, arbitrary test information can be assigned to the stock item. +The master "Part" record for the stock item can define multiple [test templates](../../part/test/), against which test data can be uploaded. Additionally, arbitrary test information can be assigned to the stock item. !!! missing "TODO" Include pictures of the Test Results tab @@ -44,7 +44,7 @@ Multiple results can be uploaded against the same test name. In cases where mult ### Automated Test Intgration -The stock item testing framework is especially useful when integrating with an automated acceptance testing framework. Test results can be uploaded using the [InvenTree API](/extend/api/) or the [InvenTree Python Interface](/extend/python/). +The stock item testing framework is especially useful when integrating with an automated acceptance testing framework. Test results can be uploaded using the [InvenTree API](../../extend/api/) or the [InvenTree Python Interface](../../extend/python/). !!! info "Example" You design and sell a temperature sensor which needs to be calibrated before it can be sold. An automated calibration tool sets the offset in the device, and uploads a test result to the InvenTree database.