Kristin Jensen: add link to Juxta WS on TEI Wiki

2013-03-20T20:40:13Z

add link to Juxta WS on TEI Wiki

Kristin Jensen: add credits under additional notes

2013-03-20T18:55:33Z

add credits under additional notes

Kristin Jensen: add link to Versioning Machine

2013-03-19T19:43:25Z

add link to Versioning Machine

Kristin Jensen: create Juxta Commons page

2013-03-19T19:38:24Z

create Juxta Commons page

New page

[[Category:Tools]]

[[Category:Publishing and delivery tools]]
[[Category:Analysis tools]]
[[Category:Interfaces]]

[[Category:Comparing]]

== Synopsis ==
The Juxta family of software (Juxta, Juxta WS, and Juxta Commons) allows you to compare and collate versions of the same textual work. [http://www.juxtacommons.org Juxta Commons] is an online space powered by the Juxta Web Service that lets you collate sets and share visualizations with your peers. Development of Juxta Commons was sponsored by [http://www.nines.org NINES].

== Features ==
With a free account, users may upload two or more versions of a text, collate them, then view and share visualizations of the collation results. Visualizations can be kept private or shared online with a unique URL or embeddable iframe.

A collation can also be exported as TEI with parallel segmented markup or as a base text with apparatus.

Juxta Commons accepts upload of a variety of file formats with textual content: plain text, XML (with special handling for TEI), HTML, Microsoft Word (.doc and .docx), OpenOffice (.doc), RTF, PDF, ePUB, WikiMedia markup (with special handling for Wikipedia article revisions). Text will be scraped out of the files; images are not collated.

== User commentary ==
'''Please sign all comments.'''

== System requirements ==
Juxta Commons is a web-based application. It has been tested on Chrome v. 25, Firefox v. 18 and v. 19, Internet Explorer 8 and 9, and Safari v. 6.

== Source code and licensing ==
As of this writing (March 2013), Juxta Commons is closed source. Juxta Commons is powered by the Juxta Web Service, which is open source software [https://github.com/performant-software/juxta-service available on GitHub].

== Support for TEI ==
Juxta Commons supports TEI in several ways:

Juxta Commons accepts all types of XML files for upload and has basic defaults for working with TEI. Juxta Commons uses XSL transformations to prepare XML files as witnesses, filtering out the XML tags to produce a clean text for comparison. There is a default filter for TEI encoded texts which also excludes the contents of the TEI header and front matter; this filter can be customized to include or exclude the contents of any given tags. The default or custom filter may be viewed and exported as XSLT. The note and page break (pb) tags receive special handling, and are used to display the note contents and the location of page breaks in one of the collation visualizations.

When uploading an XML source file, the user has the opportunity to flag it as containing TEI parallel segmentation markup. If this flag is set, Juxta will automatically extract all variant witnesses from the parallel segmentation apparatus and create a comparison set showing the differences between them.

Juxta Commons can also export any comparison set in TEI parallel segmentation markup, regardless of the original format of the source files. It should be noted that the parallel segmentation export is constructed from the stripped-down witness texts; TEI markup from the original source files will not be reproduced in the parallel segmentation export.

The Versioning Machine has been integrated into Juxta Commons as an alternative visualization; when the user opts to view the Versioning Machine visualization of a comparison set, Juxta Commons automatically exports its TEI parallel segmentation markup to the Juxta Commons installation of the Versioning Machine.

== Language(s) ==
Juxta Commons is a Ruby on Rails application that provides the user interface and authentication features of the system. It has no collation logic in itself, but is powered by the Juxta Web Service (Juxta WS), with which it communicates by exchanging JSON data over RESTful API calls. Juxta Commons relies heavily upon jQuery, jQuery UI and Raphael to drive the user interface.

Juxta WS is a server-side Java application that exposes a RESTful API to the collation services. It was built upon standard open source frameworks such as Spring and Restlet. It uses XSLT to transform XML source files into witnesses.

The user interface and documentation for Juxta Commons are written entirely in (American) English. Juxta supports collation of texts in any Unicode character set, with the exception of UTF-8 compound characters such as those used in Tibetan and Chinese scripts.

== Documentation ==
An extensive [http://juxtacommons.org/guide user guide] is available on the Juxta Commons site, along with [http://juxtacommons.org/tech_info technical information] and [http://juxtacommons.org/take_tour a gallery of interesting comparison sets].

Video tutorials are [http://vimeo.com/user13781825 available on Vimeo] including [http://vimeo.com/50388096 a basic walkthrough] of the software and a video demonstrating [http://vimeo.com/52722692 the features specifically designed to support work with texts encoded in XML].

== Tech support ==
There is an open [https://groups.google.com/forum/#!forum/juxta-dev Google Group] dedicated to discussing development issues for the Juxta family of software (the original Juxta desktop application, Juxta WS, and Juxta Commons).

== User community ==
Users are invited to tweet about their experiences with Juxta Commons using the [https://twitter.com/search/realtime?q=%23juxtacommons&src=hash hash tag #juxtacommons]. News about Juxta Commons is publicized in the [https://twitter.com/juxtacommons @JuxtaCommons Twitter feed] and on the [http://www.juxtasoftware.org/ Juxta Software blog].

== Sample implementations ==
Links to numerous sample sets have been collected in [http://www.juxtasoftware.org/using-juxta-in-the-classroom-scholars-lab-presentation/ a blog entry on juxtasoftware.org].

== Current version number and date of release ==
Current version number: 1.7.9
Date of release: March 2013

== History of versions ==
Juxta was originally developed in the early 2000s as a desktop application.

In March of 2012, a beta version of Juxta (1.6.5) was released. This version of the desktop software allowed users to export comparison sets for visualization on the web. The desktop software was most recently released in October 2012 as version 1.7.0; it is [http://www.juxtasoftware.org/download/ available for download from juxtasoftware.org].

In October of 2012, the public beta release of the Juxta Commons website was launched as version 1.7.5.

== How to download or buy ==
Juxta Commons is a free service available on the web. Anyone may sign up for a user account. You do not need to download or purchase the software.

== Additional notes ==

← Older revision		Revision as of 18:55, 20 March 2013
Line 73:		Line 73:

	== Additional notes ==		== Additional notes ==
		+	Juxta Commons is supported by [http://www.nines.org NINES] with development by [http://www.performantsoftware.com Performant Software Solutions LLC].

@@ Line 8: / Line 8: @@
 == Synopsis ==
-The Juxta family of software (Juxta, Juxta WS, and Juxta Commons) allows you to compare and collate versions of the same textual work. [http://www.juxtacommons.org Juxta Commons] is an online space powered by the Juxta Web Service that lets you collate sets and share visualizations with your peers. Development of Juxta Commons was sponsored by [http://www.nines.org NINES].
+The Juxta family of software (Juxta, Juxta WS, and Juxta Commons) allows you to compare and collate versions of the same textual work. [http://www.juxtacommons.org Juxta Commons] is an online space powered by the [[JuxtaWS|Juxta Web Service]] that lets you collate sets and share visualizations with your peers. Development of Juxta Commons was sponsored by [http://www.nines.org NINES].
 == Features ==

@@ Line 35: / Line 35: @@
 Juxta Commons can also export any comparison set in TEI parallel segmentation markup, regardless of the original format of the source files. It should be noted that the parallel segmentation export is constructed from the stripped-down witness texts; TEI markup from the original source files will not be reproduced in the parallel segmentation export.
-The Versioning Machine has been integrated into Juxta Commons as an alternative visualization; when the user opts to view the Versioning Machine visualization of a comparison set, Juxta Commons automatically exports its TEI parallel segmentation markup to the Juxta Commons installation of the Versioning Machine.
+The [http://www.v-machine.org/ Versioning Machine] has been integrated into Juxta Commons as an alternative visualization; when the user opts to view the Versioning Machine visualization of a comparison set, Juxta Commons automatically exports its TEI parallel segmentation markup to the Juxta Commons installation of the Versioning Machine.
 == Language(s) ==

JuxtaCommons - Revision history

Kristin Jensen: add link to Juxta WS on TEI Wiki

Kristin Jensen: add credits under additional notes

Kristin Jensen: add link to Versioning Machine

Kristin Jensen: create Juxta Commons page