From 5410074062bef9aaaa4979cde7c6a87b39c0d9a3 Mon Sep 17 00:00:00 2001 From: Katrin Leinweber <9948149+katrinleinweber@users.noreply.github.com> Date: Sun, 20 Jul 2025 19:27:04 +0200 Subject: [PATCH] Documentation: copy-edits (#10417) --- CONTRIBUTING.md | 2 +- docker/compose/docker-compose.ci-test.yml | 2 +- .../compose/docker-compose.mariadb-tika.yml | 4 ++-- .../compose/docker-compose.postgres-tika.yml | 4 ++-- docker/compose/docker-compose.sqlite-tika.yml | 4 ++-- docs/administration.md | 2 +- docs/development.md | 12 +++++------ docs/index.md | 2 +- docs/setup.md | 2 +- docs/troubleshooting.md | 2 +- install-paperless-ngx.sh | 20 +++++++++---------- 11 files changed, 28 insertions(+), 28 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 93a529bfe..e0c52d00b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -141,7 +141,7 @@ The admins occasionally invite contributors directly if we believe having them o # Automatic Repository Maintenance The Paperless-ngx team appreciates all effort and interest from the community in filing bug reports, creating feature requests, sharing ideas and helping other -community members. That said, in an effort to keep the repository organized and managebale the project uses automatic handling of certain areas: +community members. That said, in an effort to keep the repository organized and manageable the project uses automatic handling of certain areas: - Issues that cannot be reproduced will be marked 'stale' after 7 days of inactivity and closed after 14 further days of inactivity. - Issues, pull requests and discussions that are closed will be locked after 30 days of inactivity. diff --git a/docker/compose/docker-compose.ci-test.yml b/docker/compose/docker-compose.ci-test.yml index 0d43ab923..9eb1afe19 100644 --- a/docker/compose/docker-compose.ci-test.yml +++ b/docker/compose/docker-compose.ci-test.yml @@ -1,4 +1,4 @@ -# Docker Compose file for running paperless testing with actual gotenberg +# Docker Compose file for running paperless testing with actual Gotenberg # and Tika containers for a more end to end test of the Tika related functionality # Can be used locally or by the CI to start the necessary containers with the # correct networking for the tests diff --git a/docker/compose/docker-compose.mariadb-tika.yml b/docker/compose/docker-compose.mariadb-tika.yml index e48dd7dd3..b4522c26b 100644 --- a/docker/compose/docker-compose.mariadb-tika.yml +++ b/docker/compose/docker-compose.mariadb-tika.yml @@ -16,8 +16,8 @@ # - Instead of SQLite (default), MariaDB is used as the database server. # - Apache Tika and Gotenberg servers are started with paperless and paperless # is configured to use these services. These provide support for consuming -# Office documents (Word, Excel, Power Point and their LibreOffice counter- -# parts. +# Office documents (Word, Excel, PowerPoint and their LibreOffice counter- +# parts). # # To install and update paperless with this file, do the following: # diff --git a/docker/compose/docker-compose.postgres-tika.yml b/docker/compose/docker-compose.postgres-tika.yml index f247ec117..818e1b130 100644 --- a/docker/compose/docker-compose.postgres-tika.yml +++ b/docker/compose/docker-compose.postgres-tika.yml @@ -16,8 +16,8 @@ # - Instead of SQLite (default), PostgreSQL is used as the database server. # - Apache Tika and Gotenberg servers are started with paperless and paperless # is configured to use these services. These provide support for consuming -# Office documents (Word, Excel, Power Point and their LibreOffice counter- -# parts. +# Office documents (Word, Excel, PowerPoint and their LibreOffice counter- +# parts). # # To install and update paperless with this file, do the following: # diff --git a/docker/compose/docker-compose.sqlite-tika.yml b/docker/compose/docker-compose.sqlite-tika.yml index d2728fd6b..86a6f5031 100644 --- a/docker/compose/docker-compose.sqlite-tika.yml +++ b/docker/compose/docker-compose.sqlite-tika.yml @@ -16,8 +16,8 @@ # # - Apache Tika and Gotenberg servers are started with paperless and paperless # is configured to use these services. These provide support for consuming -# Office documents (Word, Excel, Power Point and their LibreOffice counter- -# parts. +# Office documents (Word, Excel, PowerPoint and their LibreOffice counter- +# parts). # # To install and update paperless with this file, do the following: # diff --git a/docs/administration.md b/docs/administration.md index 4bb4b34cc..b646c1f73 100644 --- a/docs/administration.md +++ b/docs/administration.md @@ -306,7 +306,7 @@ in dedicated folders according to their nature: `archive`, `originals`, If `-sm` or `--split-manifest` is provided, information about document will be placed in individual json files, instead of a single JSON file. The main manifest.json will still contain application wide information (e.g. tags, correspondent, -documenttype, etc) +document type, etc) If `-z` or `--zip` is provided, the export will be a zip file in the target directory, named according to the current local date or the diff --git a/docs/development.md b/docs/development.md index 5353c164d..c624f97c4 100644 --- a/docs/development.md +++ b/docs/development.md @@ -95,13 +95,13 @@ first-time setup. 7. You can now either ... - - install redis or + - install Redis or - - use the included `scripts/start_services.sh` to use docker to fire - up a redis instance (and some other services such as tika, - gotenberg and a database server) or + - use the included `scripts/start_services.sh` to use Docker to fire + up a Redis instance (and some other services such as Tika, + Gotenberg and a database server) or - - spin up a bare redis container + - spin up a bare Redis container ``` docker run -d -p 6379:6379 --restart unless-stopped redis:latest @@ -147,7 +147,7 @@ $ ng build --configuration production ### Testing - Run `pytest` in the `src/` directory to execute all tests. This also - generates a HTML coverage report. When runnings test, `paperless.conf` + generates a HTML coverage report. When running tests, `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. diff --git a/docs/index.md b/docs/index.md index b86112ed6..c1c06eb2b 100644 --- a/docs/index.md +++ b/docs/index.md @@ -30,7 +30,7 @@ physical documents into a searchable online archive so you can keep, well, _less - Utilizes the open-source Tesseract engine to recognize more than 100 languages. - Documents are saved as PDF/A format which is designed for long term storage, alongside the unaltered originals. - Uses machine-learning to automatically add tags, correspondents and document types to your documents. -- Supports PDF documents, images, plain text files, Office documents (Word, Excel, Powerpoint, and LibreOffice equivalents)[^1] and more. +- Supports PDF documents, images, plain text files, Office documents (Word, Excel, PowerPoint, and LibreOffice equivalents)[^1] and more. - Paperless stores your documents plain on disk. Filenames and folders are managed by paperless and their format can be configured freely with different configurations assigned to different documents. - **Beautiful, modern web application** that features: - Customizable dashboard with statistics. diff --git a/docs/setup.md b/docs/setup.md index 9c75313af..f239e5429 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -445,7 +445,7 @@ are released, dependency support is confirmed, etc. 13. Configure ImageMagick to allow processing of PDF documents. Most distributions have this disabled by default, since PDF documents can contain malware. If you don't do this, paperless will fall back to - ghostscript for certain steps such as thumbnail generation. + Ghostscript for certain steps such as thumbnail generation. Edit `/etc/ImageMagick-6/policy.xml` and adjust diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 6a7270e01..87348e32e 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -335,7 +335,7 @@ You may see errors when deleting documents like: Data too long for column 'transaction_id' at row 1 ``` -This error can occur in installations which have upgraded from a version of Paperless-ngx that used Django 4 (Paperless-ngx versions prior to v2.13.0) with a MariaDB/MySQL database. Due to the backawards-incompatible change in Django 5, the column "documents_document.transaction_id" will need to be re-created, which can be done with a one-time run of the following management command: +This error can occur in installations which have upgraded from a version of Paperless-ngx that used Django 4 (Paperless-ngx versions prior to v2.13.0) with a MariaDB/MySQL database. Due to the backwards-incompatible change in Django 5, the column "documents_document.transaction_id" will need to be re-created, which can be done with a one-time run of the following management command: ```shell-session $ python3 manage.py convert_mariadb_uuid diff --git a/install-paperless-ngx.sh b/install-paperless-ngx.sh index 3977cece9..648196030 100755 --- a/install-paperless-ngx.sh +++ b/install-paperless-ngx.sh @@ -52,12 +52,12 @@ if ! command -v wget &> /dev/null ; then fi if ! command -v docker &> /dev/null ; then - echo "docker executable not found. Is docker installed?" + echo "docker executable not found. Is Docker installed?" exit 1 fi if ! docker compose &> /dev/null ; then - echo "docker compose plugin not found. Is docker compose installed?" + echo "docker compose plugin not found. Is Docker Compose installed?" exit 1 fi @@ -66,7 +66,7 @@ fi if ! docker stats --no-stream &> /dev/null ; then echo "" echo "WARN: It look like the current user does not have Docker permissions." - echo "WARN: Use 'sudo usermod -aG docker $USER' to assign Docker permissions to the user (may require restarting shell)." + echo "WARN: Use 'sudo usermod -aG docker $USER' to assign Docker permissions to the user (may require restarting the shell)." echo "" sleep 3 fi @@ -135,7 +135,7 @@ DATABASE_BACKEND=$ask_result echo "" echo "Paperless is able to use Apache Tika to support Office documents such as" -echo "Word, Excel, Powerpoint, and Libreoffice equivalents. This feature" +echo "Word, Excel, PowerPoint, and LibreOffice equivalents. This feature" echo "requires more resources due to the required services." echo "" @@ -157,7 +157,7 @@ echo "" echo "Specify the user id and group id you wish to run paperless as." echo "Paperless will also change ownership on the data, media and consume" echo "folder to the specified values, so it's a good idea to supply the user id" -echo "and group id of your unix user account." +echo "and group id of your Unix user account." echo "If unsure, leave default." echo "" @@ -212,7 +212,7 @@ if [[ "$DATABASE_BACKEND" == "sqlite" ]] ; then echo -n "SQLite database, the " fi echo "search index and other data." -echo "As with the media folder, leave empty to have this managed by docker." +echo "As with the media folder, leave empty to have this managed by Docker." echo "" echo "CAUTION: If specified, you must specify an absolute path starting with /" echo "or a relative path starting with ./ here." @@ -224,7 +224,7 @@ DATA_FOLDER=$ask_result if [[ "$DATABASE_BACKEND" == "postgres" || "$DATABASE_BACKEND" == "mariadb" ]] ; then echo "" echo "The database folder, where your database stores its data." - echo "Leave empty to have this managed by docker." + echo "Leave empty to have this managed by Docker." echo "" echo "CAUTION: If specified, you must specify an absolute path starting with /" echo "or a relative path starting with ./ here." @@ -276,18 +276,18 @@ echo "" echo "Target folder: $TARGET_FOLDER" echo "Consume folder: $CONSUME_FOLDER" if [[ -z $MEDIA_FOLDER ]] ; then - echo "Media folder: Managed by docker" + echo "Media folder: Managed by Docker" else echo "Media folder: $MEDIA_FOLDER" fi if [[ -z $DATA_FOLDER ]] ; then - echo "Data folder: Managed by docker" + echo "Data folder: Managed by Docker" else echo "Data folder: $DATA_FOLDER" fi if [[ "$DATABASE_BACKEND" == "postgres" || "$DATABASE_BACKEND" == "mariadb" ]] ; then if [[ -z $DATABASE_FOLDER ]] ; then - echo "Database folder: Managed by docker" + echo "Database folder: Managed by Docker" else echo "Database folder: $DATABASE_FOLDER" fi