-
Notifications
You must be signed in to change notification settings - Fork 4
GettingStarted
The Juxta installation includes four sample collations, which can be accessed from the File menu. Select “File”, then “Open Sample” (File->Open Sample) and then select a JXT file for the sample you wish to view.
The sample collations are:
-
Welcome - a basic demonstration of Juxta’s capabilities, in the form of a welcome text with starter tips for using the software.
-
Damozel - a collation of seven versions of the poem “The Blessed Damozel” by Dante Gabriel Rossetti. Demonstrates the use of Juxta XML files to associate images and milestones with text.
-
Renaissance - a collation of two versions of Walter Pater’s Studies in the History of the Renaissance. Demonstrates the collation of prose texts.
-
Whitman's Leaves of Grass - a collation of three versions of Walt Whitman’s “Leaves of Grass”. The source TEI XML was contributed by the Walt Whitman Archive.
The Display Window, General. Opening a collation displays a list of witness documents on the left (in the Comparison Explorer panel) and on the right a transcription of one of the witness texts as the “base text” (at the beginning, it chooses the first of the listed witnesses). At the top is a menu with a set of standard editing functions for adding and removing witnesses, and for several other operations. Below this menu is a toolbar with a set of icons. Running the mouse over them displays the functions they perform. There is also an input box for entering words to search for in all the texts in the comparison set. See the section on searching below.
The upper panel at the right (Document Panel) displays a transcription of the base text in Collation View by default. The two buttons at the bottom of the Document Panel toggle between Collation View and Comparison View, which displays a side-by-side comparison of texts. The texts for comparison are chosen from two drop-down lists above the Document Panel. The text on the left will be treated as the base text. The lock icon between the drop-down lists (“on” by default) can be clicked to unlock the text transcriptions so they can be independently scrolled.
The lower right panel is an area for displaying additional information about the witness texts and collation. Just below this lower right panel are five buttons that allow you to control which information is displayed in the panel. When Juxta starts, “Source” is the default selection, displaying the source XML or plain text of the transcription currently chosen in the Document Panel. “Images” displays any digital images included in the Juxta XML file (this feature is not available for plain text or TEI files). By default, images are locked to their transcriptions in the Document Panel above, so that scrolling through the transcriptions will call up page images in succession. Images may be unlocked from their transcriptions by clicking the lock button below the panel. Next to the lock button are two buttons for zooming the image view in and out. Next, “Notes” displays your annotations. The lock button at the lower right unlocks the notes display from the transcriptions. The trashcan button deletes the selected note. “Moves” displays all the moves you specify. Clicking on a move scrolls the documents to display the moved text. The trashcan button discards the selected move. (Please see the section below on collating passages that appear out of order.) “Search” displays the results of the last search operation. Clicking on a search item scrolls the texts in the Document Panel to show the item in context.
Collating and Annotating Operations, General. Clicking a witness text in the Comparison Explorer on the left will make it the base text. The box to the left of each witness text can be unchecked to remove it from the collation. The boxes to the right of each witness text visualize (in shades of blue) the global degree of difference between the base text and this witness, with degree of difference signaled by increase in the gradient color difference.
When the Document Panel is in Collation View, a “heat map” is superimposed (in blue) on the base text. Blue highlighting signals degrees of variance between the base text and the witnesses being compared. Clicking on any highlighted area in the heat map displays a list of variants in a box in the right margin. You can also click and drag the mouse to highlight a region and display all of the variants for the highlighted section. Clicking on the star in the pop-up box allows you to enter annotations for that difference.
You can create a new comparison set (File -> New Comparison Set) and then add your own documents (Edit -> Add Document). Juxta recognizes TEI XML, Juxta XML, and plain text. You can also create a parse template for a new XML format the first time you import a file in that format. Loading a document automatically collates it using the current collation settings.
Sharing Your Work. When you are ready to publish your collation and annotations from Juxta, you can output a critical apparatus as an HTML document (File -> Generate Critical Apparatus). You can also save your comparison set (File -> Save or File -> Save As) for later work or for sharing with others who use Juxta. These outputs preserve all annotations added in Juxta.
To share your heat map and side-by-side visualizations with anyone on the web, first visit http://www.juxtacommons.org and sign up for a free account. You can then export your comparison set from the desktop application to Juxta Commons (File → Export to Juxta Web Service or click the globe-with-arrow button on the left of the toolbar). You will be prompted to enter the email address and password for your account on Juxta Commons. This function can also be used to export your work to a project-specific installation of the Juxta Web Service if you are part of an editorial team using the Juxta Web Service on your own server.
Collating passages that appear out of order. In the side-by-side difference view, indicate the moved passage by dragging the mouse over the passage in both the base and the witness texts. The move button (on the upper right, next to the selection of the witness text) will be enabled when passages on both sides have been selected. Click the move button and the move will be created. You will see an outline of the passages and a line connecting them. There is also an entry in the Moves panel for each move created. Clicking the entry brings the move into view.
Searching in all text. Juxta’s Search feature allows you to find a word or phrase in all the texts in the current collation set. Type the search terms you want in the input box that appears on the tool bar and press the enter key (or click the button to the right of the input box). The results are displayed in the Search panel, and all the matching terms are highlighted in the texts. Clicking on a search result in the Search panel causes it to scroll into view. The search works for whole words only, so if you search for “work”, for example, the term “working” will not be found. If you search for more than one word, then it finds them in any order, as long as they appear close to each other in the text. For instance, searching for “question be” in Hamlet will return (among other results) “be, that is the question.”