paradizelost/paperless-ngx
1
0
Fork 0
mirror of https://github.com/paperless-ngx/paperless-ngx.git synced 2025-04-29 11:09:27 -05:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'dev' into feature-permissions

Browse Source
This commit is contained in:
Michael Shamoon 2022-12-29 20:12:42 -08:00
commit d71d388c08
60 changed files with 23029 additions and 6824 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.github/ISSUE_TEMPLATE/bug-report.yml vendored
View File

@ -6,7 +6,7 @@ body:
- type: markdown
attributes:
value: |
Have a question? 👉 [Start a new discussion](https://github.com/paperless-ngx/paperless-ngx/discussions/new) or [ask in chat](https://matrix.to/#/#paperless:adnidor.de).
Have a question? 👉 [Start a new discussion](https://github.com/paperless-ngx/paperless-ngx/discussions/new) or [ask in chat](https://matrix.to/#/#paperlessngx:matrix.org).
Before opening an issue, please double check:

2
.github/ISSUE_TEMPLATE/config.yml vendored
View File

@ -4,7 +4,7 @@ contact_links:
url: https://github.com/paperless-ngx/paperless-ngx/discussions
about: This issue tracker is not for support questions. Please refer to our Discussions.
- name: 💬 Chat
url: https://matrix.to/#/#paperless:adnidor.de
url: https://matrix.to/#/#paperlessngx:matrix.org
about: Want to discuss Paperless-ngx with others? Check out our chat.
- name: 🚀 Feature Request
url: https://github.com/paperless-ngx/paperless-ngx/discussions/new?category=feature-requests

12
.github/release-drafter.yml vendored
View File

@ -4,6 +4,7 @@ autolabeler:
- '/^fix/'
title:
- "/^fix/i"
- "/^Bugfix/i"
- label: "enhancement"
branch:
- '/^feature/'
@ -13,6 +14,9 @@ categories:
- title: 'Breaking Changes'
labels:
- 'breaking-change'
- title: 'Notable Changes'
labels:
- 'notable'
- title: 'Features'
labels:
- 'enhancement'
@ -20,7 +24,8 @@ categories:
labels:
- 'bug'
- title: 'Documentation'
label: 'documentation'
labels:
- 'documentation'
- title: 'Maintenance'
labels:
- 'chore'
@ -29,7 +34,8 @@ categories:
- 'ci-cd'
- title: 'Dependencies'
collapse-after: 3
label: 'dependencies'
labels:
- 'dependencies'
- title: 'All App Changes'
labels:
- 'frontend'
@ -46,6 +52,8 @@ include-labels:
- 'frontend'
- 'backend'
- 'ci-cd'
- 'breaking-change'
- 'notable'
category-template: '### $TITLE'
change-template: '- $TITLE @$AUTHOR ([#$NUMBER]($URL))'
change-title-escapes: '\<*_&#@'

5
.github/workflows/cleanup-tags.yml vendored
View File

@ -1,7 +1,9 @@
# This workflow runs on certain conditions to check for and potentially
# delete container images from the GHCR which no longer have an associated
# code branch.
# Requires a PAT with the correct scope set in the secrets
# Requires a PAT with the correct scope set in the secrets.
#
# This workflow will not trigger runs on forked repos.
name: Cleanup Image Tags
@ -21,6 +23,7 @@ concurrency:
jobs:
cleanup-images:
name: Cleanup Image Tags for ${{ matrix.primary-name }}
if: github.repository_owner == 'paperless-ngx'
runs-on: ubuntu-22.04
strategy:
matrix:

8
.pre-commit-config.yaml
View File

@ -48,7 +48,7 @@ repos:
- id: yesqa
exclude: "(migrations)"
- repo: https://github.com/asottile/add-trailing-comma
rev: "v2.3.0"
rev: "v2.4.0"
hooks:
- id: add-trailing-comma
exclude: "(migrations)"
@ -60,11 +60,11 @@ repos:
args:
- "--config=./src/setup.cfg"
- repo: https://github.com/psf/black
rev: 22.10.0
rev: 22.12.0
hooks:
- id: black
- repo: https://github.com/asottile/pyupgrade
rev: v3.3.0
rev: v3.3.1
hooks:
- id: pyupgrade
exclude: "(migrations)"
@ -83,6 +83,6 @@ repos:
args:
- "--tab"
- repo: https://github.com/shellcheck-py/shellcheck-py
rev: "v0.8.0.4"
rev: "v0.9.0.2"
hooks:
- id: shellcheck

1034
Pipfile.lock generated
View File

File diff suppressed because it is too large Load Diff

2
charts/paperless-ngx/Chart.yaml
View File

@ -3,7 +3,7 @@ apiVersion: v2
appVersion: "1.9.2"
description: Paperless-ngx - Index and archive all of your scanned paper documents
name: paperless
version: 10.0.0
version: 10.0.1
kubeVersion: ">=1.16.0-0"
keywords:
- paperless

2
docker/compose/docker-compose.mariadb-tika.yml
View File

@ -49,8 +49,6 @@ services:
MARIADB_USER: paperless
MARIADB_PASSWORD: paperless
MARIADB_ROOT_PASSWORD: paperless
ports:
- "3306:3306"
webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest

2
docker/compose/docker-compose.mariadb.yml
View File

@ -45,8 +45,6 @@ services:
MARIADB_USER: paperless
MARIADB_PASSWORD: paperless
MARIADB_ROOT_PASSWORD: paperless
ports:
- "3306:3306"
webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest

2
docker/docker-prepare.sh
View File

@ -36,6 +36,8 @@ wait_for_mariadb() {
local attempt_num=1
local -r max_attempts=5
# Disable warning, host and port can't have spaces
# shellcheck disable=SC2086
while ! true > /dev/tcp/$host/$port; do
if [ $attempt_num -eq $max_attempts ]; then

46
docs/administration.md
View File

@ -9,7 +9,7 @@ Before making backups, make sure that paperless is not running.
Options available to any installation of paperless:
- Use the [document exporter](administration#exporter). The document exporter exports all your documents,
- Use the [document exporter](#exporter). The document exporter exports all your documents,
thumbnails and metadata to a specific folder. You may import your
documents into a fresh instance of paperless again or store your
documents in another DMS with this export.
@ -52,7 +52,7 @@ Options available to bare-metal and non-docker installations:
## Updating Paperless {#updating}
### Docker Route
### Docker Route {#docker-updating}
If a new release of paperless-ngx is available, upgrading depends on how
you installed paperless-ngx in the first place. The releases are
@ -68,23 +68,23 @@ $ docker-compose down
After that, [make a backup](#backup).
A. If you pull the image from the docker hub, all you need to do is:
1. If you pull the image from the docker hub, all you need to do is:
``` shell-session
$ docker-compose pull
$ docker-compose up
```
```shell-session
$ docker-compose pull
$ docker-compose up
```
The docker-compose files refer to the `latest` version, which is
always the latest stable release.
The docker-compose files refer to the `latest` version, which is
always the latest stable release.
B. If you built the image yourself, do the following:
2. If you built the image yourself, do the following:
``` shell-session
$ git pull
$ docker-compose build
$ docker-compose up
```
```shell-session
$ git pull
$ docker-compose build
$ docker-compose up
```
Running `docker-compose up` will also apply any new database migrations.
If you see everything working, press CTRL+C once to gracefully stop
@ -131,7 +131,7 @@ the background.
image: ghcr.io/paperless-ngx/paperless-ngx:1.7
```
### Bare Metal Route
### Bare Metal Route {#bare-metal-updating}
After grabbing the new release and unpacking the contents, do the
following:
@ -158,7 +158,7 @@ following:
This might not actually do anything. Not every new paperless version
comes with new database migrations.
## Downgrading Paperless
## Downgrading Paperless {#downgrade-paperless}
Downgrades are possible. However, some updates also contain database
migrations (these change the layout of the database and may move data).
@ -270,7 +270,7 @@ instead, specify `--use-filename-format`.
### Document importer {#importer}
The document importer takes the export produced by the [Document
exporter](#document-exporter) and imports it into paperless.
exporter](#exporter) and imports it into paperless.
The importer works just like the exporter. You point it at a directory,
and the script does the rest of the work:
@ -370,7 +370,7 @@ task scheduler.
### Managing filenames {#renamer}
If you use paperless' feature to
[assign custom filenames to your documents](/advanced_usage#file_name_handling), you can use this command to move all your files after
[assign custom filenames to your documents](/advanced_usage#file-name-handling), you can use this command to move all your files after
changing the naming scheme.
!!! warning
@ -434,9 +434,7 @@ rules.
As of October 2022 Microsoft no longer supports IMAP authentication
for Exchange servers, thus Exchange is no longer supported until a
solution is implemented in the Python IMAP library used by Paperless.
See
[learn.microsoft.com](https://learn.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/deprecation-of-basic-authentication-exchange-online)
See [learn.microsoft.com](https://learn.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/deprecation-of-basic-authentication-exchange-online)
### Creating archived documents {#archiver}
@ -471,13 +469,13 @@ document.
documents, such as encrypted PDF documents. The archiver will skip over
these documents each time it sees them.
### Managing encryption {#encyption}
### Managing encryption {#encryption}
Documents can be stored in Paperless using GnuPG encryption.
!!! warning
Encryption is deprecated since paperless-ngx 0.9 and doesn't really
Encryption is deprecated since [paperless-ng 0.9](/changelog#paperless-ng-090) and doesn't really
provide any additional security, since you have to store the passphrase
in a configuration file on the same system as the encrypted documents
for paperless to work. Furthermore, the entire text content of the

82
docs/advanced_usage.md
View File

@ -50,7 +50,7 @@ and run another document through the consumer. Once complete, you should
see the newly-created document, automatically tagged with the
appropriate data.
### Automatic matching {#automatic_matching}
### Automatic matching {#automatic-matching}
Paperless-ngx comes with a new matching algorithm called _Auto_. This
matching algorithm tries to assign tags, correspondents, document types,
@ -59,8 +59,8 @@ assigned these on existing documents. It uses a neural network under the
hood.
If, for example, all your bank statements of your account 123 at the
Bank of America are tagged with the tag "bofa*123" and the matching
algorithm of this tag is set to \_Auto*, this neural network will examine
Bank of America are tagged with the tag "bofa123" and the matching
algorithm of this tag is set to _Auto_, this neural network will examine
your documents and automatically learn when to assign this tag.
Paperless tries to hide much of the involved complexity with this
@ -95,7 +95,7 @@ when using this feature:
of these correspondents to ANY new document, if both are set to
automatic matching.
## Hooking into the consumption process
## Hooking into the consumption process {#consume-hooks}
Sometimes you may want to do something arbitrary whenever a document is
consumed. Rather than try to predict what you may want to do, Paperless
@ -115,7 +115,7 @@ and then put the path to that script in `paperless.conf` or
asynchronously, you'll have to fork the process in your script and
exit.
### Pre-consumption script
### Pre-consumption script {#pre-consume-script}
Executed after the consumer sees a new document in the consumption
folder, but before any processing of the document is performed. This
@ -151,7 +151,7 @@ with the newly modified file.
The script's stdout and stderr will be logged line by line to the
webserver log, along with the exit code of the script.
### Post-consumption script {#post_consume_script}
### Post-consumption script {#post-consume-script}
Executed after the consumer has successfully processed a document and
has moved it into paperless. It receives the following environment
@ -181,33 +181,34 @@ The post consumption script cannot cancel the consumption process.
The script's stdout and stderr will be logged line by line to the
webserver log, along with the exit code of the script.
#### Docker
### Docker {#docker-consume-hooks}
Assumed you have
`/home/foo/paperless-ngx/scripts/post-consumption-example.sh`.
To hook into the consumption process when using Docker, you
will need to pass the scripts into the container via a host mount
in your `docker-compose.yml`.
You can pass that script into the consumer container via a host mount in
your `docker-compose.yml`.
Assuming you have
`/home/paperless-ngx/scripts/post-consumption-example.sh` as a
script which you'd like to run.
```bash
You can pass that script into the consumer container via a host mount:
```yaml
...
consumer:
webserver:
...
volumes:
...
- /home/paperless-ngx/scripts:/path/in/container/scripts/
- /home/paperless-ngx/scripts:/path/in/container/scripts/ # (1)!
environment: # (3)!
...
PAPERLESS_POST_CONSUME_SCRIPT: /path/in/container/scripts/post-consumption-example.sh # (2)!
...
```
Example (docker-compose.yml):
`- /home/foo/paperless-ngx/scripts:/usr/src/paperless/scripts`
which in turn requires the variable `PAPERLESS_POST_CONSUME_SCRIPT` in
`docker-compose.env` to point to
`/path/in/container/scripts/post-consumption-example.sh`.
Example (docker-compose.env):
`PAPERLESS_POST_CONSUME_SCRIPT=/usr/src/paperless/scripts/post-consumption-example.sh`
1. The external scripts directory is mounted to a location inside the container.
2. The internal location of the script is used to set the script to run
3. This can also be set in `docker-compose.env`
Troubleshooting:
@ -218,7 +219,7 @@ Troubleshooting:
- Pipe your scripts's output to a log file e.g.
`echo "${DOCUMENT_ID}" | tee --append /usr/src/paperless/scripts/post-consumption-example.log`
## File name handling {#file_name_handling}
## File name handling {#file-name-handling}
By default, paperless stores your documents in the media directory and
renames them using the identifier which it has assigned to each
@ -301,7 +302,7 @@ value.
!!! tip
You can affect how empty placeholders are treated by changing the
following setting to [true]{.title-ref}.
following setting to `true`.
```
PAPERLESS_FILENAME_FORMAT_REMOVE_NONE=True
@ -316,7 +317,7 @@ value.
Paperless checks the filename of a document whenever it is saved.
Therefore, you need to update the filenames of your documents and move
them after altering this setting by invoking the
[`document renamer <utilities-renamer>`]().
[`document renamer`](/administration#renamer).
!!! warning
@ -344,7 +345,7 @@ When as single storage layout is not sufficient for your use case,
storage paths come to the rescue. Storage paths allow you to configure
more precisely where each document is stored in the file system.
- Each storage path is a [PAPERLESS_FILENAME_FORMAT]{.title-ref} and
- Each storage path is a `PAPERLESS_FILENAME_FORMAT` and
follows the rules described above
- Each document is assigned a storage path using the matching
algorithms described above, but can be overwritten at any time
@ -352,7 +353,7 @@ more precisely where each document is stored in the file system.
For example, you could define the following two storage paths:
1. Normal communications are put into a folder structure sorted by
[year/correspondent]{.title-ref}
`year/correspondent`
2. Communications with insurance companies are stored in a flat
structure with longer file names, but containing the full date of
the correspondence.
@ -363,7 +364,7 @@ Insurances = Insurances/{correspondent}/{created_year}-{created_month}-{created_
```
If you then map these storage paths to the documents, you might get the
following result. For simplicity, [By Year]{.title-ref} defines the same
following result. For simplicity, `By Year` defines the same
structure as in the previous example above.
```text
@ -384,7 +385,7 @@ structure as in the previous example above.
!!! tip
Defining a storage path is optional. If no storage path is defined for a
document, the global [PAPERLESS_FILENAME_FORMAT]{.title-ref} is applied.
document, the global `PAPERLESS_FILENAME_FORMAT` is applied.
!!! warning
@ -403,33 +404,38 @@ queued and completed tasks, timing and more. Flower can also be used
with Prometheus, as it exports metrics. For details on its capabilities,
refer to the Flower documentation.
To configure Flower further, create a [flowerconfig.py]{.title-ref} and
place it into the [src/paperless]{.title-ref} directory. For a Docker
To configure Flower further, create a `flowerconfig.py` and
place it into the `src/paperless` directory. For a Docker
installation, you can use volumes to accomplish this:
```yaml
services:
# ...
webserver:
ports:
- 5555:5555 # (2)!
# ...
volumes:
- /path/to/my/flowerconfig.py:/usr/src/paperless/src/paperless/flowerconfig.py:ro
- /path/to/my/flowerconfig.py:/usr/src/paperless/src/paperless/flowerconfig.py:ro # (1)!
```
1. Note the `:ro` tag means the file will be mounted as read only.
2. `flower` runs by default on port 5555, but this can be configured
## Custom Container Initialization
The Docker image includes the ability to run custom user scripts during
startup. This could be utilized for installing additional tools or
Python packages, for example.
Python packages, for example. Scripts are expected to be shell scripts.
To utilize this, mount a folder containing your scripts to the custom
initialization directory, [/custom-cont-init.d]{.title-ref} and place
initialization directory, `/custom-cont-init.d` and place
scripts you wish to run inside. For security, the folder must be owned
by `root` and should have permissions of `a=rx`. Additionally, scripts
must only be writable by `root`.
Your scripts will be run directly before the webserver completes
startup. Scripts will be run by the [root]{.title-ref} user.
startup. Scripts will be run by the `root` user.
If you would like to switch users, the utility `gosu` is available and
preferred over `sudo`.
@ -445,9 +451,11 @@ services:
webserver:
# ...
volumes:
- /path/to/my/scripts:/custom-cont-init.d:ro
- /path/to/my/scripts:/custom-cont-init.d:ro # (1)!
```
1. Note the `:ro` tag means the folder will be mounted as read only. This is for extra security against changes
## MySQL Caveats {#mysql-caveats}
### Case Sensitivity

6
docs/api.md
View File

@ -1,7 +1,7 @@
# The REST API
Paperless makes use of the [Django REST
Framework](http://django-rest-framework.org/) standard API interface. It
Framework](https://django-rest-framework.org/) standard API interface. It
provides a browsable API for most of its endpoints, which you can
inspect at `http://<paperless-host>:<port>/api/`. This also documents
most of the available filters and ordering fields.
@ -162,7 +162,7 @@ specific query parameters cause the API to return full text search
results:
- `/api/documents/?query=your%20search%20query`: Search for a document
using a full text query. For details on the syntax, see [Basic Usage - Searching](usage#basic-usage_searching).
using a full text query. For details on the syntax, see [Basic Usage - Searching](/usage#basic-usage_searching).
- `/api/documents/?more_like=1234`: Search for documents similar to
the document with id 1234.
@ -225,7 +225,7 @@ Query parameters:
Results returned by the endpoint are ordered by importance of the term
in the document index. The first result is the term that has the highest
Tf/Idf score in the index.
[Tf/Idf](https://en.wikipedia.org/wiki/Tf%E2%80%93idf) score in the index.
```json
["term1", "term3", "term6", "term4"]

181
docs/changelog.md
View File

@ -1,5 +1,97 @@
# Changelog
## paperless-ngx 1.11.0
### Notable Changes
- Feature: frontend paperless mail [@shamoon](https://github.com/shamoon) ([#2000](https://github.com/paperless-ngx/paperless-ngx/pull/2000))
- Feature: Ability to consume mails and eml files [@p-h-a-i-l](https://github.com/p-h-a-i-l) ([#848](https://github.com/paperless-ngx/paperless-ngx/pull/848))
### Features
- Chore: Downgrade hiredis to 2.0.0 [@stumpylog](https://github.com/stumpylog) ([#2262](https://github.com/paperless-ngx/paperless-ngx/pull/2262))
- Add ability to provide the configuration file path using an env variable [@hashworks](https://github.com/hashworks) ([#2241](https://github.com/paperless-ngx/paperless-ngx/pull/2241))
- Feature: Adds option to allow a user to export directly to a zipfile [@stumpylog](https://github.com/stumpylog) ([#2004](https://github.com/paperless-ngx/paperless-ngx/pull/2004))
- Feature: Adds PaperlessTask admin page interface [@stumpylog](https://github.com/stumpylog) ([#2184](https://github.com/paperless-ngx/paperless-ngx/pull/2184))
- Feature: speed up frontend by truncating content [@shamoon](https://github.com/shamoon) ([#2028](https://github.com/paperless-ngx/paperless-ngx/pull/2028))
- Feature: Allow bulk download API to follow file name formatting [@stumpylog](https://github.com/stumpylog) ([#2003](https://github.com/paperless-ngx/paperless-ngx/pull/2003))
- Feature: Bake NLTK into Docker image [@stumpylog](https://github.com/stumpylog) ([#2129](https://github.com/paperless-ngx/paperless-ngx/pull/2129))
- Feature: frontend paperless mail [@shamoon](https://github.com/shamoon) ([#2000](https://github.com/paperless-ngx/paperless-ngx/pull/2000))
- Feature: Ability to consume mails and eml files [@p-h-a-i-l](https://github.com/p-h-a-i-l) ([#848](https://github.com/paperless-ngx/paperless-ngx/pull/848))
### Bug Fixes
- Bugfix: Handle RTL languages better [@stumpylog](https://github.com/stumpylog) ([#1665](https://github.com/paperless-ngx/paperless-ngx/pull/1665))
- Fixed typo in docs [@mendelk](https://github.com/mendelk) ([#2256](https://github.com/paperless-ngx/paperless-ngx/pull/2256))
- Fix: support in advanced search, fix tags filter badge count for excluded [@shamoon](https://github.com/shamoon) ([#2205](https://github.com/paperless-ngx/paperless-ngx/pull/2205))
- Bugfix: Don't run system checks on migrate [@stumpylog](https://github.com/stumpylog) ([#2183](https://github.com/paperless-ngx/paperless-ngx/pull/2183))
- Bugfix: Decoding task signals could fail on datetime type [@stumpylog](https://github.com/stumpylog) ([#2058](https://github.com/paperless-ngx/paperless-ngx/pull/2058))
### Documentation
- Fixed typo in docs [@mendelk](https://github.com/mendelk) ([#2256](https://github.com/paperless-ngx/paperless-ngx/pull/2256))
- Docs: More fixes and improvements [@tooomm](https://github.com/tooomm) ([#2203](https://github.com/paperless-ngx/paperless-ngx/pull/2203))
- Docs: Fix leftover issues from conversion [@tooomm](https://github.com/tooomm) ([#2172](https://github.com/paperless-ngx/paperless-ngx/pull/2172))
- Docs: Fix broken internal links [@tooomm](https://github.com/tooomm) ([#2165](https://github.com/paperless-ngx/paperless-ngx/pull/2165))
- Update setup.md [@Weltraumschaf](https://github.com/Weltraumschaf) ([#2157](https://github.com/paperless-ngx/paperless-ngx/pull/2157))
- Chore: Cleanup of new documentation [@stumpylog](https://github.com/stumpylog) ([#2137](https://github.com/paperless-ngx/paperless-ngx/pull/2137))
- [Documentation] Add v1.10.2 changelog [@github-actions](https://github.com/github-actions) ([#2114](https://github.com/paperless-ngx/paperless-ngx/pull/2114))
### Maintenance
- Chore: Adds notable label for release drafter [@stumpylog](https://github.com/stumpylog) ([#2200](https://github.com/paperless-ngx/paperless-ngx/pull/2200))
- Chore: Prevent forks from having failing CI runs by default [@tooomm](https://github.com/tooomm) ([#2166](https://github.com/paperless-ngx/paperless-ngx/pull/2166))
- Chore: migrate to eslint [@shamoon](https://github.com/shamoon) ([#2199](https://github.com/paperless-ngx/paperless-ngx/pull/2199))
- Feature: Adds PaperlessTask admin page interface [@stumpylog](https://github.com/stumpylog) ([#2184](https://github.com/paperless-ngx/paperless-ngx/pull/2184))
- Chore: Changes qpdf to be cross compiled for large speed up [@stumpylog](https://github.com/stumpylog) ([#2181](https://github.com/paperless-ngx/paperless-ngx/pull/2181))
- Chore: Decrease time to build pikepdf [@stumpylog](https://github.com/stumpylog) ([#2178](https://github.com/paperless-ngx/paperless-ngx/pull/2178))
- Chore: Minor CI cleanups [@stumpylog](https://github.com/stumpylog) ([#2175](https://github.com/paperless-ngx/paperless-ngx/pull/2175))
### All App Changes
- Add ability to provide the configuration file path using an env variable [@hashworks](https://github.com/hashworks) ([#2241](https://github.com/paperless-ngx/paperless-ngx/pull/2241))
- Fix: support in advanced search, fix tags filter badge count for excluded [@shamoon](https://github.com/shamoon) ([#2205](https://github.com/paperless-ngx/paperless-ngx/pull/2205))
- Chore: migrate to eslint [@shamoon](https://github.com/shamoon) ([#2199](https://github.com/paperless-ngx/paperless-ngx/pull/2199))
- Feature: Adds option to allow a user to export directly to a zipfile [@stumpylog](https://github.com/stumpylog) ([#2004](https://github.com/paperless-ngx/paperless-ngx/pull/2004))
- Feature: Adds PaperlessTask admin page interface [@stumpylog](https://github.com/stumpylog) ([#2184](https://github.com/paperless-ngx/paperless-ngx/pull/2184))
- Bugfix: Decoding task signals could fail on datetime type [@stumpylog](https://github.com/stumpylog) ([#2058](https://github.com/paperless-ngx/paperless-ngx/pull/2058))
- Feature: speed up frontend by truncating content [@shamoon](https://github.com/shamoon) ([#2028](https://github.com/paperless-ngx/paperless-ngx/pull/2028))
- Feature: Allow bulk download API to follow file name formatting [@stumpylog](https://github.com/stumpylog) ([#2003](https://github.com/paperless-ngx/paperless-ngx/pull/2003))
- Feature: Bake NLTK into Docker image [@stumpylog](https://github.com/stumpylog) ([#2129](https://github.com/paperless-ngx/paperless-ngx/pull/2129))
- Chore: Apply live testing backoff logic to new mail tests [@stumpylog](https://github.com/stumpylog) ([#2134](https://github.com/paperless-ngx/paperless-ngx/pull/2134))
- Feature: frontend paperless mail [@shamoon](https://github.com/shamoon) ([#2000](https://github.com/paperless-ngx/paperless-ngx/pull/2000))
- Feature: Ability to consume mails and eml files [@p-h-a-i-l](https://github.com/p-h-a-i-l) ([#848](https://github.com/paperless-ngx/paperless-ngx/pull/848))
## paperless-ngx 1.10.2
### Features
- Take ownership of k8s-at-home Helm chart [@alexander-bauer](https://github.com/alexander-bauer) ([#1947](https://github.com/paperless-ngx/paperless-ngx/pull/1947))
### Bug Fixes
- Bugfix: Language code checks around two part languages [@stumpylog](https://github.com/stumpylog) ([#2112](https://github.com/paperless-ngx/paperless-ngx/pull/2112))
- Bugfix: Redis socket compatibility didn't handle URLs with ports [@stumpylog](https://github.com/stumpylog) ([#2109](https://github.com/paperless-ngx/paperless-ngx/pull/2109))
- Bugfix: Incompatible URL schemes for socket based Redis [@stumpylog](https://github.com/stumpylog) ([#2092](https://github.com/paperless-ngx/paperless-ngx/pull/2092))
- Fix doc links in contributing [@tooomm](https://github.com/tooomm) ([#2102](https://github.com/paperless-ngx/paperless-ngx/pull/2102))
### Documentation
- Docs: Some more small MkDocs updates [@tooomm](https://github.com/tooomm) ([#2106](https://github.com/paperless-ngx/paperless-ngx/pull/2106))
- Chore: Cleans up documentation links [@stumpylog](https://github.com/stumpylog) ([#2104](https://github.com/paperless-ngx/paperless-ngx/pull/2104))
- Feature: Move docs to material-mkdocs [@shamoon](https://github.com/shamoon) ([#2067](https://github.com/paperless-ngx/paperless-ngx/pull/2067))
- Chore: Add v1.10.1 changelong [@shamoon](https://github.com/shamoon) ([#2082](https://github.com/paperless-ngx/paperless-ngx/pull/2082))
### Maintenance
- Take ownership of k8s-at-home Helm chart [@alexander-bauer](https://github.com/alexander-bauer) ([#1947](https://github.com/paperless-ngx/paperless-ngx/pull/1947))
### All App Changes
- Bugfix: Language code checks around two part languages [@stumpylog](https://github.com/stumpylog) ([#2112](https://github.com/paperless-ngx/paperless-ngx/pull/2112))
- Bugfix: Redis socket compatibility didn't handle URLs with ports [@stumpylog](https://github.com/stumpylog) ([#2109](https://github.com/paperless-ngx/paperless-ngx/pull/2109))
- Bugfix: Incompatible URL schemes for socket based Redis [@stumpylog](https://github.com/stumpylog) ([#2092](https://github.com/paperless-ngx/paperless-ngx/pull/2092))
## paperless-ngx 1.10.1
### Features
@ -961,11 +1053,10 @@ This is a maintenance release.
!!! note
The changed to the full text searching require you to reindex your
documents. _The docker image does this automatically, you don't need to
do anything._ To do this, execute the `document_index reindex`
management command (see `administration-index`{.interpreted-text
role="ref"}).
The changed to the full text searching require you to reindex your
documents. _The docker image does this automatically, you don't need to
do anything._ To do this, execute the `document_index reindex`
management command (see [Managing the document search index](/administration#index)).
### paperless-ng 1.3.2
@ -1004,8 +1095,7 @@ This release contains new database migrations.
- Changes
- The REST API is versioned from this point onwards. This will
allow me to make changes without breaking existing clients. See
the documentation about `api-versioning`{.interpreted-text
role="ref"} for details.
the documentation about [API versioning](/api#api-versioning) for details.
- Added a color picker for tag colors.
- Added the ability to use the filter for searching the document
content as well.
@ -1039,7 +1129,7 @@ This release contains new database migrations.
- Changes to the OCRmyPDF integration
- Added support for deskewing and automatic rotation of
incorrectly rotated pages. This is enabled by default, see
`configuration-ocr`{.interpreted-text role="ref"}.
[OCR settings](/configuration#ocr).
- Better support for encrypted files.
- Better support for various other PDF files: Paperless will now
attempt to force OCR with safe options when OCR fails with the
@ -1066,7 +1156,7 @@ This release contains new database migrations.
- Added a docker-specific configuration option to adjust the number of
worker processes of the web server. See
`configuration-docker`{.interpreted-text role="ref"}.
[Docker options](/configuration#docker).
- Some more memory usage optimizations.
- Don't show inbox statistics if no inbox tag is defined.
@ -1075,8 +1165,7 @@ This release contains new database migrations.
- Always show top left corner of thumbnails, even for extra wide
documents.
- Added a management command for executing the sanity checker
directly. See `utilities-sanity-checker`{.interpreted-text
role="ref"}.
directly. See [management utilities](/administration#sanity-checker).
- The weekly sanity check now reports messages in the log files.
- Fixed an issue with the metadata tab not reporting anything in case
of missing files.
@ -1110,7 +1199,7 @@ This release contains new database migrations.
management commands, since these also ensure that they're always
executed as the paperless user and you're less likely to run into
permission issues. See
`utilities-management-commands`{.interpreted-text role="ref"}.
[management commands](/administration#management-commands).
### paperless-ng 1.1.0
@ -1135,7 +1224,7 @@ This release contains new database migrations.
For status notifications and live updates to work, paperless now
requires an [ASGI](https://asgi.readthedocs.io/en/latest/)-enabled
web server. The docker images uses `gunicorn` and an ASGI-enabled
worker called [uvicorn](http://www.uvicorn.org/), and there is no
worker called [uvicorn](https://www.uvicorn.org/), and there is no
need to configure anything.
For bare metal installations, changes are required for the
@ -1152,7 +1241,7 @@ This release contains new database migrations.
status notifications.
Apache `mod_wsgi` users, see
`this note <faq-mod_wsgi>`{.interpreted-text role="ref"}.
[this note](/faq#how-do-i-get-websocket-support-with-apache-mod_wsgi).
- Paperless now offers suggestions for tags, correspondents and types
on the document detail page.
@ -1197,9 +1286,7 @@ bug reports coming in, I think that this is reasonably stable.
- The document exporter locks the media directory and the database
during execution to ensure that the resulting export is
consistent.
- See the
`updated documentation <utilities-exporter>`{.interpreted-text
role="ref"} for more details.
- See the [updated documentation](/administration#exporter) for more details.
- Other changes and additions
- Added a language selector to the settings.
- Added date format options to the settings.
@ -1288,11 +1375,11 @@ paperless.
- Thanks to [Jo Vandeginste](https://github.com/jovandeginste),
Paperless has optional support for Office documents such as .docx,
.doc, .odt and more.
- See the `configuration<configuration-tika>`{.interpreted-text
role="ref"} on how to enable this feature. This feature requires
two additional services (one for parsing Office documents and
metadata extraction and another for converting Office documents
to PDF), and is therefore not enabled on default installations.
- See the [Tika settings](/configuration#tika) on how to enable this
feature. This feature requires two additional services (one for
parsing Office documents and metadata extraction and another for
converting Office documents to PDF), and is therefore not enabled
on default installations.
- As with all other documents, paperless converts Office documents
to PDF and stores both the original as well as the archived PDF.
- Dark mode
@ -1368,15 +1455,14 @@ paperless.
!!! note
The bulk delete operations did not update the search index. Therefore,
documents that you deleted remained in the index and caused the search
to return messages about missing documents when searching. Further bulk
operations will properly update the index.
The bulk delete operations did not update the search index. Therefore,
documents that you deleted remained in the index and caused the search
to return messages about missing documents when searching. Further bulk
operations will properly update the index.
However, this change is not retroactive: If you used the delete method
of the bulk editor, you need to reindex your search index by
`running the management command document_index with the argument reindex <administration-index>`{.interpreted-text
role="ref"}.
However, this change is not retroactive: If you used the delete method
of the bulk editor, you need to reindex your search index by
[running the management command `document_index` with the argument `reindex`](/administration#index).
### paperless-ng 0.9.9
@ -1533,19 +1619,16 @@ primarily.
edit page. If available, a dropdown menu will appear next to the
download button.
- Many of the configuration options regarding OCR have changed.
See `configuration-ocr`{.interpreted-text role="ref"} for
details.
See [OCR settings](/configuration#ocr) for details.
- Paperless no longer guesses the language of your documents. It
always uses the language that you specified with
`PAPERLESS_OCR_LANGUAGE`. Be sure to set this to the language
the majority of your documents are in. Multiple languages can be
specified, but that requires more CPU time.
- The management command
`document_archiver <utilities-archiver>`{.interpreted-text
role="ref"} can be used to create archived versions for already
existing documents.
- The management command [`document_archiver`](/administration#archiver)
can be used to create archived versions for already existing documents.
- Tags from consumption folder.
- Thanks to [jayme-github](http://github.com/jayme-github),
- Thanks to [jayme-github](https://github.com/jayme-github),
paperless now consumes files from sub folders in the consumption
folder and is able to assign tags based on the sub folders a
document was found in. This can be configured with
@ -1556,7 +1639,7 @@ primarily.
- The endpoint for uploading documents now supports specifying
custom titles, correspondents, tags and types. This can be used
by clients to override the default behavior of paperless. See
`api-file_uploads`{.interpreted-text role="ref"}.
[POSTing documents](/api#file-uploads).
- The document endpoint of API now serves documents in this form:
- correspondents, document types and tags are referenced by
their ID in the fields `correspondent`, `document_type` and
@ -1590,16 +1673,14 @@ primarily.
- Paperless now supports searching by tags, types and dates and
correspondents. In order to have this applied to your existing
documents, you need to perform a `document_index reindex`
management command (see `administration-index`{.interpreted-text
role="ref"}) that adds the data to the search index. You only
need to do this once, since the schema of the search index
changed. Paperless keeps the index updated after that whenever
something changes.
management command (see [document search index](/administration#index))
that adds the data to the search index. You only need to do this
once, since the schema of the search index changed. Paperless
keeps the index updated after that whenever something changes.
- Paperless now has spelling corrections ("Did you mean") for
miss-typed queries.
- The documentation contains
`information about the query syntax <basic-searching>`{.interpreted-text
role="ref"}.
[information about the query syntax](/usage#basic-usage_searching).
- Front end:
- Clickable tags, correspondents and types allow quick filtering
for related documents.
@ -1660,10 +1741,8 @@ primarily.
### paperless-ng 0.9.0
- **Deprecated:** GnuPG.
`See this note on the state of GnuPG in paperless-ng. <utilities-encyption>`{.interpreted-text
role="ref"} This features will most likely be removed in future
versions.
- **Deprecated:** GnuPG. [See this note on the state of GnuPG in paperless-ng.](/administration#encryption)
This features will most likely be removed in future versions.
- **Added:** New frontend. Features:
- Single page application: It's much more responsive than the
django admin pages.
@ -1720,7 +1799,7 @@ primarily.
uses PostgreSQL instead of SQLite. Username, database and
password all default to `paperless` if not specified.
- **Modified \[breaking\]:** document_retagger management command
rework. See `utilities-retagger`{.interpreted-text role="ref"} for
rework. See [Document retagger](/administration#retagger) for
details. Replaces `document_correspondents` management command.
- **Removed \[breaking\]:** Reminders.
- **Removed:** All customizations made to the django admin pages.
@ -1830,7 +1909,7 @@ primarily.
### 2.5.0
- **New dependency**: Paperless now optimises thumbnail generation
with [optipng](http://optipng.sourceforge.net/), so you'll need to
with [optipng](https://optipng.sourceforge.net/), so you'll need to
install that somewhere in your PATH or declare its location in
`PAPERLESS_OPTIPNG_BINARY`. The Docker image has already been
updated on the Docker Hub, so you just need to pull the latest one

75
docs/configuration.md
View File

@ -10,12 +10,10 @@ run paperless, these settings have to be defined in different places.
- If you are running paperless on anything else, paperless will search
for the configuration file in these locations and use the first one
it finds:
```
/path/to/paperless/paperless.conf
/etc/paperless.conf
/usr/local/etc/paperless.conf
```
- The environment variable `PAPERLESS_CONFIGURATION_PATH`
- `/path/to/paperless/paperless.conf`
- `/etc/paperless.conf`
- `/usr/local/etc/paperless.conf`
## Required services
@ -33,19 +31,19 @@ matcher.
[More information on securing your Redis
Instance](https://redis.io/docs/getting-started/#securing-redis).
Defaults to <redis://localhost:6379>.
Defaults to `redis://localhost:6379`.
`PAPERLESS_DBENGINE=<engine_name>`
: Optional, gives the ability to choose Postgres or MariaDB for
database engine. Available options are [postgresql]{.title-ref} and
[mariadb]{.title-ref}.
database engine. Available options are `postgresql` and
`mariadb`.
Default is [postgresql]{.title-ref}.
Default is `postgresql`.
!!! warning
Using MariaDB comes with some caveats. See [MySQL Caveats](advanced_usage#mysql-caveats).
Using MariaDB comes with some caveats. See [MySQL Caveats](/advanced_usage#mysql-caveats).
`PAPERLESS_DBHOST=<hostname>`
@ -150,25 +148,25 @@ files created using "collectstatic" manager command are stored.
`PAPERLESS_FILENAME_FORMAT=<format>`
: Changes the filenames paperless uses to store documents in the media
directory. See [File name handling](advanced_usage#file_name_handling) for details.
directory. See [File name handling](/advanced_usage#file-name-handling) for details.
Default is none, which disables this feature.
`PAPERLESS_FILENAME_FORMAT_REMOVE_NONE=<bool>`
: Tells paperless to replace placeholders in
[PAPERLESS_FILENAME_FORMAT]{.title-ref} that would resolve to
`PAPERLESS_FILENAME_FORMAT` that would resolve to
'none' to be omitted from the resulting filename. This also holds
true for directory names. See [File name handling](advanced_usage#file_name_handling) for
true for directory names. See [File name handling](/advanced_usage#file-name-handling) for
details.
Defaults to [false]{.title-ref} which disables this feature.
Defaults to `false` which disables this feature.
`PAPERLESS_LOGGING_DIR=<path>`
: This is where paperless will store log files.
Defaults to "`PAPERLESS_DATA_DIR`/log/".
Defaults to `PAPERLESS_DATA_DIR/log/`.
`PAPERLESS_NLTK_DIR=<path>`
@ -296,10 +294,10 @@ login with the selected user.
: If this environment variable is specified, Paperless automatically
creates a superuser with the provided username at start. This is
useful in cases where you can not run the
[createsuperuser]{.title-ref} command separately, such as Kubernetes
`createsuperuser` command separately, such as Kubernetes
or AWS ECS.
Requires [PAPERLESS_ADMIN_PASSWORD]{.title-ref} to be set.
Requires PAPERLESS_ADMIN_PASSWORD be set.
!!! note
@ -310,13 +308,13 @@ or AWS ECS.
`PAPERLESS_ADMIN_MAIL=<email>`
: (Optional) Specify superuser email address. Only used when
[PAPERLESS_ADMIN_USER]{.title-ref} is set.
PAPERLESS_ADMIN_USER is set.
Defaults to `root@localhost`.
`PAPERLESS_ADMIN_PASSWORD=<password>`
: Only used when [PAPERLESS_ADMIN_USER]{.title-ref} is set. This will
: Only used when PAPERLESS_ADMIN_USER is set. This will
be the password of the automatically created superuser.
`PAPERLESS_COOKIE_PREFIX=<str>`
@ -344,26 +342,25 @@ applications.
If you're exposing paperless to the internet directly, do not use
this.
Also see the warning [in the official documentation
<https://docs.djangoproject.com/en/3.1/howto/auth-remote-user/#configuration>]{.title-ref}.
Also see the warning [in the official documentation](https://docs.djangoproject.com/en/3.1/howto/auth-remote-user/#configuration).
Defaults to [false]{.title-ref} which disables this feature.
Defaults to "false" which disables this feature.
`PAPERLESS_HTTP_REMOTE_USER_HEADER_NAME=<str>`
: If [PAPERLESS_ENABLE_HTTP_REMOTE_USER]{.title-ref} is enabled, this
: If "PAPERLESS*ENABLE_HTTP_REMOTE_USER" is enabled, this
property allows to customize the name of the HTTP header from which
the authenticated username is extracted. Values are in terms of
\[HttpRequest.META\](<https://docs.djangoproject.com/en/3.1/ref/request-response/#django.http.HttpRequest.META>).
Thus, the configured value must start with [HTTP\_]{.title-ref}
[HttpRequest.META](https://docs.djangoproject.com/en/3.1/ref/request-response/#django.http.HttpRequest.META).
Thus, the configured value must start with `HTTP*`
followed by the normalized actual header name.
Defaults to [HTTP_REMOTE_USER]{.title-ref}.
Defaults to "HTTP_REMOTE_USER".
`PAPERLESS_LOGOUT_REDIRECT_URL=<str>`
: URL to redirect the user to after a logout. This can be used
together with [PAPERLESS_ENABLE_HTTP_REMOTE_USER]{.title-ref} to
together with PAPERLESS_ENABLE_HTTP_REMOTE_USER to
redirect the user back to the SSO application's logout page.
Defaults to None, which disables this feature.
@ -381,7 +378,7 @@ needs.
parsing documents.
It should be a 3-letter language code consistent with ISO 639:
<https://www.loc.gov/standards/iso639-2/php/code_list.php>
https://www.loc.gov/standards/iso639-2/php/code_list.php
Set this to the language most of your documents are written in.
@ -642,8 +639,7 @@ Add the configuration variables to the environment of the webserver
and add the additional services below the webserver service. Watch out
for indentation.
Make sure to use the correct format [PAPERLESS_TIKA_ENABLED =
1]{.title-ref} so python_dotenv can parse the statement correctly.
Make sure to use the correct format `PAPERLESS_TIKA_ENABLED = 1` so python_dotenv can parse the statement correctly.
## Software tweaks {#software_tweaks}
@ -666,7 +662,7 @@ paperless will process in parallel on a single document.
Ensure that the product
`PAPERLESS_TASK_WORKERS \: PAPERLESS_THREADS_PER_WORKER`
`PAPERLESS_TASK_WORKERS * PAPERLESS_THREADS_PER_WORKER`
does not exceed your CPU core count or else paperless will be
extremely slow. If you want paperless to process many documents in
@ -678,7 +674,7 @@ paperless will process in parallel on a single document.
count, with a slight favor towards threads per worker:
| CPU core count | Workers | Threads |
|----------------|---------|---------|
| -------------- | ------- | ------- |
| > 1 | > 1 | > 1 |
| > 2 | > 2 | > 1 |
| > 4 | > 2 | > 2 |
@ -780,7 +776,7 @@ consumption directory as well.
`PAPERLESS_CONSUMER_SUBDIRS_AS_TAGS=<bool>`
: Set the names of subdirectories as tags for consumed files. E.g.
<CONSUMPTION_DIR>/foo/bar/file.pdf will add the tags "foo" and
`<CONSUMPTION_DIR>/foo/bar/file.pdf` will add the tags "foo" and
"bar" to the consumed file. Paperless will create any tags that
don't exist yet.
@ -855,7 +851,7 @@ documents.
: After a document is consumed, Paperless can trigger an arbitrary
script if you like. This script will be passed a number of arguments
for you to work with. For more information, take a look at [Post-consumption script](advanced_usage#post_consume_script).
for you to work with. For more information, take a look at [Post-consumption script](/advanced_usage#post-consume-script).
The default is blank, which means nothing will be executed.
@ -869,8 +865,7 @@ option as specified in
The filename will be checked first, and if nothing is found, the
document text will be checked as normal.
A date in a filename must have some separators ([.]{.title-ref},
[-]{.title-ref}, [/]{.title-ref}, etc) for it to be parsed.
A date in a filename must have some separators (`.`, `,`, `-`, `/`, etc) for it to be parsed.
Defaults to none, which disables this feature.
@ -956,7 +951,7 @@ the literal path for that program.
These options don't have any effect in `paperless.conf`. These options
adjust the behavior of the docker container. Configure these in
[docker-compose.env]{.title-ref}.
`docker-compose.env`.
`PAPERLESS_WEBSERVER_WORKERS=<num>`
@ -974,7 +969,7 @@ increase RAM usage.
There are special setups where you may need to configure this value
to restrict the Ip address or interface the webserver listens on.
Defaults to \[::\], meaning all interfaces, including IPv6.
Defaults to `[::]`, meaning all interfaces, including IPv6.
`PAPERLESS_PORT=<port>`
@ -1045,7 +1040,7 @@ configuration option:
[Flower](https://flower.readthedocs.io/en/latest/index.html) will be
started by the container.
You can read more about this in the [advanced documentation](advanced#celery-monitoring).
You can read more about this in the [advanced documentation](/advanced_usage#celery-monitoring).
## Update Checking {#update-checking}

73
docs/development.md
View File

@ -39,16 +39,16 @@ guidelines](https://github.com/paperless-ngx/paperless-ngx/blob/main/CONTRIBUTIN
## Code formatting with pre-commit Hooks
To ensure a consistent style and formatting across the project source,
the project utilizes a Git [pre-commit]{.title-ref} hook to perform some
formatting and linting before a commit is allowed. That way, everyone
uses the same style and some common issues can be caught early on. See
below for installation instructions.
the project utilizes a Git [`pre-commit`](https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks)
hook to perform some formatting and linting before a commit is allowed.
That way, everyone uses the same style and some common issues can be caught
early on. See below for installation instructions.
Once installed, hooks will run when you commit. If the formatting isn't
quite right or a linter catches something, the commit will be rejected.
You'll need to look at the output and fix the issue. Some hooks, such
as the Python formatting tool [black]{.title-ref}, will format failing
files, so all you need to do is [git add]{.title-ref} those files again
as the Python formatting tool `black`, will format failing
files, so all you need to do is `git add` those files again
and retry your commit.
## Initial setup and first start
@ -58,7 +58,7 @@ first-time setup. To do the setup you need to perform the steps from the
following chapters in a certain order:
1. Install prerequisites + pipenv as mentioned in
`[Bare metal route](/setup#bare_metal)
[Bare metal route](/setup#bare_metal)
2. Copy `paperless.conf.example` to `paperless.conf` and enable debug
mode.
@ -69,7 +69,7 @@ following chapters in a certain order:
$ npm install -g @angular/cli
```
4. Install pre-commit
4. Install pre-commit hooks
```shell-session
pre-commit install
@ -81,7 +81,7 @@ following chapters in a certain order:
mkdir -p consume media
```
6. You can now either \...
6. You can now either ...
- install redis or
@ -91,9 +91,9 @@ following chapters in a certain order:
- spin up a bare redis container
> ```shell-session
> docker run -d -p 6379:6379 --restart unless-stopped redis:latest
> ```
```shell-session
docker run -d -p 6379:6379 --restart unless-stopped redis:latest
```
7. Install the python dependencies by performing in the src/ directory.
@ -101,10 +101,12 @@ following chapters in a certain order:
pipenv install --dev
```
> - Make sure you're using python 3.9.x or lower. Otherwise you might
> get issues with building dependencies. You can use
> [pyenv](https://github.com/pyenv/pyenv) to install a specific
> python version.
!!! note
Make sure you're using python 3.10.x or lower. Otherwise you might
get issues with building dependencies. You can use
[pyenv](https://github.com/pyenv/pyenv) to install a specific
python version.
8. Generate the static UI so you can perform a login to get session
that is required for frontend development (this needs to be done one
@ -126,9 +128,9 @@ following chapters in a certain order:
you're developing for, you need to have some or all of them
running.
> ```shell-session
> python3 manage.py runserver & python3 manage.py document_consumer & celery --app paperless worker
> ```
```shell-session
python3 manage.py runserver & python3 manage.py document_consumer & celery --app paperless worker
```
11. Login with the superuser credentials provided in step 8 at
`http://localhost:8000` to create a session that enables you to use
@ -140,15 +142,15 @@ development go to `/src-ui` and run `ng serve`. From there you can use
## Back end development
The backend is a django application. PyCharm works well for development,
The backend is a [Django](https://www.djangoproject.com/) application. PyCharm works well for development,
but you can use whatever you want.
Configure the IDE to use the src/ folder as the base source folder.
Configure the following launch configurations in your IDE:
- python3 manage.py runserver
- celery \--app paperless worker
- python3 manage.py document_consumer
- `python3 manage.py runserver`
- `celery --app paperless worker`
- `python3 manage.py document_consumer`
To start them all:
@ -158,24 +160,26 @@ python3 manage.py runserver & python3 manage.py document_consumer & celery --app
Testing and code style:
- Run `pytest` in the src/ directory to execute all tests. This also
- Run `pytest` in the `src/` directory to execute all tests. This also
generates a HTML coverage report. When runnings test, paperless.conf
is loaded as well. However: the tests rely on the default
configuration. This is not ideal. But for now, make sure no settings
except for DEBUG are overridden when testing.
- Coding style is enforced by the Git pre-commit hooks. These will
ensure your code is formatted and do some linting when you do a [git
commit]{.title-ref}.
ensure your code is formatted and do some linting when you do a `git commit`.
- You can also run `black` manually to format your code
!!! note
- The `pre-commit` hooks will modify files and interact with each other.
It may take a couple of `git add`, `git commit` cycle to satisfy them.
!!! note
The line length rule E501 is generally useful for getting multiple
source files next to each other on the screen. However, in some
cases, its just not possible to make some lines fit, especially
complicated IF cases. Append `# NOQA: E501` to disable this check
complicated IF cases. Append `# noqa: E501` to disable this check
for certain lines.
## Front end development
@ -353,7 +357,8 @@ LANGUAGES = [
## Building the documentation
The documentation is built using material-mkdocs, see their [documentation](https://squidfunk.github.io/mkdocs-material/reference/). If you want to build the documentation locally, this is how you do it:
The documentation is built using material-mkdocs, see their [documentation](https://squidfunk.github.io/mkdocs-material/reference/).
If you want to build the documentation locally, this is how you do it:
1. Install python dependencies.
@ -366,7 +371,7 @@ The documentation is built using material-mkdocs, see their [documentation](http
```shell-session
$ cd /path/to/paperless
$ pipenv mkdocs build
$ pipenv mkdocs build --config-file mkdocs.yml
```
## Building the Docker image
@ -379,9 +384,9 @@ helper script `build-docker-image.sh`.
Building the docker image from source:
> ```shell-session
> ./build-docker-image.sh Dockerfile -t <your-tag>
> ```
```shell-session
./build-docker-image.sh Dockerfile -t <your-tag>
```
## Extending Paperless
@ -428,7 +433,7 @@ class MyCustomParser(DocumentParser):
def get_thumbnail(self, document_path, mime_type):
# This should return the path to a thumbnail you created for this
# document.
return os.path.join(self.tempdir, "thumb.png")
return os.path.join(self.tempdir, "thumb.webp")
```
If you encounter any issues during parsing, raise a

38
docs/faq.md
View File

@ -1,6 +1,6 @@
# Frequently Asked Questions
### _What's the general plan for Paperless-ngx?_
## _What's the general plan for Paperless-ngx?_
**A:** While Paperless-ngx is already considered largely
"feature-complete" it is a community-driven project and development
@ -9,7 +9,7 @@ discussions and "up-voted" by the community but this is not a
guarantee the feature will be implemented. This project will always be
open to collaboration in the form of PRs, ideas etc.
### _I'm using docker. Where are my documents?_
## _I'm using docker. Where are my documents?_
**A:** Your documents are stored inside the docker volume
`paperless_media`. Docker manages this volume automatically for you. It
@ -27,9 +27,7 @@ system. On Linux, chances are high that this location is
files around manually. This folder is meant to be entirely managed by
docker and paperless.
### Let's say I want to switch tools in a year. Can I easily move
to other systems?\*
## Let's say I want to switch tools in a year. Can I easily move to other systems?
**A:** Your documents are stored as plain files inside the media folder.
You can always drag those files out of that folder to use them
@ -41,27 +39,27 @@ elsewhere. Here are a couple notes about that.
- By default, paperless uses the internal ID of each document as its
filename. This might not be very convenient for export. However, you
can adjust the way files are stored in paperless by
[configuring the filename format](advanced_usage#file_name_handling).
- [The exporter](administration#exporter) is
[configuring the filename format](/advanced_usage#file-name-handling).
- [The exporter](/administration#exporter) is
another easy way to get your files out of paperless with reasonable
file names.
### _What file types does paperless-ngx support?_
## _What file types does paperless-ngx support?_
**A:** Currently, the following files are supported:
- PDF documents, PNG images, JPEG images, TIFF images and GIF images
are processed with OCR and converted into PDF documents.
- PDF documents, PNG images, JPEG images, TIFF images, GIF images and
WebP images are processed with OCR and converted into PDF documents.
- Plain text documents are supported as well and are added verbatim to
paperless.
- With the optional Tika integration enabled (see [Tika configuration](configuration#tika),
- With the optional Tika integration enabled (see [Tika configuration](/configuration#tika),
Paperless also supports various Office documents (.docx, .doc, odt,
.ppt, .pptx, .odp, .xls, .xlsx, .ods).
Paperless-ngx determines the type of a file by inspecting its content.
The file extensions do not matter.
### _Will paperless-ngx run on Raspberry Pi?_
## _Will paperless-ngx run on Raspberry Pi?_
**A:** The short answer is yes. I've tested it on a Raspberry Pi 3 B.
The long answer is that certain parts of Paperless will run very slow,
@ -73,11 +71,11 @@ has to do much less work to serve the data.
!!! note
You can adjust some of the settings so that paperless uses less
processing power. See [setup](setup#less_powerful_devices) for details.
processing power. See [setup](/setup#less-powerful-devices) for details.
### _How do I install paperless-ngx on Raspberry Pi?_
## _How do I install paperless-ngx on Raspberry Pi?_
**A:** Docker images are available for arm and arm64 hardware, so just
**A:** Docker images are available for armv7 and arm64 hardware, so just
follow the docker-compose instructions. Apart from more required disk
space compared to a bare metal installation, docker comes with close to
zero overhead, even on Raspberry Pi.
@ -87,13 +85,13 @@ the python requirements do not have precompiled packages for ARM /
ARM64. Installation of these will require additional development
libraries and compilation will take a long time.
### _How do I run this on Unraid?_
## _How do I run this on Unraid?_
**A:** Paperless-ngx is available as [community
app](https://unraid.net/community/apps?q=paperless-ngx) in Unraid. [Uli
Fahrer](https://github.com/Tooa) created a container template for that.
### _How do I run this on my toaster?_
## _How do I run this on my toaster?_
**A:** I honestly don't know! As for all other devices that might be
able to run paperless, you're a bit on your own. If you can't run the
@ -103,11 +101,11 @@ This is also what I use to test new releases with. Apart from that, I
also have a Raspberry Pi, which I occasionally build the image on and
see if it works.
### _How do I proxy this with NGINX?_
## _How do I proxy this with NGINX?_
**A:** See [here](setup#nginx).
**A:** See [here](/setup#nginx).
### _How do I get WebSocket support with Apache mod_wsgi_?
## _How do I get WebSocket support with Apache mod_wsgi_?
**A:** `mod_wsgi` by itself does not support ASGI. Paperless will
continue to work with WSGI, but certain features such as status

8
docs/index.md
View File

@ -5,7 +5,7 @@
**Paperless-ngx** is a _community-supported_ open-source document management system that transforms your
physical documents into a searchable online archive so you can keep, well, _less paper_.
[Get started](/setup/){ .md-button .md-button--primary .index-callout }
[Get started](/setup){ .md-button .md-button--primary .index-callout }
[Demo](https://demo.paperless-ngx.com){ .md-button .md-button--secondary target=\_blank }
</div>
@ -50,12 +50,12 @@ If you want to learn about what's different in paperless-ngx from
Paperless, check out these resources in the documentation:
- [Some screenshots](#screenshots) of the new UI are available.
- Read [this section](/advanced_usage/#advanced-automatic_matching) if you want to learn about how paperless automates all
- Read [this section](/advanced_usage#automatic-matching) if you want to learn about how paperless automates all
tagging using machine learning.
- Paperless now comes with a [proper email consumer](/usage/#usage-email) that's fully tested and production ready.
- Paperless now comes with a [proper email consumer](/usage#usage-email) that's fully tested and production ready.
- Paperless creates searchable PDF/A documents from whatever you put into the consumption directory. This means
that you can select text in image-only documents coming from your scanner.
- See [this note](/administration/#utilities-encyption) about GnuPG encryption in paperless-ngx.
- See [this note](/administration#encryption) about GnuPG encryption in paperless-ngx.
- Paperless is now integrated with a
[task processing queue](/setup#task_processor) that tells you at a glance when and why something is not working.
- The [changelog](/changelog) contains a detailed list of all changes in paperless-ngx.

54
docs/setup.md
View File

@ -2,10 +2,10 @@
You can go multiple routes to setup and run Paperless:
- [Use the easy install docker script](/setup#docker_script)
- [Pull the image from Docker Hub](/setup#docker_hub)
- [Build the Docker image yourself](/setup#docker_build)
- [Install Paperless directly on your system manually (bare metal)](/setup#bare_metal)
- [Use the easy install docker script](#docker_script)
- [Pull the image from Docker Hub](#docker_hub)
- [Build the Docker image yourself](#docker_build)
- [Install Paperless directly on your system manually (bare metal)](#bare_metal)
The Docker routes are quick & easy. These are the recommended routes.
This configures all the stuff from the above automatically so that it
@ -234,9 +234,8 @@ steps described in [Docker setup](#docker_hub) automatically.
certain, more updated software. If you want to build these images
your self, that is possible, but beyond the scope of these steps.
4. Follow steps 3 to 8 of [Docker Setup](setup#docker_hub)
role="ref"}. When asked to run `docker-compose pull` to pull the
image, do
4. Follow steps 3 to 8 of [Docker Setup](#docker_hub). When asked to run
`docker-compose pull` to pull the image, do
```shell-session
$ docker-compose build
@ -316,20 +315,21 @@ supported.
enabled. This is usually the case, but not always.
4. Get the release archive from
<https://github.com/paperless-ngx/paperless-ngx/releases>. If you
clone the git repo as it is, you also have to compile the front end
by yourself. Extract the archive to a place from where you wish to
execute it, such as `/opt/paperless`.
<https://github.com/paperless-ngx/paperless-ngx/releases>. Extract the
archive to a place from where you wish to execute it, such as
`/opt/paperless`. If you clone the git repo as it is, you also have to
compile the frontend yourself, see [here](/development#front-end-development)
and use the `build` step, not `serve`.
5. Configure paperless. See [configuration](configuration) for details.
5. Configure paperless. See [configuration](/configuration) for details.
Edit the included `paperless.conf` and adjust the settings to your
needs. Required settings for getting
paperless running are:
- `PAPERLESS_REDIS` should point to your redis server, such as
<redis://localhost:6379>.
- `PAPERLESS_DBENGINE` optional, and should be one of [postgres,
mariadb, or sqlite]{.title-ref}
- `PAPERLESS_DBENGINE` optional, and should be one of `postgres`,
`mariadb`, or `sqlite`
- `PAPERLESS_DBHOST` should be the hostname on which your
PostgreSQL server is running. Do not configure this to use
SQLite instead. Also configure port, database name, user and
@ -344,7 +344,7 @@ supported.
allows third parties to forge authentication credentials.
- `PAPERLESS_URL` if you are behind a reverse proxy. This should
point to your domain. Please see
[configuration](configuration) for more
[configuration](/configuration) for more
information.
Many more adjustments can be made to paperless, especially the OCR
@ -387,17 +387,17 @@ supported.
9. Go to `/opt/paperless/src`, and execute the following commands:
```bash
\# This creates the database schema.
# This creates the database schema.
sudo -Hu paperless python3 manage.py migrate
\# This creates your first paperless user
# This creates your first paperless user
sudo -Hu paperless python3 manage.py createsuperuser
```
10. Optional: Test that paperless is working by executing
```bash
\# This collects static files from paperless and django.
# This collects static files from paperless and django.
sudo -Hu paperless python3 manage.py runserver
```
@ -480,7 +480,7 @@ supported.
not available for most distributions.
15. Optional: If using the NLTK machine learning processing (see
`PAPERLESS_ENABLE_NLTK` in [configuration](configuration#software_tweaks) for details),
`PAPERLESS_ENABLE_NLTK` in [configuration](/configuration#software_tweaks) for details),
download the NLTK data for the Snowball
Stemmer, Stopwords and Punkt tokenizer to your
`PAPERLESS_DATA_DIR/nltk`. Refer to the [NLTK
@ -562,7 +562,7 @@ Migration to paperless-ngx is then performed in a few simple steps:
the docker-compose files from
[here](https://github.com/paperless-ngx/paperless-ngx/tree/master/docker/compose)
or clone the repository to build the image yourself (see
[above](/setup#docker_build)). You can
[above](#docker_build)). You can
either replace your current paperless folder or put paperless-ngx in
a different location.
@ -586,7 +586,7 @@ Migration to paperless-ngx is then performed in a few simple steps:
after you migrated your existing SQLite database.
5. Adjust `docker-compose.yml` and `docker-compose.env` to your needs.
See [Docker setup](setup#docker_hub) details on
See [Docker setup](#docker_hub) details on
which edits are advised.
6. [Update paperless.](/administration#updating)
@ -676,7 +676,7 @@ below use PostgreSQL, but are applicable to MySQL/MariaDB with the
!!! warning
MySQL is case insensitive by default, treating values like "Name" and
"NAME" as identical. See [MySQL caveats](advanced##mysql-caveats) for details.
"NAME" as identical. See [MySQL caveats](/advanced_usage#mysql-caveats) for details.
!!! warning
@ -691,7 +691,7 @@ below use PostgreSQL, but are applicable to MySQL/MariaDB with the
file to `docker-compose.yml`. Remember to adjust the consumption
directory, if necessary.
b) Without docker, configure the database in your `paperless.conf`
file. See [configuration](configuration) for
file. See [configuration](/configuration) for
details.
3. Open a shell and initialize the database:
@ -766,7 +766,7 @@ After that, you need to clear your cookies (Paperless-ngx comes with
updated dependencies that do cookie-processing differently) and probably
your cache as well.
# Considerations for less powerful devices {#less_powerful_devices}
# Considerations for less powerful devices {#less-powerful-devices}
Paperless runs on Raspberry Pi. However, some things are rather slow on
the Pi and configuring some options in paperless can help improve
@ -797,12 +797,12 @@ performance immensely:
more advanced language processing, which can take more memory and
processing time.
For details, refer to [configuration](configuration).
For details, refer to [configuration](/configuration).
!!! note
Updating the
[automatic matching algorithm](/advanced_usage#automatic_matching) takes quite a bit of time. However, the update mechanism
[automatic matching algorithm](/advanced_usage#automatic-matching) takes quite a bit of time. However, the update mechanism
checks if your data has changed before doing the heavy lifting. If you
experience the algorithm taking too much cpu time, consider changing the
schedule in the admin interface to daily. You can also manually invoke
@ -849,7 +849,7 @@ http {
```
The `PAPERLESS_URL` configuration variable is also required when using a
reverse proxy. Please refer to the [hosting and security](configuration#hosting-and-security) docs.
reverse proxy. Please refer to the [hosting and security](/configuration#hosting-and-security) docs.
Also read
[this](https://channels.readthedocs.io/en/stable/deploying.html#nginx-supervisor-ubuntu),

12
docs/troubleshooting.md
View File

@ -32,7 +32,7 @@ If you find the OCR accuracy to be too low, and/or the document consumer
warns that
`OCR for XX failed, but we're going to stick with what we've got since FORGIVING_OCR is enabled`,
then you might need to install the [Tesseract language
files](http://packages.ubuntu.com/search?keywords=tesseract-ocr)
files](https://packages.ubuntu.com/search?keywords=tesseract-ocr)
marching your document's languages.
As an example, if you are running Paperless-ngx from any Ubuntu or
@ -145,7 +145,7 @@ The following error occured while consuming document.pdf: [Errno 13] Permission
This happens when paperless does not have permission to delete files
inside the consumption directory. Ensure that `USERMAP_UID` and
`USERMAP_GID` are set to the user id and group id you use on the host
operating system, if these are different from `1000`. See [Docker setup](setup#docker_hub).
operating system, if these are different from `1000`. See [Docker setup](/setup#docker_hub).
Also ensure that you are able to read and write to the consumption
directory on the host.
@ -222,7 +222,7 @@ This might have multiple reasons.
SENDFILE=0
```
to your [docker-compose.env]{.title-ref} file.
to your `docker-compose.env` file.
## Error while reading metadata
@ -326,9 +326,9 @@ unlock. This may have minor performance implications.
## gunicorn fails to start with "is not a valid port number"
You are likely running using Kubernetes, which automatically creates an
environment variable named [\${serviceName}\_PORT]{.title-ref}. This is
environment variable named `${serviceName}_PORT`. This is
the same environment variable which is used by Paperless to optionally
change the port gunicorn listens on.
To fix this, set [PAPERLESS_PORT]{.title-ref} again to your desired
port, or the default of 8000.
To fix this, set `PAPERLESS_PORT` again to your desired port, or the
default of 8000.

24
docs/usage.md
View File

@ -1,9 +1,9 @@
# Usage Overview
Paperless is an application that manages your personal documents. With
the help of a document scanner (see [the scanners wiki](https://github.com/paperless-ngx/paperless-ngx/wiki/Scanner-&-Software-Recommendations)), paperless transforms your wieldy physical document binders
into a searchable archive and provides many utilities for finding and
managing your documents.
the help of a document scanner (see [the scanners wiki](https://github.com/paperless-ngx/paperless-ngx/wiki/Scanner-&-Software-Recommendations)),
paperless transforms your unwieldy physical document binders into a searchable archive
and provides many utilities for finding and managing your documents.
## Terms and definitions
@ -37,7 +37,7 @@ Each document has a couple of fields that you can assign to them:
date you signed a contract, or the date a letter was sent to you.
- The _archive serial number_ (short: ASN) of a document is the
identifier of the document in your physical document binders. See
[recommended workflow](#usage-reccomended_workflow) below.
[recommended workflow](#usage-recommended-workflow) below.
- The _content_ of a document is the text that was OCR'ed from the
document. This text is fed into the search engine and is used for
matching tags, correspondents and document types.
@ -74,8 +74,8 @@ following operations on your documents:
### The consumption directory
The primary method of getting documents into your database is by putting
them in the consumption directory. The consumer runs in an infinite
loop, looking for new additions to this directory. When it finds them,
them in the consumption directory. The consumer waits patiently, looking
for new additions to this directory. When it finds them,
the consumer goes about the process of parsing them with the OCR,
indexing what it finds, and storing it in the media directory.
@ -86,7 +86,7 @@ scanner to automatically push files to this directory, you'll need to
setup some sort of service to accept the files from the scanner.
Typically, you're looking at an FTP server like
[Proftpd](http://www.proftpd.org/) or a Windows folder share with
[Samba](http://www.samba.org/).
[Samba](https://www.samba.org/).
### Web UI Upload
@ -99,7 +99,7 @@ dragging-and-dropping files into your browser window.
### Mobile upload {#usage-mobile_upload}
The mobile app over at <https://github.com/qcasey/paperless_share>
The mobile app over at [https://github.com/qcasey/paperless_share](https://github.com/qcasey/paperless_share)
allows Android users to share any documents with paperless. This can be
combined with any of the mobile scanning apps out there, such as Office
Lens.
@ -195,7 +195,7 @@ configured on the 'Scheduled tasks' page in the admin.
### REST API
You can also submit a document using the REST API, see [docs][api#file-uploads]
You can also submit a document using the REST API, see [POSTing documents](/api#file-uploads)
for details.
## Best practices {#basic-searching}
@ -325,7 +325,7 @@ language](https://whoosh.readthedocs.io/en/latest/querylang.html). For
details on what date parsing utilities are available, see [Date
parsing](https://whoosh.readthedocs.io/en/latest/dates.html#parsing-date-queries).
## The recommended workflow {#usage-recommended_workflow}
## The recommended workflow {#usage-recommended-workflow}
Once you have familiarized yourself with paperless and are ready to use
it for all your documents, the recommended workflow for managing your
@ -398,7 +398,7 @@ Once you have scanned in a document, proceed in paperless as follows.
paperless will assign them automatically. After consuming a couple
documents, you can even ask paperless to *learn* when to assign tags and
correspondents by itself. For details on this feature, see
[advanced matching](advanced_usage#matching).
[advanced matching](/advanced_usage#matching).
### Task management
@ -416,7 +416,7 @@ how regularly you intend to scan documents and use paperless.
performed the task associated with the document, move it to the
inbox.
## Architectue
## Architecture
Paperless-ngx consists of the following components:

3
mkdocs.yml
View File

@ -23,6 +23,7 @@ theme:
- navigation.tabs
- navigation.top
- toc.integrate
- content.code.annotate
icon:
repo: fontawesome/brands/github
favicon: assets/favicon.png
@ -39,6 +40,8 @@ markdown_extensions:
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.superfences
- pymdownx.inlinehilite
strict: true
nav:
- index.md
- setup.md

8
src-ui/messages.xlf
View File

@ -3757,8 +3757,8 @@
<context context-type="linenumber">574</context>
</context-group>
</trans-unit>
<trans-unit id="2105352414355663637" datatype="html">
<source>This operation will permanently this mail account.</source>
<trans-unit id="7176985344323395435" datatype="html">
<source>This operation will permanently delete this mail account.</source>
<context-group purpose="location">
<context context-type="sourcefile">src/app/components/manage/settings/settings.component.ts</context>
<context context-type="linenumber">575</context>
@ -3799,8 +3799,8 @@
<context context-type="linenumber">633</context>
</context-group>
</trans-unit>
<trans-unit id="6183247517597275616" datatype="html">
<source>This operation will permanently this mail rule.</source>
<trans-unit id="2250372580580310337" datatype="html">
<source>This operation will permanently delete this mail rule.</source>
<context-group purpose="location">
<context context-type="sourcefile">src/app/components/manage/settings/settings.component.ts</context>
<context context-type="linenumber">634</context>

2
src-ui/src/app/components/common/filterable-dropdown/filterable-dropdown.component.html
View File

@ -4,7 +4,7 @@
<use attr.xlink:href="assets/bootstrap-icons.svg#{{icon}}" />
</svg>
<div class="d-none d-sm-inline">&nbsp;{{title}}</div>
<ng-container *ngIf="!editing && selectionModel.selectionSize() > 0">
<ng-container *ngIf="!editing && selectionModel.totalCount > 0">
<app-clearable-badge [number]="multiple ? selectionModel.totalCount : undefined" [selected]="!multiple && selectionModel.selectionSize() > 0" (cleared)="reset()"></app-clearable-badge>
</ng-container>
</button>

4
src-ui/src/app/components/manage/settings/settings.component.ts
View File

@ -760,7 +760,7 @@ export class SettingsComponent
backdrop: 'static',
})
modal.componentInstance.title = $localize`Confirm delete mail account`
modal.componentInstance.messageBold = $localize`This operation will permanently this mail account.`
modal.componentInstance.messageBold = $localize`This operation will permanently delete this mail account.`
modal.componentInstance.message = $localize`This operation cannot be undone.`
modal.componentInstance.btnClass = 'btn-danger'
modal.componentInstance.btnCaption = $localize`Proceed`
@ -819,7 +819,7 @@ export class SettingsComponent
backdrop: 'static',
})
modal.componentInstance.title = $localize`Confirm delete mail rule`
modal.componentInstance.messageBold = $localize`This operation will permanently this mail rule.`
modal.componentInstance.messageBold = $localize`This operation will permanently delete this mail rule.`
modal.componentInstance.message = $localize`This operation cannot be undone.`
modal.componentInstance.btnClass = 'btn-danger'
modal.componentInstance.btnCaption = $localize`Proceed`

2
src-ui/src/environments/environment.prod.ts
View File

@ -5,7 +5,7 @@ export const environment = {
apiBaseUrl: document.baseURI + 'api/',
apiVersion: '2',
appTitle: 'Paperless-ngx',
version: '1.10.2-dev',
version: '1.11.0-dev',
webSocketHost: window.location.host,
webSocketProtocol: window.location.protocol == 'https:' ? 'wss:' : 'ws:',
webSocketBaseUrl: base_url.pathname + 'ws/',

1724
src-ui/src/locale/messages.ar_SA.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.be_BY.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.cs_CZ.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.da_DK.xlf
View File

File diff suppressed because it is too large Load Diff

1112
src-ui/src/locale/messages.de_DE.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.es_ES.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.fi_FI.xlf
View File

File diff suppressed because it is too large Load Diff

1130
src-ui/src/locale/messages.fr_FR.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.he_IL.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.hr_HR.xlf
View File

File diff suppressed because it is too large Load Diff

1102
src-ui/src/locale/messages.it_IT.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.lb_LU.xlf
View File

File diff suppressed because it is too large Load Diff

1136
src-ui/src/locale/messages.nl_NL.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.no_NO.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.pl_PL.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.pt_BR.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.pt_PT.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.ro_RO.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.ru_RU.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.sl_SI.xlf
View File

File diff suppressed because it is too large Load Diff

1102
src-ui/src/locale/messages.sr_CS.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.sv_SE.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.tr_TR.xlf
View File

File diff suppressed because it is too large Load Diff

1100
src-ui/src/locale/messages.zh_CN.xlf
View File

File diff suppressed because it is too large Load Diff

3
src/documents/index.py
View File

@ -157,6 +157,9 @@ class DelayedQuery:
elif k == "tags__id__all":
for tag_id in v.split(","):
criterias.append(query.Term("tag_id", tag_id))
elif k == "tags__id__none":
for tag_id in v.split(","):
criterias.append(query.Not(query.Term("tag_id", tag_id)))
elif k == "document_type__id":
criterias.append(query.Term("type_id", v))
elif k == "correspondent__isnull":

878
src/locale/ar_SA/LC_MESSAGES/django.po Normal file
View File

@ -0,0 +1,878 @@
msgid ""
msgstr ""
"Project-Id-Version: paperless-ngx\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-11-09 21:50+0000\n"
"PO-Revision-Date: 2022-12-09 07:39\n"
"Last-Translator: \n"
"Language-Team: Arabic\n"
"Language: ar_SA\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5);\n"
"X-Crowdin-Project: paperless-ngx\n"
"X-Crowdin-Project-ID: 500308\n"
"X-Crowdin-Language: ar\n"
"X-Crowdin-File: /dev/src/locale/en_US/LC_MESSAGES/django.po\n"
"X-Crowdin-File-ID: 14\n"
#: documents/apps.py:9
msgid "Documents"
msgstr "المستندات"
#: documents/models.py:32
msgid "Any word"
msgstr "أي كلمة"
#: documents/models.py:33
msgid "All words"
msgstr "كل الكلمات"
#: documents/models.py:34
msgid "Exact match"
msgstr "تطابق تام"
#: documents/models.py:35
msgid "Regular expression"
msgstr "التعابير النظامية"
#: documents/models.py:36
msgid "Fuzzy word"
msgstr "كلمة غامضة"
#: documents/models.py:37
msgid "Automatic"
msgstr "تلقائي"
#: documents/models.py:40 documents/models.py:367 paperless_mail/models.py:16
#: paperless_mail/models.py:80
msgid "name"
msgstr "اسم"
#: documents/models.py:42
msgid "match"
msgstr "تطابق"
#: documents/models.py:45
msgid "matching algorithm"
msgstr "خوارزمية مطابقة"
#: documents/models.py:50
msgid "is insensitive"
msgstr "غير حساس"
#: documents/models.py:63 documents/models.py:118
msgid "correspondent"
msgstr "مراسل"
#: documents/models.py:64
msgid "correspondents"
msgstr "مراسلون"
#: documents/models.py:69
msgid "color"
msgstr "لون"
#: documents/models.py:72
msgid "is inbox tag"
msgstr "علامة علبة الوارد"
#: documents/models.py:75
msgid "Marks this tag as an inbox tag: All newly consumed documents will be tagged with inbox tags."
msgstr "ضع علامة على هذه السمة كعلامة علبة الوارد: سيتم وضع علامة على جميع المستندات المستهلكة حديثا مع علامات صندوق الواردات."
#: documents/models.py:81
msgid "tag"
msgstr "علامة"
#: documents/models.py:82 documents/models.py:156
msgid "tags"
msgstr "علامات"
#: documents/models.py:87 documents/models.py:138
msgid "document type"
msgstr "نوع المستند"
#: documents/models.py:88
msgid "document types"
msgstr "أنواع المستندات"
#: documents/models.py:93
msgid "path"
msgstr "مسار"
#: documents/models.py:99 documents/models.py:127
msgid "storage path"
msgstr "مسار التخزين"
#: documents/models.py:100
msgid "storage paths"
msgstr "مسارات التخزين"
#: documents/models.py:108
msgid "Unencrypted"
msgstr "دون تشفير"
#: documents/models.py:109
msgid "Encrypted with GNU Privacy Guard"
msgstr "مشفر باستخدام حارس خصوصية غنو"
#: documents/models.py:130
msgid "title"
msgstr "عنوان"
#: documents/models.py:142 documents/models.py:611
msgid "content"
msgstr "محتوى"
#: documents/models.py:145
msgid "The raw, text-only data of the document. This field is primarily used for searching."
msgstr "الخام, فقط النص من المستند. يستخدم هذا الحقل أساسا للبحث."
#: documents/models.py:150
msgid "mime type"
msgstr "MIME type"
#: documents/models.py:160
msgid "checksum"
msgstr "بصمة الملف"
#: documents/models.py:164
msgid "The checksum of the original document."
msgstr "بصمة الملف للمستند الأصلي."
#: documents/models.py:168
msgid "archive checksum"
msgstr "بصمة الملف للربيدة"
#: documents/models.py:173
msgid "The checksum of the archived document."
msgstr "بصمة الملف للمستند الربيدة."
#: documents/models.py:176 documents/models.py:348 documents/models.py:617
msgid "created"
msgstr "أُنشئ"
#: documents/models.py:179
msgid "modified"
msgstr "مُعدّل"
#: documents/models.py:186
msgid "storage type"
msgstr "نوع التخزين"
#: documents/models.py:194
msgid "added"
msgstr "أضيف"
#: documents/models.py:201
msgid "filename"
msgstr "اسم الملف"
#: documents/models.py:207
msgid "Current filename in storage"
msgstr "اسم الملف الحالي في التخزين"
#: documents/models.py:211
msgid "archive filename"
msgstr "اسم الربيدة"
#: documents/models.py:217
msgid "Current archive filename in storage"
msgstr "اسم ملف الربيدة الحالي في التخزين"
#: documents/models.py:221
msgid "original filename"
msgstr "اسم الملف الأصلي"
#: documents/models.py:227
msgid "The original name of the file when it was uploaded"
msgstr "اسم الملف الأصلي عند تحميله"
#: documents/models.py:231
msgid "archive serial number"
msgstr "الرقم التسلسلي للربيدة"
#: documents/models.py:237
msgid "The position of this document in your physical document archive."
msgstr "موقع هذا المستند في ربيدة المستند الفيزيائي."
#: documents/models.py:243 documents/models.py:628
msgid "document"
msgstr "مستند"
#: documents/models.py:244
msgid "documents"
msgstr "المستندات"
#: documents/models.py:331
msgid "debug"
msgstr "تصحيح الأخطاء"
#: documents/models.py:332
msgid "information"
msgstr "معلومات"
#: documents/models.py:333
msgid "warning"
msgstr "تحذير"
#: documents/models.py:334
msgid "error"
msgstr "خطأ"
#: documents/models.py:335
msgid "critical"
msgstr "الحرجة"
#: documents/models.py:338
msgid "group"
msgstr "مجموعة"
#: documents/models.py:340
msgid "message"
msgstr "رسالة"
#: documents/models.py:343
msgid "level"
msgstr "المستوى"
#: documents/models.py:352
msgid "log"
msgstr "سجل"
#: documents/models.py:353
msgid "logs"
msgstr "السجلات"
#: documents/models.py:363 documents/models.py:419
msgid "saved view"
msgstr "العرض المحفوظ"
#: documents/models.py:364
msgid "saved views"
msgstr "العروض المحفوظة"
#: documents/models.py:366 documents/models.py:637
msgid "user"
msgstr "المستخدم"
#: documents/models.py:370
msgid "show on dashboard"
msgstr "عرض على لوحة التحكم"
#: documents/models.py:373
msgid "show in sidebar"
msgstr "عرض على الشريط الجانبي"
#: documents/models.py:377
msgid "sort field"
msgstr "فرز الحقل"
#: documents/models.py:382
msgid "sort reverse"
msgstr "فرز بالعكس"
#: documents/models.py:387
msgid "title contains"
msgstr "العنوان يحتوي"
#: documents/models.py:388
msgid "content contains"
msgstr "المحتوى يحتوي"
#: documents/models.py:389
msgid "ASN is"
msgstr "ASN هو"
#: documents/models.py:390
msgid "correspondent is"
msgstr "المراسل هو"
#: documents/models.py:391
msgid "document type is"
msgstr "نوع المستند"
#: documents/models.py:392
msgid "is in inbox"
msgstr "موجود في علبة الوارد"
#: documents/models.py:393
msgid "has tag"
msgstr "لديه علامة"
#: documents/models.py:394
msgid "has any tag"
msgstr "لديه أي وسم"
#: documents/models.py:395
msgid "created before"
msgstr "أنشئت قبل"
#: documents/models.py:396
msgid "created after"
msgstr "أنشئت بعد"
#: documents/models.py:397
msgid "created year is"
msgstr "أنشئت سنة"
#: documents/models.py:398
msgid "created month is"
msgstr "أنشئت شهر"
#: documents/models.py:399
msgid "created day is"
msgstr "أنشئت يوم"
#: documents/models.py:400
msgid "added before"
msgstr "أضيف قبل"
#: documents/models.py:401
msgid "added after"
msgstr "أضيف بعد"
#: documents/models.py:402
msgid "modified before"
msgstr "عُدِّل قبل"
#: documents/models.py:403
msgid "modified after"
msgstr "عُدِّل بعد"
#: documents/models.py:404
msgid "does not have tag"
msgstr "ليس لديه علامة"
#: documents/models.py:405
msgid "does not have ASN"
msgstr "ليس لديه ASN"
#: documents/models.py:406
msgid "title or content contains"
msgstr "العنوان أو المحتوى يحتوي"
#: documents/models.py:407
msgid "fulltext query"
msgstr "استعلام كامل النص"
#: documents/models.py:408
msgid "more like this"
msgstr "أخرى مثلها"
#: documents/models.py:409
msgid "has tags in"
msgstr "لديه علامات في"
#: documents/models.py:410
msgid "ASN greater than"
msgstr "ASN أكبر من"
#: documents/models.py:411
msgid "ASN less than"
msgstr "ASN أقل من"
#: documents/models.py:412
msgid "storage path is"
msgstr "مسار التخزين"
#: documents/models.py:422
msgid "rule type"
msgstr "نوع القاعدة"
#: documents/models.py:424
msgid "value"
msgstr "قيمة"
#: documents/models.py:427
msgid "filter rule"
msgstr "تصفية القاعدة"
#: documents/models.py:428
msgid "filter rules"
msgstr "تصفية القواعد"
#: documents/models.py:536
msgid "Task ID"
msgstr "الرمز التعريفي للمهمة"
#: documents/models.py:537
msgid "Celery ID for the Task that was run"
msgstr "رمز المعرف للمهمة التي كانت تعمل"
#: documents/models.py:542
msgid "Acknowledged"
msgstr "مُعترف"
#: documents/models.py:543
msgid "If the task is acknowledged via the frontend or API"
msgstr "إذا عرف على المهمة عبر الواجهة الأمامية أو API"
#: documents/models.py:549 documents/models.py:556
msgid "Task Name"
msgstr "اسم المهمة"
#: documents/models.py:550
msgid "Name of the file which the Task was run for"
msgstr "اسم الملف الذي وكل بالمهمة"
#: documents/models.py:557
msgid "Name of the Task which was run"
msgstr "اسم المهمة التي كانت تعمل"
#: documents/models.py:562
msgid "Task Positional Arguments"
msgstr "مهمة قيمة المعاملات الموضعية"
#: documents/models.py:564
msgid "JSON representation of the positional arguments used with the task"
msgstr "تمثيل JSON لقيمة المعاملات الموضعية المستخدمة في المهمة"
#: documents/models.py:569
msgid "Task Named Arguments"
msgstr "مهمة قيمة المعامل المسمى"
#: documents/models.py:571
msgid "JSON representation of the named arguments used with the task"
msgstr "تمثيل JSON لقيمة المعاملات المسمية المستخدمة في المهمة"
#: documents/models.py:578
msgid "Task State"
msgstr "حالة المهمة"
#: documents/models.py:579
msgid "Current state of the task being run"
msgstr "الحالة الراهنة للمهمة قيد العمل"
#: documents/models.py:584
msgid "Created DateTime"
msgstr "تاريخ و وقت الإنشاء"
#: documents/models.py:585
msgid "Datetime field when the task result was created in UTC"
msgstr "حقل التاريخ والوقت عند إنشاء نتيجة المهمة في UTC"
#: documents/models.py:590
msgid "Started DateTime"
msgstr "تاريخ و وقت البداية"
#: documents/models.py:591
msgid "Datetime field when the task was started in UTC"
msgstr "حقل التاريخ والوقت عند بدء المهمة في UTC"
#: documents/models.py:596
msgid "Completed DateTime"
msgstr "التاريخ و الوقت المكتمل"
#: documents/models.py:597
msgid "Datetime field when the task was completed in UTC"
msgstr "حقل التاريخ و الوقت عند اكتمال المهمة في UTC"
#: documents/models.py:602
msgid "Result Data"
msgstr "نتائج البيانات"
#: documents/models.py:604
msgid "The data returned by the task"
msgstr "البيانات المستردة من قبل المهمة"
#: documents/models.py:613
msgid "Comment for the document"
msgstr "التعليق على المستند"
#: documents/models.py:642
msgid "comment"
msgstr "تعليق"
#: documents/models.py:643
msgid "comments"
msgstr "التعليقات"
#: documents/serialisers.py:72
#, python-format
msgid "Invalid regular expression: %(error)s"
msgstr "التعبير النظامي خاطىء: %(error)s"
#: documents/serialisers.py:193
msgid "Invalid color."
msgstr "لون خاطئ."
#: documents/serialisers.py:518
#, python-format
msgid "File type %(type)s not supported"
msgstr "نوع الملف %(type)s غير مدعوم"
#: documents/serialisers.py:599
msgid "Invalid variable detected."
msgstr "اكتشاف متغير خاطئ."
#: documents/templates/index.html:78
msgid "Paperless-ngx is loading..."
msgstr "تحميل Paperless-ngx..."
#: documents/templates/index.html:79
msgid "Still here?! Hmm, something might be wrong."
msgstr "مازلت هنا؟! همم، قد يكون هناك خطأ ما."
#: documents/templates/index.html:79
msgid "Here's a link to the docs."
msgstr "إليك رابط المستندات."
#: documents/templates/registration/logged_out.html:14
msgid "Paperless-ngx signed out"
msgstr "تسجيل الخروج Paperless-ngx"
#: documents/templates/registration/logged_out.html:59
msgid "You have been successfully logged out. Bye!"
msgstr "تم تسجيل خروجك بنجاح. مع السلامة!"
#: documents/templates/registration/logged_out.html:60
msgid "Sign in again"
msgstr "تسجيل الدخول مرة أخرى"
#: documents/templates/registration/login.html:15
msgid "Paperless-ngx sign in"
msgstr "تسجيل الدخول Paperless-ngx"
#: documents/templates/registration/login.html:61
msgid "Please sign in."
msgstr "الرجاء تسجيل الدخول."
#: documents/templates/registration/login.html:64
msgid "Your username and password didn't match. Please try again."
msgstr "اسم المستخدم وكلمة المرور غير متطابقين. حاول مرة أخرى."
#: documents/templates/registration/login.html:67
msgid "Username"
msgstr "اسم المستخدم"
#: documents/templates/registration/login.html:68
msgid "Password"
msgstr "كلمة المرور"
#: documents/templates/registration/login.html:73
msgid "Sign in"
msgstr "تسجيل الدخول"
#: paperless/settings.py:378
msgid "English (US)"
msgstr "الإنجليزية (الولايات المتحدة)"
#: paperless/settings.py:379
msgid "Belarusian"
msgstr "البيلاروسية"
#: paperless/settings.py:380
msgid "Czech"
msgstr "التشيكية"
#: paperless/settings.py:381
msgid "Danish"
msgstr "الدانماركية"
#: paperless/settings.py:382
msgid "German"
msgstr "الألمانية"
#: paperless/settings.py:383
msgid "English (GB)"
msgstr "الإنجليزية (المملكة المتحدة)"
#: paperless/settings.py:384
msgid "Spanish"
msgstr "الإسبانية"
#: paperless/settings.py:385
msgid "French"
msgstr "الفرنسية"
#: paperless/settings.py:386
msgid "Italian"
msgstr "الإيطالية"
#: paperless/settings.py:387
msgid "Luxembourgish"
msgstr "اللوكسمبرجية"
#: paperless/settings.py:388
msgid "Dutch"
msgstr "الهولندية"
#: paperless/settings.py:389
msgid "Polish"
msgstr "البولندية"
#: paperless/settings.py:390
msgid "Portuguese (Brazil)"
msgstr "البرتغالية (البرازيل)"
#: paperless/settings.py:391
msgid "Portuguese"
msgstr "البرتغالية"
#: paperless/settings.py:392
msgid "Romanian"
msgstr "الرومانية"
#: paperless/settings.py:393
msgid "Russian"
msgstr "الروسية"
#: paperless/settings.py:394
msgid "Slovenian"
msgstr "السلوفانية"
#: paperless/settings.py:395
msgid "Serbian"
msgstr "الصربية"
#: paperless/settings.py:396
msgid "Swedish"
msgstr "السويدية"
#: paperless/settings.py:397
msgid "Turkish"
msgstr "التركية"
#: paperless/settings.py:398
msgid "Chinese Simplified"
msgstr "الصينية المبسطة"
#: paperless/urls.py:161
msgid "Paperless-ngx administration"
msgstr "Paperless-ngx الإدارة"
#: paperless_mail/admin.py:29
msgid "Authentication"
msgstr "المصادقة"
#: paperless_mail/admin.py:30
msgid "Advanced settings"
msgstr "الإعدادات المتقدمة"
#: paperless_mail/admin.py:47
msgid "Filter"
msgstr "تصفية"
#: paperless_mail/admin.py:50
msgid "Paperless will only process mails that match ALL of the filters given below."
msgstr "Paperless يقوم فقط بمعالجة البُرُد التي تتطابق جميع التصفيات المقدمة أدناه."
#: paperless_mail/admin.py:64
msgid "Actions"
msgstr "إجراءات"
#: paperless_mail/admin.py:67
msgid "The action applied to the mail. This action is only performed when documents were consumed from the mail. Mails without attachments will remain entirely untouched."
msgstr "الإجراء المطبق على البريد. ينفذ هذا الإجراء فقط عندما تستهلك المستندات من البريد. ستبقى البُرٌد التي لا تحتوي على مرفقات ستبقى كما هي."
#: paperless_mail/admin.py:75
msgid "Metadata"
msgstr "البيانات الوصفية"
#: paperless_mail/admin.py:78
msgid "Assign metadata to documents consumed from this rule automatically. If you do not assign tags, types or correspondents here, paperless will still process all matching rules that you have defined."
msgstr "تعيين بيانات التعريف للمستندات المستهلكة من هذه القاعدة تِلْقائيًا. إذا لم تعين العلامات أو الأنواع أو المراسلين هنا، سيظل paperless يعالج جميع قواعد المطابقة التي حددتها."
#: paperless_mail/apps.py:8
msgid "Paperless mail"
msgstr "بريد paperless"
#: paperless_mail/models.py:8
msgid "mail account"
msgstr "حساب البريد"
#: paperless_mail/models.py:9
msgid "mail accounts"
msgstr "حساب البُرُد"
#: paperless_mail/models.py:12
msgid "No encryption"
msgstr "دون تشفير"
#: paperless_mail/models.py:13
msgid "Use SSL"
msgstr "استخدم SSL"
#: paperless_mail/models.py:14
msgid "Use STARTTLS"
msgstr "استخدم STARTTLS"
#: paperless_mail/models.py:18
msgid "IMAP server"
msgstr "خادم IMAP"
#: paperless_mail/models.py:21
msgid "IMAP port"
msgstr "منفذ IMAP"
#: paperless_mail/models.py:25
msgid "This is usually 143 for unencrypted and STARTTLS connections, and 993 for SSL connections."
msgstr "عادة ما يكون 143 للغير مشفر و اتصالات STARTTLS و 993 للاتصالات SSL."
#: paperless_mail/models.py:31
msgid "IMAP security"
msgstr "أمان IMAP"
#: paperless_mail/models.py:36
msgid "username"
msgstr "اسم المستخدم"
#: paperless_mail/models.py:38
msgid "password"
msgstr "كلمة المرور"
#: paperless_mail/models.py:41
msgid "character set"
msgstr "نوع ترميز المحارف"
#: paperless_mail/models.py:45
msgid "The character set to use when communicating with the mail server, such as 'UTF-8' or 'US-ASCII'."
msgstr "ترميز المحارف المستخدمة عند التواصل مع خادم البريد، مثل 'UTF-8' أو 'US-ASCII'."
#: paperless_mail/models.py:56
msgid "mail rule"
msgstr "قاعدة البريد"
#: paperless_mail/models.py:57
msgid "mail rules"
msgstr "قواعد البريد"
#: paperless_mail/models.py:60
msgid "Only process attachments."
msgstr "معالجة المرفقات فقط."
#: paperless_mail/models.py:61
msgid "Process all files, including 'inline' attachments."
msgstr "معالجة جميع الملفات، بما في ذلك المرفقات المضمنة."
#: paperless_mail/models.py:64
msgid "Delete"
msgstr "حذف"
#: paperless_mail/models.py:65
msgid "Move to specified folder"
msgstr "نقل إلى مجلد محدد"
#: paperless_mail/models.py:66
msgid "Mark as read, don't process read mails"
msgstr "وضع علامة كمقروءة، لا تعالج الرسائل المقروءة"
#: paperless_mail/models.py:67
msgid "Flag the mail, don't process flagged mails"
msgstr "علم الرسالة، لا تعالج الرسائل المعلمة"
#: paperless_mail/models.py:68
msgid "Tag the mail with specified tag, don't process tagged mails"
msgstr "علم الرسالة بعلامة محددة، لا تعالج الرسائل المُعلمة"
#: paperless_mail/models.py:71
msgid "Use subject as title"
msgstr "استخدم الموضوع كعنوان"
#: paperless_mail/models.py:72
msgid "Use attachment filename as title"
msgstr "استخدم اسم الملف المرفق كعنوان"
#: paperless_mail/models.py:75
msgid "Do not assign a correspondent"
msgstr "لا تعيّن مراسل"
#: paperless_mail/models.py:76
msgid "Use mail address"
msgstr "استخدم عنوان البريد"
#: paperless_mail/models.py:77
msgid "Use name (or mail address if not available)"
msgstr "استخدم الاسم (أو عنوان البريد إذا لم يكن متاحا)"
#: paperless_mail/models.py:78
msgid "Use correspondent selected below"
msgstr "استخدم المراسل المحدد أدناه"
#: paperless_mail/models.py:82
msgid "order"
msgstr "الطلب"
#: paperless_mail/models.py:88
msgid "account"
msgstr "الحساب"
#: paperless_mail/models.py:92
msgid "folder"
msgstr "مجلد"
#: paperless_mail/models.py:96
msgid "Subfolders must be separated by a delimiter, often a dot ('.') or slash ('/'), but it varies by mail server."
msgstr "يجب فصل المجلدات الفرعية باستخدام محدد، غالبا نقطة ('.') أو خط مائل ('/')، لكنها تختلف حسب خادم البريد."
#: paperless_mail/models.py:102
msgid "filter from"
msgstr "تصفية من"
#: paperless_mail/models.py:108
msgid "filter subject"
msgstr "تصفية الموضوع"
#: paperless_mail/models.py:114
msgid "filter body"
msgstr "تصفية الجسم"
#: paperless_mail/models.py:121
msgid "filter attachment filename"
msgstr "تصفية اسم الملف المرفق"
#: paperless_mail/models.py:126
msgid "Only consume documents which entirely match this filename if specified. Wildcards such as *.pdf or *invoice* are allowed. Case insensitive."
msgstr "فقط المستندات التي تتطابق تماما مع اسم هذا الملف إذا تم تحديدها. المحارف البديلة مثل *.pdf أو *الفواتير* مسموح بها. لأنها غير حساسة."
#: paperless_mail/models.py:133
msgid "maximum age"
msgstr "أقصى عُمُر"
#: paperless_mail/models.py:135
msgid "Specified in days."
msgstr "محدد بالأيام."
#: paperless_mail/models.py:139
msgid "attachment type"
msgstr "نوع المرفق"
#: paperless_mail/models.py:143
msgid "Inline attachments include embedded images, so it's best to combine this option with a filename filter."
msgstr "تتضمن المرفقات المضمنة صورا مضمنة، لذا من الأفضل دمج هذا الخِيار مع تصفية اسم الملف."
#: paperless_mail/models.py:149
msgid "action"
msgstr "إجراء"
#: paperless_mail/models.py:155
msgid "action parameter"
msgstr "إجراء المعامل"
#: paperless_mail/models.py:160
msgid "Additional parameter for the action selected above, i.e., the target folder of the move to folder action. Subfolders must be separated by dots."
msgstr "معامل إضافي للإجراء المحدد أعلاه، مثال: المجلد المستهدف للانتقال إلى إجراء مجلد. يجب أن تكون المجلدات الفرعية مفصولة بنقاط."
#: paperless_mail/models.py:168
msgid "assign title from"
msgstr "تعيين العنوان من"
#: paperless_mail/models.py:176
msgid "assign this tag"
msgstr "تعيين هذه العلامة"
#: paperless_mail/models.py:184
msgid "assign this document type"
msgstr "تعيين نوع هذا المستند"
#: paperless_mail/models.py:188
msgid "assign correspondent from"
msgstr "تعيين مراسل من"
#: paperless_mail/models.py:198
msgid "assign this correspondent"
msgstr "تعيين هذا المراسل"

60
src/locale/fr_FR/LC_MESSAGES/django.po
View File

@ -3,7 +3,7 @@ msgstr ""
"Project-Id-Version: paperless-ngx\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-11-09 21:50+0000\n"
"PO-Revision-Date: 2022-11-09 23:11\n"
"PO-Revision-Date: 2022-12-25 12:32\n"
"Last-Translator: \n"
"Language-Team: French\n"
"Language: fr_FR\n"
@ -184,11 +184,11 @@ msgstr "Nom du fichier d'archive courant en base de données"
#: documents/models.py:221
msgid "original filename"
msgstr ""
msgstr "nom de fichier d'origine"
#: documents/models.py:227
msgid "The original name of the file when it was uploaded"
msgstr ""
msgstr "Le nom original du fichier quand il a été envoyé"
#: documents/models.py:231
msgid "archive serial number"
@ -368,15 +368,15 @@ msgstr "porte une étiquette parmi"
#: documents/models.py:410
msgid "ASN greater than"
msgstr ""
msgstr "est supérieur à"
#: documents/models.py:411
msgid "ASN less than"
msgstr ""
msgstr "est inférieur à"
#: documents/models.py:412
msgid "storage path is"
msgstr ""
msgstr "chemin d'accès au stockage"
#: documents/models.py:422
msgid "rule type"
@ -396,99 +396,99 @@ msgstr "règles de filtrage"
#: documents/models.py:536
msgid "Task ID"
msgstr ""
msgstr "ID de tâche"
#: documents/models.py:537
msgid "Celery ID for the Task that was run"
msgstr ""
msgstr "Identifiant Celery pour la tâche qui a été exécutée"
#: documents/models.py:542
msgid "Acknowledged"
msgstr ""
msgstr "Prise en compte"
#: documents/models.py:543
msgid "If the task is acknowledged via the frontend or API"
msgstr ""
msgstr "Si la tâche est prise en compte via l'interface utilisateur ou l'API"
#: documents/models.py:549 documents/models.py:556
msgid "Task Name"
msgstr ""
msgstr "Nom de la tâche"
#: documents/models.py:550
msgid "Name of the file which the Task was run for"
msgstr ""
msgstr "Nom du fichier pour lequel la tâche a été exécutée"
#: documents/models.py:557
msgid "Name of the Task which was run"
msgstr ""
msgstr "Nom de la tâche exécutée"
#: documents/models.py:562
msgid "Task Positional Arguments"
msgstr ""
msgstr "Arguments positionnés de la tâche"
#: documents/models.py:564
msgid "JSON representation of the positional arguments used with the task"
msgstr ""
msgstr "Représentation JSON des arguments positionnés utilisés pour la tâche"
#: documents/models.py:569
msgid "Task Named Arguments"
msgstr ""
msgstr "Arguments nommés de la tâche"
#: documents/models.py:571
msgid "JSON representation of the named arguments used with the task"
msgstr ""
msgstr "Représentation JSON des arguments nommés utilisés pour la tâche"
#: documents/models.py:578
msgid "Task State"
msgstr ""
msgstr "État de la tâche"
#: documents/models.py:579
msgid "Current state of the task being run"
msgstr ""
msgstr "Etat actuel de la tâche en cours d'exécution"
#: documents/models.py:584
msgid "Created DateTime"
msgstr ""
msgstr "Date de création"
#: documents/models.py:585
msgid "Datetime field when the task result was created in UTC"
msgstr ""
msgstr "Champ de date lorsque le résultat de la tâche a été créé (UTC)"
#: documents/models.py:590
msgid "Started DateTime"
msgstr ""
msgstr "Date de début"
#: documents/models.py:591
msgid "Datetime field when the task was started in UTC"
msgstr ""
msgstr "Champ de date lorsque la tâche a été créé (UTC)"
#: documents/models.py:596
msgid "Completed DateTime"
msgstr ""
msgstr "Date de fin"
#: documents/models.py:597
msgid "Datetime field when the task was completed in UTC"
msgstr ""
msgstr "Champ de date lorsque la tâche a été terminée (UTC)"
#: documents/models.py:602
msgid "Result Data"
msgstr ""
msgstr "Données de résultat"
#: documents/models.py:604
msgid "The data returned by the task"
msgstr ""
msgstr "Les données retournées par la tâche"
#: documents/models.py:613
msgid "Comment for the document"
msgstr ""
msgstr "Commentaire pour ce document"
#: documents/models.py:642
msgid "comment"
msgstr ""
msgstr "commentaire"
#: documents/models.py:643
msgid "comments"
msgstr ""
msgstr "commentaires"
#: documents/serialisers.py:72
#, python-format

32
src/locale/it_IT/LC_MESSAGES/django.po
View File

@ -3,7 +3,7 @@ msgstr ""
"Project-Id-Version: paperless-ngx\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-11-09 21:50+0000\n"
"PO-Revision-Date: 2022-11-12 10:50\n"
"PO-Revision-Date: 2022-12-05 11:26\n"
"Last-Translator: \n"
"Language-Team: Italian\n"
"Language: it_IT\n"
@ -400,51 +400,51 @@ msgstr "ID Attività"
#: documents/models.py:537
msgid "Celery ID for the Task that was run"
msgstr ""
msgstr "Celery ID per l'attività che è stata eseguita"
#: documents/models.py:542
msgid "Acknowledged"
msgstr ""
msgstr "Accettato"
#: documents/models.py:543
msgid "If the task is acknowledged via the frontend or API"
msgstr ""
msgstr "Se l'attività è accettata tramite il frontend o API"
#: documents/models.py:549 documents/models.py:556
msgid "Task Name"
msgstr ""
msgstr "Nome attività"
#: documents/models.py:550
msgid "Name of the file which the Task was run for"
msgstr ""
msgstr "Nome del file per il quale è stata eseguita l'attività"
#: documents/models.py:557
msgid "Name of the Task which was run"
msgstr ""
msgstr "Nome dell'attività che è stata eseguita"
#: documents/models.py:562
msgid "Task Positional Arguments"
msgstr ""
msgstr "Positional Arguments dell'attività"
#: documents/models.py:564
msgid "JSON representation of the positional arguments used with the task"
msgstr ""
msgstr "Rappresentazione JSON dei named arguments utilizzati con l'attività"
#: documents/models.py:569
msgid "Task Named Arguments"
msgstr ""
msgstr "Named Arguments dell'attività"
#: documents/models.py:571
msgid "JSON representation of the named arguments used with the task"
msgstr ""
msgstr "Rappresentazione JSON dei named arguments utilizzati con l'attività"
#: documents/models.py:578
msgid "Task State"
msgstr ""
msgstr "Stato attività"
#: documents/models.py:579
msgid "Current state of the task being run"
msgstr ""
msgstr "Stato attuale dell'attività in esecuzione"
#: documents/models.py:584
msgid "Created DateTime"
@ -472,15 +472,15 @@ msgstr ""
#: documents/models.py:602
msgid "Result Data"
msgstr ""
msgstr "Dati Risultanti"
#: documents/models.py:604
msgid "The data returned by the task"
msgstr ""
msgstr "I dati restituiti dall'attività"
#: documents/models.py:613
msgid "Comment for the document"
msgstr ""
msgstr "Commento per il documento"
#: documents/models.py:642
msgid "comment"

20
src/locale/ru_RU/LC_MESSAGES/django.po
View File

@ -3,7 +3,7 @@ msgstr ""
"Project-Id-Version: paperless-ngx\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-11-09 21:50+0000\n"
"PO-Revision-Date: 2022-11-09 23:11\n"
"PO-Revision-Date: 2022-12-21 11:37\n"
"Last-Translator: \n"
"Language-Team: Russian\n"
"Language: ru_RU\n"
@ -184,11 +184,11 @@ msgstr "Текущее имя файла архива в хранилище"
#: documents/models.py:221
msgid "original filename"
msgstr ""
msgstr "исходное имя файла"
#: documents/models.py:227
msgid "The original name of the file when it was uploaded"
msgstr ""
msgstr "Исходное имя файла при его загрузке"
#: documents/models.py:231
msgid "archive serial number"
@ -368,11 +368,11 @@ msgstr "имеет теги в"
#: documents/models.py:410
msgid "ASN greater than"
msgstr ""
msgstr "ASN больше чем"
#: documents/models.py:411
msgid "ASN less than"
msgstr ""
msgstr "ASN меньше чем"
#: documents/models.py:412
msgid "storage path is"
@ -472,23 +472,23 @@ msgstr ""
#: documents/models.py:602
msgid "Result Data"
msgstr ""
msgstr "Данные результата"
#: documents/models.py:604
msgid "The data returned by the task"
msgstr ""
msgstr "Данные, возвращаемые задачей"
#: documents/models.py:613
msgid "Comment for the document"
msgstr ""
msgstr "Комментарий к документу"
#: documents/models.py:642
msgid "comment"
msgstr ""
msgstr "комментарий"
#: documents/models.py:643
msgid "comments"
msgstr ""
msgstr "комментарии"
#: documents/serialisers.py:72
#, python-format

5
src/paperless/settings.py
View File

@ -17,7 +17,10 @@ from django.utils.translation import gettext_lazy as _
from dotenv import load_dotenv
# Tap paperless.conf if it's available
if os.path.exists("../paperless.conf"):
configuration_path = os.getenv("PAPERLESS_CONFIGURATION_PATH")
if configuration_path and os.path.exists(configuration_path):
load_dotenv(configuration_path)
elif os.path.exists("../paperless.conf"):
load_dotenv("../paperless.conf")
elif os.path.exists("/etc/paperless.conf"):
load_dotenv("/etc/paperless.conf")

2
src/paperless/version.py
View File

@ -1,7 +1,7 @@
from typing import Final
from typing import Tuple
__version__: Final[Tuple[int, int, int]] = (1, 10, 2)
__version__: Final[Tuple[int, int, int]] = (1, 11, 0)
# Version string like X.Y.Z
__full_version_str__: Final[str] = ".".join(map(str, __version__))
# Version string like X.Y

25
src/paperless_tesseract/parsers.py
View File

@ -13,6 +13,10 @@ class NoTextFoundException(Exception):
pass
class RtlLanguageException(Exception):
pass
class RasterisedDocumentParser(DocumentParser):
"""
This parser uses Tesseract to try and get some text out of a rasterised
@ -125,7 +129,26 @@ class RasterisedDocumentParser(DocumentParser):
stripped = post_process_text(pdfminer_extract_text(pdf_file))
self.log("debug", f"Extracted text from PDF file {pdf_file}")
# pdfminer.six does not handle RTL text
# as a hack, for some languages, return no text, to force
# OCRMyPdf/Tesseract do handle this correctly
from langdetect import detect
lang = detect(stripped)
self.log("debug", f"Detected language {lang}")
if lang in {
"ar", # Arabic
"he", # Hebrew,
"fa", # Persian
}:
raise RtlLanguageException()
return stripped
except RtlLanguageException:
self.log("warning", f"Detected RTL language {lang}")
return None
except Exception:
# TODO catch all for various issues with PDFminer.six.
# If PDFminer fails, fall back to OCR.
@ -305,7 +328,7 @@ class RasterisedDocumentParser(DocumentParser):
)
if original_has_text:
self.text = text_original
except (NoTextFoundException, InputFileError) as e:
except (NoTextFoundException, RtlLanguageException, InputFileError) as e:
self.log(
"warning",
f"Encountered an error while running OCR: {str(e)}. "

BIN
src/paperless_tesseract/tests/samples/rtl-test.pdf Executable file
View File

Binary file not shown.

33
src/paperless_tesseract/tests/test_parser.py
View File

@ -588,6 +588,39 @@ class TestParser(DirectoriesMixin, TestCase):
params = parser.construct_ocrmypdf_parameters("", "", "", "")
self.assertNotIn("deskew", params)
def test_rtl_language_detection(self):
"""
GIVEN:
- File with text in an RTL language
WHEN:
- Document is parsed
THEN:
- Text from the document is extracted
"""
parser = RasterisedDocumentParser(None)
with mock.patch.object(
parser,
"construct_ocrmypdf_parameters",
wraps=parser.construct_ocrmypdf_parameters,
) as wrapped:
parser.parse(
os.path.join(self.SAMPLE_FILES, "rtl-test.pdf"),
"application/pdf",
)
# There isn't a good way to actually check this working, with RTL correctly return
# as it would require tesseract-ocr-ara installed for everyone running the
# test suite. This test does provide the coverage though and attempts to ensure
# the force OCR happens
self.assertIsNotNone(parser.get_text())
self.assertEqual(parser.construct_ocrmypdf_parameters.call_count, 2)
# Check the last call kwargs
self.assertTrue(
parser.construct_ocrmypdf_parameters.call_args.kwargs["safe_fallback"],
)
class TestParserFileTypes(DirectoriesMixin, TestCase):