Changeset 34190 for gs2-extensions/tesseract/trunk/README.txt

Timestamp:

2020-06-16T17:20:50+12:00 (4 years ago)

Author:

ak19

Message:

1. The tessdata folder was being created when compiling tesseract, and needn't be created and populated manually (except for the lang files), so there's less work for CASCADE-MAKE/TESSERACT.sh to do. However, the tessdata folder was being created in the linux/share folder. 'share' is probably a place where people expect tesseract's tessdata to be by default, so am updating the setup scripts to work with that, as I've donw with CASCADE-MAKE/TESSERACT.sh. 2. Adding useful instructions for users on getting more OCR language scripts' support in new file GETTING-OCR-SUPPORT-FOR-MORE-LANGS.txt, now included in the tesseract binary tarball too. Adjusted the README for us. 3. Removing the sample.jpg, converted from sample.tif which I'd downloaded from online and for which I don't know the copyright to. Replacing with sample.tif, a 96 DPI TIF file at 1870x2420 resolution produced from the first page of pdf05-notext.pdf by www.sejda.com/pdf-to-jpg. Moreover, this sample file contains lots of text, in 2 columns, not just 4 words like the original sample file. Good for testing a tesseract built from CASCADE-MAKE on. Also including the pdf05-notext-ocr-with-tikaTesseract.pdf istelf from the tutorial sample files, but only Tika with Tesseract can work on PDFs and not Tesseract by itself, indicated in the filename.

File:

• gs2-extensions/tesseract/trunk/README.txt (modified) (3 diffs)

gs2-extensions/tesseract/trunk/README.txt

@@ -19 +19 @@
 at http://trac.greenstone.org/browser/gs2-extensions/imagemagick/trunk/README
 
+
 1. Find a location on your machine
+
 
 2. Check out the tesseract extension from gs2-extensions
    svn co http://trac.greenstone.org/browser/gs2-extensions/tesseract/trunk tesseract
 
+
 3. Compile it all up (tesseract and dependencies):
    cd tesseract
    ./CASCADE-MAKE.sh
+
 
 4. Open a fresh terminal and check that the tesseract now installed in src/linux/bin works:
@@ -43 +47 @@
    cat out.txt
 
+If you run Tesseract with the hocr config file, you can get the OCR output in
+nicely formatted html more representative of the input structure:
+
+       tesseract sample.tif hocrtest
+
+The OCR output in html format will be in hocrtest.hocr:
+
+    cat hocrtest.hocr
+
+
 5. If successful,
 
-a. create a folder at the same level as src called tesseract
+ a. create a folder at the same level as src called tesseract
    cd src
    cd ..
    mkdir tesseract
 
-b. COPY the setup files and MOVE the installed folder (src/linux) into the new cut-down tesseract folder:
+ b. COPY the setup files and MOVE the installed folder (src/linux) into the new cut-down tesseract folder:
 
    cp src/setup.ba* tesseract/.
    mv src/linux tesseract/.
 
-c. COPY the TESSERACT-APACHE-LICENSE and LEPTONICA-LICENSE txt files (note it uses
-American spelling!) from src/packages into the cut-down tesseract/linux:
+ c. COPY the TESSERACT-APACHE-LICENSE and LEPTONICA-LICENSE txt files (note it uses
+ American spelling!) from src/packages into the cut-down tesseract/linux:
 
    cp src/packages/*LICENSE.txt tesseract/linux/.
 
-d. REMOVE folder "man" from tesseract/linux:
+ d. Copy the top-level GETTING-OCR-SUPPORT-FOR-MORE-LANGS.txt file into the cutdown tesseract:
+   cp GETTING-OCR-SUPPORT-FOR-MORE-LANGS.txt tesseract/.
+
+ e. REMOVE folder "man" from tesseract/linux:
    rm -rf tesseract/linux/man
+
+ f. REMOVE everything EXCEPT the "tessdata" folder in tesseract/linux/share.
+ (The other things in that  location are either unnecessary or created by tesseract's dependencies).
+
 
 6. Create a tarball of the cut down tesseract folder named tesseract-<os>-<arch>.tar.gz:
    tar -cvzf tesseract-linux-x64.tar.gz tesseract
+
 
 7. (Add/SVN up and) commit that to svn:
@@ -111 +133 @@
                hocr_font_info 0
            
-2. In order to have a tessdata/configs/hocr, needed to correct the Tesseract we were
+
+
+In order to have a tessdata/configs/hocr, needed to correct the Tesseract we were
 cascade-making to get it to put the "configs" subfolder inside the installed Tessereact's
 tessdata folder. The source version of tesseract has this folder, but it wasn't getting