lgcosta/paperless-ngx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Tweak docs, date example

Browse Source
This commit is contained in:
shamoon 2024-10-03 13:43:27 -07:00
parent 0af1a32c48
commit 201ae780dd
1 changed files with 16 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/advanced_usage.md
View File

@ -465,9 +465,9 @@ For a document with an ASN of 205, it would result in `somepath/asn-201-400/asn-
a document with an ASN of 355 would be placed in `somepath/asn-201-400/asn-3xx/Title.pdf`. a document with an ASN of 355 would be placed in `somepath/asn-201-400/asn-3xx/Title.pdf`.
```django ```django
{% if document.mime_type == \"application/pdf\" %} {% if document.mime_type == "application/pdf" %}
pdfs pdfs
{% elif document.mime_type == \"image/png\" %} {% elif document.mime_type == "image/png" %}
pngs pngs
{% else %} {% else %}
others others
@ -480,8 +480,8 @@ For a PDF document, it would result in `pdfs/Title.pdf`, but for a PNG document,
To use custom fields: To use custom fields:
```django ```django
{% if \"Invoice\" in custom_fields %} {% if "Invoice" in custom_fields %}
invoices/{{ custom_fields.Invoice.value\ }} invoices/{{ custom_fields.Invoice.value }}
{% else %} {% else %}
not-invoices/{{ title }} not-invoices/{{ title }}
{% endif %} {% endif %}
@ -496,6 +496,18 @@ If the custom field is named "Invoice Number", you would access the value of it
"invoices/{{ custom_fields|get_cf_value:'Invoice Number' }}" "invoices/{{ custom_fields|get_cf_value:'Invoice Number' }}"
``` ```
An example using Django's [date filters](https://docs.djangoproject.com/en/5.1/ref/templates/builtins/#date) and others:
```django
invoices/
{{ custom_fields|get_cf_value:"Date Field"|date:"Y" }}/
{{ custom_fields|get_cf_value:"Date Field"|date:"m" }}/
{{ custom_fields|get_cf_value:"Date Field"|date:"d" }}/
Invoice_{{ custom_fields|get_cf_value:"Select Field" }}_{{ custom_fields|get_cf_value:"Date Field"|cut:"-" }}
```
This will create a path like `invoices/2022/01/01/Invoice_OptionTwo_20220101.pdf` if the custom field "Date Field" is set to January 1, 2022 and "Select Field" is set to `OptionTwo`.
## Automatic recovery of invalid PDFs {#pdf-recovery} ## Automatic recovery of invalid PDFs {#pdf-recovery}
Paperless will attempt to "clean" certain invalid PDFs with `qpdf` before processing if, for example, the mime_type Paperless will attempt to "clean" certain invalid PDFs with `qpdf` before processing if, for example, the mime_type