User Tools

Site Tools


en:user_advanced:greenstone_extensions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:user_advanced:greenstone_extensions [2025/07/25 02:44] – [Issues with running LibreOffice in conjunction with Greenstone] kjdonen:user_advanced:greenstone_extensions [2025/07/25 02:55] (current) – [Tesseract] kjdon
Line 1: Line 1:
- 
  
  
Line 8: Line 7:
     * you're on Windows and have OpenOffice/LibreOffice installed in a location other than "C:\Program Files\OpenOffice.org 3" or "C:\Program Files\LibreOffice" (where "Program Files (x86)" is another possibility in place of "Program Files"). In such a case, also ensure that your PATH environment variable contains the path to the "program" subfolder located in your SOFFICE_HOME path (the OpenOffice installation folder).      * you're on Windows and have OpenOffice/LibreOffice installed in a location other than "C:\Program Files\OpenOffice.org 3" or "C:\Program Files\LibreOffice" (where "Program Files (x86)" is another possibility in place of "Program Files"). In such a case, also ensure that your PATH environment variable contains the path to the "program" subfolder located in your SOFFICE_HOME path (the OpenOffice installation folder). 
     * you're on Linux and have OpenOffice or LibreOffice installed in a location different from "/opt/openoffice.org3" or "/usr/lib/openoffice" (or "/usr/lib/libreoffice").      * you're on Linux and have OpenOffice or LibreOffice installed in a location different from "/opt/openoffice.org3" or "/usr/lib/openoffice" (or "/usr/lib/libreoffice"). 
-   * Once you have Open Office set up, download the Greenstone extension for it, available in tar.gz and zip formats. The latest version is available from [[http://trac.greenstone.org/browser/gs2-extensions/open-office/trunk|here]] and unzip into Greenstone 2's **ext** subfolder or Greenstone 3's **gs2build\ext** subfolder. (If you're using Greenstone 3.10 or earlier, download the tarball or zip file from [[https://trac.greenstone.org/browser/gs2-extensions/open-office/trunk?rev=35415|here]] instead and unzip into Greenstone 3.10's **gs2build\ext** folder, and then also download the script [[https://trac.greenstone.org/browser/main/trunk/binaries/windows/bin/background-launcher.vbs|background-launcher.vbs]] and put this into **gs2build\bin\windows**.)\\ + 
 +   * Once you have Open Office set up, download the Greenstone extension for it, available in tar.gz and zip formats. The latest version is available from [[http://trac.greenstone.org/browser/gs2-extensions/open-office/trunk|here]] and unzip into Greenstone 2's **ext** subfolder or Greenstone 3's **gs2build\ext** subfolder.  
 +     (If you're using Greenstone 3.10 or earlier, download the tarball or zip file from [[https://trac.greenstone.org/browser/gs2-extensions/open-office/trunk?rev=35415|here]] instead and unzip into Greenstone 3.10's **gs2build\ext** folder, and then also download the script [[https://trac.greenstone.org/browser/main/trunk/binaries/windows/bin/background-launcher.vbs|background-launcher.vbs]] and put this into **gs2build\bin\windows**.)\\ 
    * Before you can use this (or any other Greenstone extension), you will need to quit GLI and GS3-server if either are open and then you will need to **relaunch GLI** (or run Greenstone scripts) from a **fresh command terminal**, in order for the extension to become available in the Greenstone environment. (Once again, if you have openoffice or libreoffice installed outside the customary locations, then before doing so, make sure to have set up SOFFICE_HOME and updated the PATH environment variables.)    * Before you can use this (or any other Greenstone extension), you will need to quit GLI and GS3-server if either are open and then you will need to **relaunch GLI** (or run Greenstone scripts) from a **fresh command terminal**, in order for the extension to become available in the Greenstone environment. (Once again, if you have openoffice or libreoffice installed outside the customary locations, then before doing so, make sure to have set up SOFFICE_HOME and updated the PATH environment variables.)
    * With OpenOffice and the extension installed and the Greenstone environment set up for this, Greenstone's Word, PowerPoint and Excel Plugins will have a new option, "-openoffice_conversion", allowing conversion with Open Office instead of the existing converter. Switching on this new option means that more recent Office formats like docx can be included in Greenstone collections and processed by Greenstone.    * With OpenOffice and the extension installed and the Greenstone environment set up for this, Greenstone's Word, PowerPoint and Excel Plugins will have a new option, "-openoffice_conversion", allowing conversion with Open Office instead of the existing converter. Switching on this new option means that more recent Office formats like docx can be included in Greenstone collections and processed by Greenstone.
Line 14: Line 15:
 ==== User-contributed notes ==== ==== User-contributed notes ====
  
-=== Getting LibreOffice===+  * **Don't use a snap or appimage version** as these don't interface with Greenstone. Get LibreOffice directly from their website at: [[www.libreoffice.org/download/download/]]. These are the latest releases for most deb and rpm based linux distributions and for windows and macOS. The packages are large, and in the case of deb packages are themselves a collection of deb packages. 
  
-  * Don't use a snap or appimage version as these don't interface with Greenstone.+  * **Issues with running LibreOffice in conjunction with Greenstone**:  Note that with these newer versions of the open office extension, you cannot already have an instance of OpenOffice running when using GLI, you will need to terminate any previously running instance. It is also unlikely that you can get a separate instance of OpenOffice running after quitting GLI. If you wish to do so, you will need to use Task Manager to terminate the open office process launched by the extension upon running GLI.
  
-LibreOffice is available directly from their website at:+===== Tesseract =====
  
-www.libreoffice.org/download/download/+Tesseract is an Open Source OCR Engine.
  
-These are the latest releases for most deb and rpm based linux +The tesseract extension contains the tesseract program, plus Greenstone plugins to use it during build.
-distributions and for windows and macOS.+
  
-The packages are large, and in the case of deb packages are +You can get the Tesseract extension in two ways:
-themselves a collection of deb packages. +
  
 +  - Download the tar or zip file from [[https://trac.greenstone.org/browser/gs2-extensions/tesseract/trunk]], and place it in //ext// (for Greenstone 2) or //gs2build/ext// (for Greenstone 3). Extract all files.
  
 +  - Checkout the source and compile it:
 +<code> 
 +  cd greenstone3/gs2build/ext
 +  svn co https://svn.greenstone.org/gs2-extensions/tesseract/trunk/src tesseract
 +  cd tesseract
 +  ./CASCADE-MAKE.sh
 +</code>
  
-=== Issues with running LibreOffice in conjunction with Greenstone ===+Once installed (by either method), you will need to open a new terminal and source gs3-setup.sh to have the extensions environment variables set.
  
-Note that with these newer versions of the open office extension, you cannot already have an instance of OpenOffice running when using GLI, you will need to terminate any previously running instance. It is also unlikely that you can get a separate instance of OpenOffice running after quitting GLI. If you wish to do so, you will need to use Task Manager to terminate the open office process launched by the extension upon running GLI. 
  
-===== Tesseract =====+==== TesseractPlugins==== 
 + 
 +The tesseract extension comes with two plugins: TesseractTextExtractor and TesseractImagePlugin. 
 +TesseractTextExtractor is a helper plugin that will run Tesseract on an image, producing a text file. 
 +TesseractImagePlugin can replace ImagePlugin, adding Tesseract OCR ability to it.
en/user_advanced/greenstone_extensions.1753411477.txt.gz · Last modified: 2025/07/25 02:44 by kjdon