### Install Ruby Dependencies and Run Development Server

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

This snippet covers cloning the Tabula repository, installing specific Bundler version, and then installing Ruby dependencies using Bundler and JRuby. It also shows how to start the development server with optional environment variables for data directory and debug mode.

```bash
git clone git://github.com/tabulapdf/tabula.git
cd tabula

gem install bundler -v 1.17.3
bundle install
jruby -S jbundle install
```

```bash
jruby -G -r jbundler -S rackup
```

```bash
TABULA_DATA_DIR="/tmp/tabula" \
TABULA_DEBUG=1 \
jruby -G -r jbundler -S rackup
```

--------------------------------

### Install Tabula via Snap (Linux)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Installs the Tabula package on Linux systems that support snap packages. This is a convenient way to get Tabula running quickly.

```bash
sudo snap install tabula
```

--------------------------------

### Tabula Usage Instructions

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Provides a step-by-step guide on how to use Tabula to extract data from PDF files, including selection and download processes.

```html
<div class="container">
  <div class="jumbotron help">
    <h3 name="howto">How to Use Tabula</h3>
    <ol>
      <li>Upload a PDF file containing a data table.</li>
      <li>Select the table by clicking the top left corner of a table and dragging the mouse to the bottom right corner, until all of the data is included in the shaded selection area.</li>
      <li>A window will then appear containing your data. Inspect the data to make sure it looks correct. If data is missing, you may have to slightly expand your selection.</li>
      <li>Click the Download button.</li>
      <li>Now you can work with your data as text file or a spreadsheet rather than a PDF! <br> (You can open the downloaded file in Microsoft Excel or the free <a href="http://www.libreoffice.org/discover/calc/">LibreOffice Calc</a>)</li>
    </ol>
    <p>Note: Tabula only works on text-based PDFs, not scanned documents.</p>
  </div>
</div>
```

--------------------------------

### Install Unreleased tabula-java JAR to Local Maven Repository

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

This snippet demonstrates how to install a local snapshot version of tabula-java into the Maven repository, which is necessary for developing against unreleased versions of the Java component.

```bash
mvn install:install-file -Dfile=target/tabula-<version>-SNAPSHOT.jar -DgroupId=technology.tabula -DartifactId=tabula -Dversion=<version>-SNAPSHOT -Dpackaging=jar -DpomFile=pom.xml
```

--------------------------------

### Tabula Troubleshooting Guide

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Addresses common issues encountered when using Tabula, such as image-based PDFs, column merging, layout problems, and performance.

```html
<div class="container">
  <div class="jumbotron help">
    <h3 name="trouble">Having trouble with Tabula?</h3>
    <ol>
      <li><strong>Tabula said "Sorry, your PDF file is image-based" -- what does that mean?</strong> Your PDF does not have any embedded text. It might have been scanned from paper. Tabula is not able to extract any data from image-based PDFs. You can try OCRing the PDF with a tool like Adobe Acrobat Pro (paid), Tesseract, <a href="http://www.tobias-elze.de/pdfsandwich/">PDFSandwich</a> (Mac/Linux, free) or <a href="https://code.google.com/p/lime-ocr/">Lime OCR</a> (Windows, free) and then trying Tabula again.</li>
      <li><strong>Some columns of my table are combined. What can I do?</strong> Tabula sometimes uses "streams" of whitespace to recreate your table's structure. If headers span multiple columns, they're probably causing a problem. Try excluding them from your selection (or selecting them separately). </li>
      <li><strong>Some columns of my table are combined. And the headers aren't the problem! What <em>else</em> can I do?</strong> Tabula has two extraction methods. It tries to guess which one is right for document, but it's wrong sometimes. Try selecting the other (of "stream" and "lattice"), on the left in extraction mode, to see if that fixes the problem.</li>
      <li><strong>Tabula helps, but my extracted data isn't in the layout I want! How can I fix <em>that</em>?</strong> Tabula tries to recreate the table structure of the original document. You can think of Tabula as a data <em>extraction</em> tool rather than a data <em>transformation</em> tool. If you want to clean and transform your exported CSV or TSV, tools such as <a href="http://openrefine.org/">OpenRefine</a> or a spreadsheet program might be a good place to start.</li>
      <li><strong>Tabula's taking too long!</strong> Sorry! Tabula has to do a lot of weird math to reconstruct your table. Tabula's command-line counterpart, <a href="https://www.github.com/tabulapdf/tabula-extractor">tabula-extractor</a> is faster, but a little harder to use. You might give it a try.</li>
    </ol>
  </div>
</div>
```

--------------------------------

### Download and Verify Tabula JAR (Docker)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Steps to download a specific version of the Tabula JAR file and verify its integrity using a SHA256 checksum. This is part of the Docker Compose setup process.

```bash
mkdir -p /opt/docker/tabulapdf
cd /opt/docker/tabulapdf
wget https://github.com/tabulapdf/tabula/releases/download/v1.2.1/tabula-jar-1.2.1.zip
sha256sum tabula-jar-1.2.1.zip
unzip tabula-jar-1.2.1.zip
```

--------------------------------

### Tabula Docker Compose Configuration

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

A Docker Compose configuration file for running Tabula using an Amazon Corretto Java image. This setup allows for easy deployment and management of Tabula in a containerized environment.

```yaml
services:
  tabulapdf:
    image: amazoncorretto:17
    container_name: tabulapdf-app
    command: >
      java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -Dwarbler.port=8080 -Dtabula.openBrowser=false -jar /app/tabula.jar
    volumes:
      - ./tabula:/app
    ports:
      - "8080:8080"
```

--------------------------------

### Build Windows Packaged Application

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Instructions for building a portable zip archive for Windows users. This involves downloading Launch4J, placing it in the repository root, and then executing the rake command. It also includes commands for manual building and packaging.

```bash
WEBSERVER_VERSION=9.4.31.v20200723 MAVEN_REPO=https://repo1.maven.org/maven2 rake windows
```

```bash
# (from the root directory of the repo)
WEBSERVER_VERSION=9.4.31.v20200723 MAVEN_REPO=https://repo1.maven.org/maven2 rake war
cd launch4j
ant -f ../build.xml windows
```

```bash
# (from the root directory of the repo)
cd build/windows
mkdir tabula
cp tabula.exe ./tabula/
cp ../tabula.jar ./tabula/
zip -r9 tabula_win.zip tabula
rm -fr tabula
```

--------------------------------

### Build Tabula JAR and Run Packaged Application

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Instructions for building the Tabula JAR file and then running it using Java. This method is closer to testing the packaged application version.

```bash
jruby -G -S rake war
java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -jar build/tabula.jar
```

--------------------------------

### Tabula Project Structure

Source: https://github.com/tabulapdf/tabula/blob/master/CONTRIBUTING.md

Overview of the Tabula project's main repositories and their roles. The 'tabula' repo handles the UI and a Ruby web server, while 'tabula-java' is a Java port for performance.

```APIDOC
Project Structure:

- tabula (UI):
  - Handles the user interface.
  - Includes a small web server written in Ruby.
  - Interfaces between the front-end and the 'tabula-extractor' library.
  - Repository: https://github.com/tabulapdf/tabula

- tabula-java (Java Port):
  - A pure Java implementation of Tabula.
  - Designed for speed and wider usability.
  - Repository: https://github.com/tabulapdf/tabula-java/
```

--------------------------------

### Page Rendering and Image Loading

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Renders a page from a PDF with an image, including logic for handling image loading and display. It also includes elements for page navigation and deletion.

```HTML
<span class="page-number"><%= number %>. </span> <div class="page" id="page-div-<%= number %>"> <img onload="$(this).data('loaded', 'loaded');" src="<%= image_url %>" draggable="false" unselectable="on" > <!-- unselectable is for IE/Opera --> </div> <a href="#page-<%= number %>"><img src="<%= image_url %>"></a> <div class="remove"> <span class="glyphicon glyphicon-remove delete-page"></span> <!-- <span title="rotate this page right" class="icon-repeat rotate-left"></span> <span title="rotate this page left" class="icon-repeat flip rotate-right"></span> --> </div> <p><%= number %></p>
```

--------------------------------

### Build macOS Packaged Application

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Command to build a portable zip archive for macOS users. It specifies the webserver version and Maven repository URL, and notes the inclusion of a bundled Java runtime for compatibility.

```bash
WEBSERVER_VERSION=9.4.31.v20200723 MAVEN_REPO=https://repo1.maven.org/maven2 rake macosx
```

--------------------------------

### Build Windows Executable using Ant

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Manual build process for the Windows executable using Ant, after building the WAR file. This is an alternative to the rake command for Windows builds.

```xml
ant -f ../build.xml windows
```

--------------------------------

### Tabula Vendor Scripts

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Includes essential JavaScript files for Tabula's functionality, such as handling uploads and table sorting.

```javascript
<nestedscript type="text/javascript" src="js/vendor/upload-group.js"></nestedscript>
<nestedscript type="text/javascript" src="js/vendor/jquery.tablesorter.min.js"></nestedscript>
```

--------------------------------

### HTML Structure for My Saved Templates Page

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This HTML snippet defines the header and introductory text for the 'My Saved Templates' page. It includes a main heading and a descriptive paragraph, setting the context for the user's saved templates.

```html
<div class="container">
  <div class="jumbotron help">
    <h1>My Saved Templates</h1>
    <p style="font-size: small;">If you have several PDFs with
```

--------------------------------

### Revision and Alternate Extraction Guidance

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Provides guidance to users on how to revise their cell selections or choose an alternate extraction method if the initial data extraction is incorrect.

```HTML
<h4>Is the extracted data incorrect?</h4> <p>You can revise your selected cells or try an alternate extraction method.</p> <h5>Revise Selected Cells</h5> <p>Data has been extracted from the cells you selected in the previous step. You can revise your selection(s) to add or remove cells.</p> <p> <button type="button" class="btn btn-default" id="revise-selections"><span class="glyphicon glyphicon-arrow-left"></span> Revise selection(s)</button> </p>
```

--------------------------------

### HTML Structure for About Tabula Section

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This HTML snippet defines the 'About Tabula' section, providing information about the project's purpose, target audience, technical details (text-based PDFs vs. scanned), security considerations, user base, credits, and design information. It uses standard HTML tags for content presentation.

```html
<div class="container">
  <div class="jumbotron about">
    <h1>About Tabula</h1>
    <p>Tabula is a tool for liberating data tables trapped inside PDF files.</p>
    <p>Tabula was created by journalists for journalists and anyone else working with data locked away in PDFs. Tabula will always be free and open source.</p>
    <p>If you’ve ever tried to do anything with data provided to you in PDFs, you know how painful it is — there's no easy way to copy-and-paste rows of data out of PDF files. Tabula allows you to extract that data into a CSV or Microsoft Excel spreadsheet using a simple, easy-to-use interface. Tabula works on Mac, Windows and Linux.</p>
    <p>Caveat: Tabula only works on text-based PDFs, not scanned documents. If you can click-and-drag to select text in your table in a PDF viewer (even if the output is unorganized trash), then your PDF is text-based and Tabula should work.</p>
    <p><strong>Security Concerns?</strong> Tabula is designed with security in mind. Your PDF and the extracted data never touch the net -- when you use Tabula, as long as your browser's URL bar says "localhost" or "127.0.0.1", all processing takes place on your local machine. Tabula does download a list of Tabula versions from our server to alert you if Tabula has been updated (and we use hits to that list to count how often Tabula is being used); it also downloads a few badges and assets from the web.</p>
    <h2>Who Uses Tabula?</h2>
    <p>Tabula is used to power investigative reporting at news organizations of all sizes, including ProPublica, The Times of London, Foreign Policy, La Nación (Argentina) and the St. Paul (MN) Pioneer Press.</p>
    <p>Grassroots organizations like SchoolCuts.org rely on Tabula to turn clunky documents into human-friendly public resources.</p>
    <p>And researchers of all kinds use Tabula to turn PDF reports into Excel spreadsheets, CSVs, and JSON files for use in analysis and database applications.</p>
    <h2>Credits</h2>
    <p>Tabula was created by <a href="https://jazzido.com/" target="_blank">Manuel Aristarán</a>, <a href="https://mike.tig.as/" target="_blank">Mike Tigas</a> and <a href="http://jeremybmerrill.com/" target="_blank">Jeremy B. Merrill</a> with the support of <a href="https://www.propublica.org">ProPublica</a>, <a href="http://blogs.lanacion.com.ar/data/">La Nación DATA</a>, <a href="https://opennews.org/">Knight-Mozilla OpenNews</a>, <a href="http://www.nytimes.com">The New York Times</a>, <a href="http://knightlab.northwestern.edu/">Northwestern University Knight Lab</a>, <a href="http://www.knightfoundation.org/">The Knight Foundation</a>, and <a href="https://shuttleworthfoundation.org/">The Shuttleworth Foundation</a>. Tabula was designed by <a href="http://jasondas.com">Jason Das.</a></p>
  </div>
</div>
```

--------------------------------

### JavaScript File Upload and Table Utilities

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This snippet includes JavaScript functions for handling file uploads using Bootstrap, sorting tables with jQuery Tablesorter, and managing loading indicators with Spin.js. It's designed for interactive user interfaces.

```javascript
nestedscript type="text/javascript" src="js/vendor/upload-group.js"
nestedscript type="text/javascript" src="js/vendor/jquery.tablesorter.min.js"
nestedscript type="text/javascript" src="js/vendor/spin.min.js"
```

--------------------------------

### Tabula Template Library

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Displays saved Tabula templates with options to remove and download them. Includes a form for importing new templates.

```html
<div id="template-library-container">
  <div id="file-list-container">
    <table class="table file-list" id="templateTable">
      <thead>
        <tr>
          <th>Template Name</th>
          <th>Selection Count</th>
          <th>Page Count</th>
          <th>Date Added</th>
          <th>Remove</th>
          <th>Download</th>
        </tr>
      </thead>
      <tbody id="saved-templates-container">
      </tbody>
    </table>
  </div>
</div>
<div id="template-upload-form-container">
  <h2>Import one or more Tabula Templates</h2>
  <p style="font-size: small;">Once you save a Tabula Template, it'll appear here.</p>
  <form id="uploadtemplate" action="templates/upload.json" method="post" enctype="multipart/form-data" class="form-inline">
    <div class="input-group">
      <span class="input-group-btn">
        <span class="btn btn-primary btn-file">
          Browse&hellip;
          <input type="file" id="file" name="files\[\]" multiple accept="application/json">
        </span>
      </span>
      <input type="text" class="form-control" readonly>
    </div>
    <input type="hidden" name="_dontcare">
    <button type="submit" class="btn btn-default">Import</button>
  </form>
</div>
```

--------------------------------

### Run Tabula JAR

Source: https://github.com/tabulapdf/tabula/blob/master/build/dist-README.txt

Command to run the Tabula JAR file from the terminal. This command specifies encoding, memory allocation, and the JAR file to execute. It also shows how to change the default port.

```shell
java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -jar tabula.jar
```

```shell
java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -Dwarbler.port=9999 -jar tabula.jar
```

```shell
java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -Dtabula.openBrowser=true -jar tabula.jar
```

--------------------------------

### Build WAR file

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Command to build a WAR file, which is a prerequisite for building packaged applications on different platforms.

```bash
WEBSERVER_VERSION=9.4.31.v20200723 MAVEN_REPO=https://repo1.maven.org/maven2 rake war
```

--------------------------------

### Tabula-Java CLI Usage

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Demonstrates how to use the tabula-java command-line interface for automating PDF table extraction. This is part of incorporating Tabula into JVM projects.

```APIDOC
tabula-java CLI:

Usage: Incorporate tabula-java JAR into JVM projects (Java, Scala, Clojure) for table extraction.

Refer to the tabula-java repository for detailed CLI usage and script automation instructions.
```

--------------------------------

### Run Tabula JAR (Linux/Other)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Executes the Tabula JAR file from the command line. This method is suitable for Linux and other platforms where a JAR file can be run. It includes options for encoding, memory allocation, and port configuration.

```java
java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -jar tabula.jar
```

```java
java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -Dtabula.openBrowser=true -jar tabula.jar
```

```java
java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -Dwarbler.port=9999 -jar tabula.jar
```

--------------------------------

### JavaScript Libraries for Tabula

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This section lists essential JavaScript libraries used by the Tabula project for various functionalities, including UI elements, file handling, and potentially data manipulation.

```HTML
<nestedscript type="text/javascript" src="js/vendor/spin.min.js"></nestedscript>
<nestedscript type="text/javascript" src="js/resizableSelection.js"></nestedscript>
<nestedscript type="text/javascript" src="js/rectangularSelector.js"></nestedscript>
<nestedscript type="text/javascript" src="js/vendor/ZeroClipboard.min.js"></nestedscript>
<!-- <nestedscript type="text/javascript" src="js/debug_pdf_view.js"></nestedscript> -->
```

--------------------------------

### Error Handling for Failed Uploads

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This section displays information about failed uploads, including the original filename, failure message, and any associated warnings. It provides a link to the original PDF file.

```HTML
<h4>Failed Uploads</h4>
<ol id="failed-uploads">
</ol>
<a href='/pdf/<%= id %>'><%= original_filename %></a>: <%= failure_message %>
<h5><%= filename %></h5>
<span id="message"><%= message %></span>
<ul class="list-unstyled">
  <% for(var warning in warnings) { %>
    <li class="text-danger">Warning: <%= warnings[warning] %></li>
  <% } %>
</ul>
```

--------------------------------

### Template Management and Selection

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Provides functionality for managing and applying templates to PDF extractions. This includes saving current selections as a template and loading existing templates.

```HTML
<span class="filename"><%= original_filename %></span> <div class="dropdown" <%= disable_load_template %> style="display: inline;"> <button type="button" class="dropdown-toggle btn btn-info" data-toggle="dropdown" href="#" ><span class="glyphicon glyphicon-import" title="You may only load a template if there are no selections active in your PDF."></span>Templates</button> <div id="template-dropdown-container" class="dropdown-menu"> <ul> <li> <a href="javascript:void(0)"><button type="button" id="save-template" class="btn btn-link" style="min-width: 155px;" <%= disable_save_template %>> <span class="button-text">Save Selections as Template</span> <span class="glyphicon glyphicon-export"></span></button></a> </li> </ul> <p style="margin-left:5px;">Load templates:</p> <div id="template-dropdown-templates-list-container"> </div> </div> </div>
```

--------------------------------

### Troubleshooting Tabula on Mac (Gatekeeper)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Provides steps to resolve the 'Tabula is damaged and can't be opened' error on macOS by adjusting Gatekeeper settings. This involves right-clicking the application and selecting 'Open' to bypass security warnings for unidentified developers.

```APIDOC
Gatekeeper Troubleshooting (Mac):

Issue: "Tabula is damaged and can't be opened" on Mac OS X 10.8 or later.

Solution:
1. Right-click on Tabula.app.
2. Select 'Open' from the context menu.
3. Confirm opening the application from an unidentified developer.

Note: This action remembers your choice and prevents future prompts. Refer to OS X Gatekeeper documentation for more details.
```

--------------------------------

### Tabula Template Upload Form

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Handles the import of Tabula templates via a file upload form, specifying the target URL and accepted file types.

```javascript
<!-- we are using this here: http://www.abeautifulsite.net/whipping-file-inputs-into-shape-with-bootstrap-3/ -->
<!-- fix for the fact that IE11 is trash https://blog.yorkxin.org/posts/2014/02/06/ajax-with-formdata-is-broken-on-ie10-ie11/ -->
```

--------------------------------

### R Bindings for Tabula-Java (tabulizer)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Provides information on the 'tabulizer' package, which offers R bindings for tabula-java. This allows R users to leverage Tabula's PDF table extraction capabilities.

```APIDOC
R Bindings (tabulizer):

Description: Community-supported R bindings for tabula-java.

Repository: https://github.com/leeper/tabulizer

Usage: Integrate tabula-java functionality within R projects.
```

--------------------------------

### Extraction Method Selection

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Allows users to choose between different data extraction methods (Stream and Lattice) to improve accuracy when data is not mapped correctly.

```HTML
<p>The current preview uses the <strong>Stream</strong> extraction method. If the data is not mapped to the correct cells, try the <strong>Lattice</strong> method instead.</p> <div class="btn-group" data-toggle="buttons-radio" id="extraction-method-btns" <%=disableExtractionMethodButtons%> > <button type="button" id="original-method-btn" class="btn btn-default extraction-method-btn" data-method="original" ><span class="glyphicon glyphicon-th stream"></span> Stream</button> <button type="button" id="spreadsheet-method-btn" class="btn btn-default extra
```

--------------------------------

### JRuby Bindings for Tabula-Java (tabula-extractor - DEPRECATED)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Mentions the deprecated 'tabula-extractor' package, which previously provided JRuby bindings for tabula-java. Users are advised to seek alternative solutions if needed.

```APIDOC
JRuby Bindings (tabula-extractor - DEPRECATED):

Description: Previously provided JRuby bindings for tabula-java.

Repository: https://github.com/tabulapdf/tabula-extractor/

Note: This package is deprecated.
```

--------------------------------

### Update and Notification Alerts

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This snippet shows the HTML structure for displaying update notifications and custom alerts to the user. These alerts use Bootstrap's alert classes and include dismiss buttons.

```HTML
<div class="alert alert-warning alert-dismissable" id="update-alert">
  <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
  <strong>New version!</strong> <a href="<%= new_release.html_url %>">Tabula <span id="new-version"><%= new_release.name %></span></a> is available (you have <span id="installed-version"><%= api_version %></span>)
</div>
<div class="alert alert-warning alert-dismissable" id="custom-alert">
  <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
  <strong><%= notification.name %></strong> <span class="custom-alert-body"><%= notification.body %></span>
</div>
```

--------------------------------

### Data Export Form

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Handles the submission of extracted data for export. It includes options for selecting the export format (CSV, TSV, JSON, etc.) and triggers the download process.

```HTML
<form id="download-form" action="pdf/<%=pdf_id%>/data?format=csv" method="post"> <div id="hidden-fields"> <input type='hidden' class='data-query' name='new_filename' value='<%=original_filename%>' > <input type='hidden' class='data-query' name='coords' value='<%=list_of_coords%>' > </div> <!-- <input class="filename" name="new_filename" value="<%= new_filename || original_filename %>"></input> --> <span class="filename"><%= original_filename %></span> <label for="format">Export Format:</label> <select name="format" <%=disableIfNoData%> class="form-control format"> <option value="csv">CSV</option> <option value="tsv">TSV</option> <option value="bbox">JSON (dimensions)</option> <option value="json">JSON (data)</option> <!-- <option value="&#x1F4A9;SV">&#x1F4A9;SV</option> --> <option value="zip">zip of CSVs</option> <!-- <option value="xml">XML</option> --> <option value="script">Script</option> </select> <button type="submit" <%=disableIfNoData%> id="download-data" class="btn btn-default" data-action='pdf/<%=pdf_id%>/data'> <span class="glyphicon glyphicon-refresh"></span> <span class="glyphicon glyphicon-download"></span> Export </button> <button type="button" id="copy-csv-to-clipboard" class="btn btn-default" <%=disableIfNoData%> <%=copyDisabled%> > <span class="glyphicon glyphicon-paperclip"></span> <span class="clipboard-text">Copy to Clipboard</span> </button> </form>
```

--------------------------------

### Python Bindings for Tabula-Java (tabula-py)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Introduces the 'tabula-py' package, offering Python bindings for tabula-java. This allows Python developers to utilize Tabula's PDF table extraction features.

```APIDOC
Python Bindings (tabula-py):

Description: Community-supported Python bindings for tabula-java.

Repository: https://github.com/chezou/tabula-py

Usage: Integrate tabula-java functionality within Python projects.
```

--------------------------------

### File Upload Form

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This HTML form is used for uploading PDF files to the Tabula application. It utilizes Bootstrap for styling and includes input fields for file selection and submission. It also handles potential error messages and progress updates.

```HTML
<div class="container">
  <div class="jumbotron">
    <div id="new-version-alert"></div>
    <div id="notification-alert"></div>
    <div id="upload-form-container">
      <h4>Import one or more PDFs</h4>
      <form id="upload" action="upload.json" method="post" enctype="multipart/form-data" class="form-inline">
        <div class="input-group">
          <!-- we are using this here: http://www.abeautifulsite.net/whipping-file-inputs-into-shape-with-bootstrap-3/ -->
          <span class="input-group-btn">
            <span class="btn btn-primary btn-file">
              Browse&hellip;
              <input type="file" id="file" name="files[]" multiple accept="application/pdf">
            </span>
          </span>
          <input type="text" class="form-control" readonly>
        </div>
        <!-- fix for the fact that IE11 is trash https://blog.yorkxin.org/posts/2014/02/06/ajax-with-formdata-is-broken-on-ie10-ie11/ -->
        <input type="hidden" name="_dontcare">
        <button type="submit" class="btn btn-default">Import</button>
      </form>
    </div>
    <div id="progress-container">
    </div>
    <hr>
    <div id="library-container">
      <h4>Imported PDFs</h4>
      <div id="file-list-container">
        <table class="table file-list tablesorter" id="fileTable">
          <thead>
            <tr>
              <th>File Name</th>
              <th style="min-width: 100px;">Size</th>
              <th>Pages</th>
              <th style="min-width: 150px;">Date Added</th>
              <th>Remove</th>
              <th>Process</th>
            </tr>
          </thead>
          <tbody id="uploaded-files-container">
          </tbody>
        </table>
      </div>
    </div>
    <hr />
    <p style="text-size: small;">If you have several PDFs with the same layout, you can select the appropriate regions once, then save the selections as a Tabula Template from the Select Tables page. If someone has shared a template with you, you can upload</p>
  </div>
</div>
```

--------------------------------

### Progress Bar Display

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This code snippet illustrates how the upload progress is visually represented using an HTML progress bar. It dynamically updates the width of the progress bar based on the completion percentage.

```HTML
<div class="progress">
  <div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: <%= pct_complete %>%;"><span class="sr-only"> <%= pct_complete %>% Complete </span></div>
</div>
```

--------------------------------

### Node.js Bindings for Tabula-Java (tabula-js)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Details the 'tabula-js' package, which provides Node.js bindings for tabula-java. This enables JavaScript developers to use Tabula for PDF table extraction in Node.js environments.

```APIDOC
Node.js Bindings (tabula-js):

Description: Community-supported Node.js bindings for tabula-java.

Repository: https://github.com/ezodude/tabula-js

Usage: Integrate tabula-java functionality within Node.js projects.
```

--------------------------------

### Troubleshooting Tabula Encoding Issues (Windows)

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Details how to fix 'Encoding::CompatibilityError: incompatible character encodings' on Windows. This involves changing the Command Prompt's codepage to Unicode (65001) before running Tabula.

```APIDOC
Encoding Troubleshooting (Windows):

Issue: org.jruby.exceptions.RaiseException: (Encoding::CompatibilityError) incompatible character encodings.

Solution:
1. Open Command Prompt.
2. Navigate to Tabula's directory (e.g., `cd C:\Users\Username\Downloads`).
3. Change codepage: `chcp 65001`.
4. Run Tabula: `tabula.exe`.

Note: These commands only affect the current terminal session and Tabula's execution.
```

--------------------------------

### PDF Data Display Logic

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This snippet demonstrates the client-side logic for rendering extracted tabular data from PDFs. It handles cases where data is available, loading, an error occurs, or no data is found. It uses a templating engine (likely Underscore.js) to iterate through tables and rows.

```HTML
<% if(data.length){ %> <% \_(data).each(function(table){ %> <table class="table table-bordered extracted-data"> <tbody> <% \_(table).each(function(row){ %> <tr> <% \_(row).each(function(cell){ %> <td><%= cell %></td> <% }) %> </tr> <% }) %> </tbody> </table> <% }) %> <% } else if (loading) { %> <div class="alert alert-success" id="loading"><span id="spinner"></span><span style="position: relative; left: 16px; font-size: 24px;">Loading...</span></div> <% } else if (error_message) { %> <p><strong>Tabula</strong> couldn't finish processing your request. <!-- We'd appreciate if you could <a href="https://github.com/jazzido/tabula/issues/new">report this error in our issue tracker</a>. If possible, please include a link to the document that caused the error and the text below: --></p> <pre class="error"><%= error_message %></pre> <% } else { %> <span class="no-data">No data.</span> <% } %>
```

--------------------------------

### LSD Line Segment Detector (C)

Source: https://github.com/tabulapdf/tabula/blob/master/build/dist-LICENSE.txt

The Line Segment Detector (LSD) is a C implementation for detecting line segments in digital images. It is based on the publication 'LSD: a Line Segment Detector' and is distributed under the GNU Affero General Public License version 3.

```C
/*
  LSD - Line Segment Detector on digital images

  This code is part of the following publication and was subject
  to peer review:

    "LSD: a Line Segment Detector" by Rafael Grompone von Gioi,
    Jeremie Jakubowicz, Jean-Michel Morel, and Gregory Randall,
    Image Processing On Line, 2012. DOI:10.5201/ipol.2012.gjmr-lsd
    http://dx.doi.org/10.5201/ipol.2012.gjmr-lsd

  Copyright (c) 2007-2011 rafael grompone von gioi <grompone@gmail.com>

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as
  published by the Free Software Foundation, either version 3 of the
  License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License
  along with this program. If not, see <http://www.gnu.org/licenses/>.

  Additional permission under GNU GPL version 3 section 7

  If you modify this Program, or any covered work, by linking or
  combining it with Tabula (or a modified version of that library),
  containing parts covered by the terms of "MIT License", the
  licensors of this Program grant you additional permission to convey
  the resulting work. Corresponding Source for a non-source form of
  such a combination shall include the source code for the parts of
  Tabula used as well as that of the covered work.
*/
```

--------------------------------

### PDFBox Dependency (Java)

Source: https://github.com/tabulapdf/tabula/blob/master/build/dist-LICENSE.txt

The tabula-extractor component utilizes the PDFBox library, specifically target/pdfbox-app-1.8.0.jar. PDFBox is developed at The Apache Software Foundation and is licensed under the Apache License, Version 2.0.

```Java
/*
This product includes software (target/pdfbox-app-1.8.0.jar) developed at
The Apache Software Foundation (http://www.apache.org/). Licensed under the
Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0).
*/
```

--------------------------------

### Selection Control and Data Preview

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

Offers controls for managing cell selections within the PDF, including clearing all selections, restoring auto-detected tables, and previewing extracted data.

```HTML
<a href="javascript:void(0)"><button type="button" id="clear-all-selections" class="btn btn-default" <%= disable_clear_all_selections %>><span class="glyphicon glyphicon-remove-circle"></span> Clear All Selections</button></a> <button id="restore-detected-tables" type="button" class="btn btn-default <%= restore_detected_tables %>" <%= disabled_if_there_are_selections %>><span class="glyphicon glyphicon-flash"></span><span class="glyphicon glyphicon-refresh"></span> Autodetect Tables</button> <span style="float: right"> <a href="javascript:void(0)"><button type="button" id="all-data" class="btn btn-success" <%= disable_download_all %>><span class="glyphicon glyphicon-list-alt"></span> Preview & Export Extracted Data</button></a> </span>
```

--------------------------------

### HTML Table Row for Saved Template Management

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This HTML snippet defines a table row for managing saved templates. It displays the template name, allows editing, shows selection and page counts, upload time, deletion, and a download button for the template's JSON configuration. It utilizes embedded JavaScript expressions for dynamic data.

```html
<td><span class="template-name"><%= name %></span> <a href="javascript:"><span data-name=<%= name %> data-templateid=<%= id %> class="glyphicon glyphicon-pencil edit-template-name"></span></a></td>
<td><%= selection_count %> selection<%= selection_count == "!" ? '' : 's' %></td>
<td><%= page_count || '??' %></td>
<td><%= new Date(parseInt(time) * 1000).toUTCString().slice(5, -7) %></td>
<td><a href="javascript:"><span data-name=<%= name %> data-templateid=<%= id %> class="glyphicon glyphicon-remove delete-template"></span></a></td>
<td>
  <form class="template-download-form" action="templates/<%= id %>.json" method="get" style="margin-bottom: 0;">
    <button type="submit" class="btn btn-default" data-action=>
      <span class="glyphicon glyphicon-download-alt download-template"></span> Download
    </button>
  </form>
</td>
```

--------------------------------

### HTML Structure for Upload Error Message

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This HTML snippet provides a structure for displaying an upload error message to the user. It includes a heading, a paragraph to display the specific error message dynamically using an embedded JavaScript expression.

```html
<div class="container-fluid">
  <div class="row-fluid">
    <div class="span6 offset3">
      <div class="hero-unit">
        <h1>Tabula</h1>
        <h2>Upload Error</h2>
        <p><span id="message"><%= message %></span></p>
      </div>
    </div>
  </div>
</div>
```

--------------------------------

### HTML Table Row for PDF Data Display

Source: https://github.com/tabulapdf/tabula/blob/master/webapp/index.html

This HTML snippet defines a table row structure for displaying information about uploaded PDFs. It includes links to view the PDF, its size, page count, upload time, and options to delete or extract data. It uses embedded JavaScript expressions for dynamic content.

```html
<td><a href='/pdf/<%= id %>'><%= original_filename %></a></td>
<td><%= size ? Math.floor(size / 1024) : '??' %> kB</td>
<td><%= page_count || '??' %></td>
<td><%= new Date(parseInt(time) * 1000).toUTCString().slice(5, -7) %></td>
<td><a href="javascript:"><span data-filename=<%= original_filename %> data-pdfid=<%= id %> class="glyphicon glyphicon-remove delete-pdf"></span></a></td>
<td><a href="pdf/<%= id %>"><button type="button" class="btn btn-sm btn-success">Extract Data</button></a></td>
```

--------------------------------

### Changing Tabula's Default Port

Source: https://github.com/tabulapdf/tabula/blob/master/README.md

Explains how to change the default port (8080) Tabula uses if it conflicts with other applications. This is done by specifying the `warbler.port` property when running Tabula from the terminal.

```APIDOC
Port Conflict Resolution:

Issue: Another program uses port 8080, preventing Tabula from starting or causing incorrect loading in the browser.

Solution:
Run Tabula from the terminal with a custom port using the `warbler.port` property:

`java -Dfile.encoding=utf-8 -Xms256M -Xmx1024M -Dwarbler.port=9999 -jar tabula.jar`

Replace `9999` with your desired port number.
```