Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

FromThePage is a wiki-like application for crowdsourcing transcription of handwritten documents.

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README
FromThePage is an open-source tool that allows volunteers to collaborate to transcribe handwritten documents.

Features

    * Wiki-style Editing: Users add or edit transcriptions using simple, wiki-style syntax on one side of the screen while viewing a scanned image of the manuscript page on the other side.
    * Version Control: Changes to each page transcription are recorded and may be viewed to follow the edit history of a page.
    * Wikilinks: Subjects mentioned within the document may are indexed via simple wikilinks within the transcription. Users can annotate subjects with full subject articles.
    * Presentation: Readers can view transcriptions in a multi-page format or alongside page images. They can also read all the pages that mention a subject
    * Automatic Markup: FromThePage can suggest wikilinks to editors by mining previously edited transcriptions. This helps insure editorial consistency and vastly reduces the amount of effort involved in markup.
    * Internet Archive integration: FromThePage can be pointed at manuscripts hosted on Archive.org. It will import the page structure and any printed page titles into its native format for transcription, while serving page images from the Internet Archive.

License
FromThePage is currently issued under the Affero GPL. This license remains controversial, however, so we are trying to preserve the option to dual-license the code.

Platform
FromThePage has been run successfully under both Linux and Windows. It currently requires Ruby on Rails version 2.3.5 and the RMagick, hpricot, will_paginate, and OAI gems.

Installation

Install Ruby, rubygems, Apache, ImageMagick and MySQL
These should be fairly standard unless you’re using Fedora, in which case see https://github.com/benwbrum/fromthepage/wiki/Installing-Rails-on-Fedora-13. Most hosting providers (like hostingrails.com) will have these installed already.

Install required gems
gem install hpricot oai will_paginate rmagick
gem install -v 2.3.5 rails

Install Graphviz
apt-get install graphviz (or see the graphviz documentation at http://www.graphviz.org/)

Configure MySQL
Create a database and user account for FromThePage to use.

Install FromThePage
First install git.

Then
git clone git://github.com/benwbrum/fromthepage.git

Next, point the DocumentRoot of your webserver to the public subdirectory of the FromThePage installation you just checked out.

Then update the config/database.yml file to point to the MySQL user account and database you created above.

Finally, run
rake db:migrate
to load the schema definition into the database account. 
Something went wrong with that request. Please try again.