Greenstone Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== Greenstone Extensions ======
===== OpenOffice=====
The Open Office extension provides a document conversion facility if **Open Office //or// LibreOffice** is already installed on the system. In order to use the Open Office extension, 
   * You will need [[http://www.openoffice.org/|Open Office]] or [[https://www.libreoffice.org/ | LibreOffice]] installed. You may need to create an environment variable called SOFFICE_HOME and set this to the full path of your OpenOffice or LibreOffice installation folder, if:
    * 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"). 

   * 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.)
   * 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.

==== User-contributed notes ====

  * **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. 

  * **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.

===== Tesseract =====

Tesseract is an Open Source OCR Engine.

The tesseract extension contains the tesseract program, plus Greenstone plugins to use it during build.

You can get the Tesseract extension in two ways:

  - 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>

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.


==== 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.