mirror of
https://github.com/inventree/inventree-docs.git
synced 2025-06-12 10:15:33 +00:00
Update label printing docs
- Remove references to blabel
This commit is contained in:
64
docs/report/barcodes.md
Normal file
64
docs/report/barcodes.md
Normal file
@ -0,0 +1,64 @@
|
||||
---
|
||||
title: Barcode Generation
|
||||
---
|
||||
|
||||
## Barcode Generation
|
||||
|
||||
Both [report](../report) and [label](../labels) templates can render custom barcode data to in-line images.
|
||||
|
||||
!!! info "img"
|
||||
Barcode data must be rendered inside an `<img>` tag.
|
||||
|
||||
Inside the template file (whether it be for printing a label or generating a custom report), the following code will need to be included at the top of the template file:
|
||||
|
||||
```html
|
||||
{% raw %}
|
||||
<!-- Load the barcode helper functions -->
|
||||
{% load barcode %}
|
||||
{% endraw %}
|
||||
```
|
||||
|
||||
### 1D Barcode
|
||||
|
||||
!!! info "python-barcode"
|
||||
One dimensional barcodes (e.g. Code128) are generated using the [python-barcode](https://pypi.org/project/python-barcode/) library.
|
||||
|
||||
To render a 1D barcode, use the `barcode` template tag, as shown in the example below:
|
||||
|
||||
```html
|
||||
{% raw %}
|
||||
|
||||
<!-- Don't forget to load the barcode helper! -->
|
||||
{% load barcode %}
|
||||
|
||||
<img class='custom_class' src='{% barcode "12345678" %}'>
|
||||
|
||||
{% endraw %}
|
||||
```
|
||||
|
||||
The default barcode renderer will generate a barcode using [Code128](https://en.wikipedia.org/wiki/Code_128) rendering. However [other barcode formats](https://python-barcode.readthedocs.io/en/stable/codes.html) are also supported:
|
||||
|
||||
```html
|
||||
{% raw %}
|
||||
|
||||
{% load barcode %}
|
||||
|
||||
<img class='custom_class' src='{% barcode "12345678" barcode_class="Code39" %}>
|
||||
{% endraw %}
|
||||
```
|
||||
|
||||
### QR-Code
|
||||
|
||||
!!! info "qrcode"
|
||||
Two dimensional QR codes are generated using the [qrcode](https://pypi.org/project/qrcode/) library.
|
||||
|
||||
To render a QR code, use the `qrcode` template tag:
|
||||
|
||||
```html
|
||||
{% raw %}
|
||||
|
||||
{% load barcode %}
|
||||
|
||||
<img class='custom_qr_class' src='{% qrcode "Hello world!" %}'>
|
||||
{% endraw %}
|
||||
```
|
Reference in New Issue
Block a user