From a707c56fae2f86141a2b71d3d3d7f08fbfd75f52 Mon Sep 17 00:00:00 2001 From: "James R. Barlow" Date: Thu, 3 Dec 2020 14:17:19 -0800 Subject: [PATCH] docs: improve windows instructions --- docs/installation.rst | 37 ++++++++++++++++++------------------- 1 file changed, 18 insertions(+), 19 deletions(-) diff --git a/docs/installation.rst b/docs/installation.rst index 84520f6e..cc4ce35f 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -495,10 +495,6 @@ Installing on Windows Native Windows -------------- -.. note:: - - It is easier to install OCRmyPDF on Windows Subsystem for Linux. - .. note:: Administrator privileges will be required for some of these steps. @@ -509,30 +505,33 @@ You must install the following for Windows: * Tesseract 4.0 or later * Ghostscript 9.50 or later -You can install these with the Chocolatey package manager: +Using the `Chocolatey `_ package manager, install the +following when running in an Administrator command prompt: * ``choco install python3`` * ``choco install --pre tesseract`` * ``choco install ghostscript`` +* ``choco install pngquant`` (optional) -Also consider adding: +The commands above will install Python 3.x (latest version), Tesseract, Ghostscript +and pngquant. Chocolatey may also need to install the Windows Visual C++ Runtime +DLLs or other Windows patches, and may require a reboot. -* ``choco install pngquant`` +You may then use ``pip`` to install ocrmypdf. (This can performed by a user or +Administrator.): -Windows 10 64-bit and 64-bit versions of applications are recommended. Earlier -versions of Windows and 32-bit versions of these programs are not tested, and not -supported at this time. +* ``pip install ocrmypdf -OCRmyPDF will check for Tesseract-OCR and Ghostscript in your Program Files folder. -If they are in some other location, you may need to modify the ``PATH`` -environment variable so Tesseract, Ghostscript, and other any optional executables can -be found. You can enter it in the command line or -`follow these directions `_ -to make the change persistent and system-wide. +Chocolatey automatically selects appropriate versions of these applications. If you +are installing them manually, please install 64-bit versions of all applications for +64-bit Windows, or 32-bit versions of all applications for 32-bit Windows. Mixing +the "bitness" of these programs will lead to errors. -You may then use pip to install ocrmypdf: - -* ``pip install ocrmypdf`` +OCRmyPDF will check the Windows Registry and standard locations in your Program Files +for third party software it needs (specifically, Tesseract and Ghostscript). To +override the versions OCRmyPDF selects, you can modify the ``PATH`` environment +variable. `Follow these directions `_ +to change the PATH. Windows Subsystem for Linux ---------------------------