1.0 What does the Yale Digital Edition of the Works of Samuel Johnson contain?

    1.1 Volumes

2.0 Accessing the Archive

    2.1 Logging in

3.0 What can I do in this archive?

    3.1 Search Content

        3.1.1 Performing a Search

        3.1.2 Boolean Search

        3.1.3 Wild card search

        3.1.4 Failed keyword search

        3.1.5 Working with Search Results

    3.2 Browse

    3.3 Document Viewer

        3.3.1 Document Viewer Toolbar

        3.3.2 Text Viewer Panel

        3.3.3 Document Info Panel

4.0 My YDJ

    4.1 My YDJ Home

    4.2 Notifications

    4.3 Private Groups

        4.3.1 Joining a Private Group

        4.3.2 Creating a New Private Group

    4.4 Library

        4.4.1 Saving a document

        4.4.2 Managing and Sharing Documents in the My YDJ Library

        4.4.3 Saved Searches

    4.5 Community Pages

        4.5.1 My Profile

        4.5.2 Private Groups

    4.6 My Annotations

    4.7 My Tags
 

1.0 What does the Yale Digital Edition of the Works of Samuel Johnson contain?

1.1 Volumes

The Yale Edition of the Works of Samuel Johnson was founded in 1955 to replace the Oxford Edition of 1825 and make accurate texts of Johnson's complete works widely available. Originally there were to be nine volumes and the project was to take two years. The first volume, Diaries, Prayers, and Annals, appeared in 1958. Since then the plan of the edition has grown and twenty additional volumes have appeared. The most recently published of these are The Lives of the Poets, volumes 21-23 (2010). Two volumes are still under way: volume 19: Biographical Writings: Soldiers, Scholars, and Friends; and volume 20: Occasional Writings: Prefaces, Proposals, Apologies, and Dedications.

2.0 Accessing the Archive

The YDJ is a free resource, open and accessible to the public. The Search, Browse, Document Viewer, My YDJ, Resource, and About pages are available to all users who visit the site.

Any user can open documents in the document viewer; print/download documents from the document viewer; and export citation information from the document viewer. However, each user must first login to her personal My YDJ account before she can access the suite of tools related to user-generated content. These include bookmarks, tags, annotations, discussions, and the ability to save documents to personal or private group folders.

2.1 Logging in

First time users must create a profile before they are able to login and access the My YDJ functionality. To create a new YDJ account:

1. Click the “Register” link in the top right corner of the screen.
2. Fill out the required fields in the resulting “Create a New Profile” page (Figure 1).
3. Click on the “Save and Continue” button at the bottom of the screen.
4. An automated email with a username, password, and a link for a one-time login will be sent to the user’s email address. Open this email and click on the one-time login link.
5. Reset the password, and fill out any other relevant profile information.

Figure 1: “Create a New Profile” page

After creating a valid My YDJ profile, a user can log in to the YDJ at any time.

3.0 What can I do in this archive?

3.1 Search Content

The YDJ’s search tool allows for a simple keyword search of all archival content, as well as a more refined search based on specific bibliographic constraints.

3.1.1 Performing a Search

The search page is accessible via the Search tab in the top navigation bar. When a user navigates to the search page, the user is directed to the Advanced Search landing page. To add search fields, click the “+Add Search Field” button. You can also choose to limit this search to specific fields of information, like author names or titles, or employ Boolean search operators by opening dropdown menus adjacent to each search field. For an introduction to the Boolean operators used on the site, see http://sphinxsearch.com/docs/current.html#boolean-syntax. Some additional helpful resources for Boolean search can be found at http://libguides.mit.edu/content.php?pid=36863&sid=271372 andhttp://library.duke.edu/services/instruction/libraryguide/advsearch.html. (Figure 2).

Figure 2: Advanced Search Landing Page

A list of the possible search refinement options (accessible through the dropdown menus to the right of the text boxes) and their definitions follow:

All: The search term can appear in any context (unconstrained).

Annotations: The search term can only appear in user-generated annotations associated with a document. The search term can also include user names associated with annotations.

Authors: The search term can only appear in a document author’s name.

Creation Dates: The search term can only appear in a document’s creation date.

Publication dates: The search term can only appear in a document’s publication date.

Printers: The search term can only appear in a document’s printer's name.

Publishers: The search term can only appear in a document’s publisher's name.

Publ. Places: The search term can only appear in a document's location(s) of publication.

Classifications: The search term can only appear in a document’s genre or subject designations.

Tags: The search term can only appear in user-generated tags associated with a document.

Text: The search term can only appear in a document’s full-text transcription.

Titles: The search term can only appear in a document’s title.

Please note that the search tool is not case-sensitive.

Users can also add filters to further constrain search results with the options available below Search Options (Figure 3).

Figure 3: Search Options

(search options image)

A list of possible search filters and their definitions follow:

Collections: Filters results to YDJ volumes and YDJ documents. YDJ volumes contain the front matter and end matter of the titles in the Yale Edition of the Works of Samuel Johnson; the YDJ documents contain the discrete documents (e.g. poems, sermons, prayers, etc...) that comprise the contents of those volumes.

Names: Filters results using names and pseudonyms of document authors and recipients.

Publication Date: Filters results by specific creation date or date range.

Classification: Filters results based on genre or subject, as defined by the YDJ Editorial Board.

After entering all desired constraints to the search parameters, click on the “Search” button to conduct the search.

Users may also conduct a basic keyword search from all other pages of the YDJ platform, including the home page, via the basic keyword search box located in the top right corner of the screen (Figures 4). Simply enter your search term and click on the magnifying lens at the right of the box.

Figure 4: Basic keyword search box

(basic keyword search box image)

3.1.2 Boolean Search

Users can employ Boolean search operators by selecting the Boolean Search option in the dropdown menu to the left of keyword search boxes on the Advanced Search landing page. The Boolean search tool allows you to search the database with such operators as:

• & (AND). Entering the search query Hello & World will bring up all search results that contain both the word "Hello" and the word "World". The AND operator is the default operator, so typing Hello World into the search box will produce the same result.
• | (OR). Entering the search query Hello | World will bring up all documents that contain either the word Hello or the word World.
• ! (NOT). Entering the search query Hello !World or Hello -World will bring up all documents that contain the word Hello and do not contain the world World.
• MAYBE. Entering the search query Hello MAYBE World will bring up all documents that contain the word Hello and all documents that contain the words Hello and World.
• @! (Ignore Field Search Operator). Entering the search query @!title Hello World will ignore all documents that contain the words Hello and World in the Title field.
• ~ (Proximity Search Operator). Entering the search query "Hello World"~10 will bring up all documents that contain the words Hello and World within ten characters of each other.

For more resources related to the Boolean operators used on the YDJ site, see http://sphinxsearch.com/docs/current.html#boolean-syntax. Some additional helpful resources for Boolean search can be found at http://libguides.mit.edu/content.php?pid=36863&sid=271372 and http://library.duke.edu/services/instruction/libraryguide/advsearch.html.

3.1.3 Wild card search

Users can conduct searches with the wildcard *. The * functions as an auto-complete for a given
keyword. For example, a search for “joh*” will search the database for all words that begin with "joh".

3.1.4 Failed keyword search

If your keyword search does not yield any results, the archive’s search engine will provide 5 terms that do exist within the archive’s database and that are alphabetically similar to your initial query. This list of 5 words will change depending on what you are looking for. Clicking on one of these terms will conduct a keyword search of the archive’s contents (Figure 5).

Figure 5: Failed Search results

(failed search results image)

3.1.5 Working with Search Results

After conducting a search, the center panel of the screen will populate with the document results
list. This search results panel will provide basic bibliographic information about each individual
search result, including title, author, creation date, printer, classification, etc. A navigation tool in the top panel of the
screen will indicate how many documents have been found and how many pages are in the list
(Figure 6).

Figure 6: Detail View of search results

Users can adjust the view of the search results list by toggling between the two “View As” buttons, located in the top panel. The two view options are List View and Detail View.

The default view for the search results panel is Detail View which displays both the thumbnail image and all of the bibliographic metadata for each document in the results list. Clicking on the hyperlinked tags or subjects will conduct a search that uses the selected item as the primary search constraint (Figure 6).

List View displays the results in documents appearing in a sortable grid, with each piece of bibliographic information appearing in a separate column. Users can customize which bibliographic fields appear in the grid by selecting the View Options menu above the results list (Figure 7). These view options include:

Alt. Title: Alternative title for a given document.

Author: Author(s) of a given document.

Contrib. Author: Contributing author(s) of a given document.

Creation Date: Creation date of a given document.

Publication Date: Publication date of a given document.

Printer: Printer of a given document.

Publisher: Publisher of a given document.

Publ. Place: Publishing location of a given document.

Snippets: The first three instances in which a given keyword appears in a document’s text and/or
public annotations. Snippets will appear only after a user has conducted a keyword search.
Clicking on these hyperlinked snippets will open the document in the viewer, and will autoadvance
the user to the exact location of the given snippet in the text and/or annotations.

# of Hits: The number of times a given keyword appears in a document’s text and/or public
annotations.

Classification: The genre or subject classification of a given document, as determined by the YDJ Editorial
Board.

Title: The title of a given document.

# of Views: The total number of times a given document has been viewed by members of the
YDJ community.

# of Pages: The number of pages associated with a given document.

Figure 7: List View with View Options menu

Users can re-sort the results list in any view by using the “Sort by” drop-down menu.
In List View, users can also sort the results alphabetically or reverse-alphabetically by clicking on the header of any column.

To further constrain results once on the search results page, continue to add Search Options and enter keywords in the text box located in the panel to the left of the search results. (Figure 8)

Figure 8: Search Options Panel

(search options panel image image)

Open a document by clicking the “Open” button (which appears in both the search results list
and in the right-hand preview panel) in List View, or by clicking on the thumbnail image or the title
of the document in Detail View.

Users can generate academic citations for search results by using the “Export Citation/Results”
button in the top panel (Figure 9). Simply check the box to the left of the desired title(s) and click on “Export Citation.” The Citation Type options are APA, Chicago, MLA, and Turabian.
The Export options are Print to Screen, Export to Endnote, and Export to txt.

Users can also export all of the bibliographic information for a set of search results to a CSV file by selecting the “Export” button in the top panel (Figure 9). Users can export bibliographic information for a maximum of 3,000 search results items at a time. If the search results list exceeds 3,000 items, please use the search filters to refine the list to a smaller number. Please note that the “Export Results” tool exports all of the items in a search results list by default, as long as the list is under 3,000 items.

Users can also save one or more documents to a personal or private group folder by
selecting the checkboxes next to the desired documents and clicking on the “Save”
button in the top panel. Please note that a user must be logged in to her My YDJ account to be
able to save documents to folders.

Figure 9: Export button

3.2 Browse

Navigate to the Browse page by clicking the Browse tab below the site banner. Here, users can view the Works of Samuel Johnson documents arranged in time and genre based categories.(Figure 10).

Figure 10: Browse Landing Page

Here, you will find a timeline that provides a list of documents based on creation date within a given chronological era, as defined by the YDJ Editorial Board.

Find categorical listings under the The browsing categories are:Browse by Genre header. A list of the genres with descriptions will follow:

Debates: The most recent addition to the Yale Edition is the three-volume collection of the Parliamentary Debates, which Johnson composed for the Gentleman's Magazine in the early 1740s. The brilliant prose of these works is unsurpassed by the works of any of the politicians whose speeches Johnson invented.

Essays: In addition to literary critical essays, Johnson wrote moral and ethical essays in the tradition of Sir Francis Bacon's Essays. Many of these essays are part of the Rambler (1750-52), but many others are to be found in Johnson's contributions to other journals.

Poetry: Johnson first made his reputation as the author of "London" (1738) and his "Vanity of Human Wishes" (1749) is well known, but he wrote scores of infrequently read poems in both Latin and English.

Literary Criticism: Johnson above all excelled as a literary critic, a genre in which he practiced throughout his career. By searching the YDJ it is possible to collect all of this work, whenever or wherever Johnson published it

Sermons: Twenty-eight sermons have been attributed to Johnson, most of them written for others and only published after his death.

Other Genres: The YDJ identifies over forty genres to which Johnson contributed. He wrote in almost every possible genre from advertisement to epitaph, from prayer to parody, from satire to tragedy.

3.3 Document Viewer

The Document Viewer displays the text associated with each document in the archive. This content is divided into two primary sections: the text viewer panel and the document info panel (Figure 14).

Figure 11: Document Viewer

Users can open documents in the Viewer via the Search, Browse, or My YDJ sections of the site. In addition to displaying all bibliographic data and content associated with a document, the Viewer also allows users to customize documents with personal bookmarks and highlighting. It also enables users to review and add personal, private group, or public commentary in the form of tags and annotations.

Please note that a user must first login to her personal My YDJ account to be able to access the highlighting, bookmark, tag, annotation, and save features available within the viewer.

3.3.1 Document Viewer Toolbar

The Document Viewer toolbar appears at the top of the screen and enables users to view and interact with documents in a number of ways. Users can save a document to a personal or private group folder; download or print up to 10 pages at a time of a document’s text (as long as the document has sufficient print privileges); export a document’s academic citation in a range of formats; and export all private group and/or public annotations associated with a document. Users can turn the document info panel on or off via the “i” toggle on the right side of the toolbar.

Figure 12: Document Viewer Toolbar

3.3.2 Text Viewer Panel

The text viewer panel displays the full text of an open document. Please note that, in order to create a bookmark, tag, or annotation in the text viewer panel, logged in users must first select a portion of the text, and then click on the appropriate button. The buttons available on the Text Viewer Panel toolbar are:

Font Size Decrease Button: Decreases the size of the font in the text viewer.

Font Size Increase Button: Increases the size of the font in the text viewer.

Bookmark Button: Allows logged in users to create a private bookmark referencing a particular section of the text.

Tag Button: Allows logged in users to create personal, private group, or public tags referencing a particular section of the text.

Annotation Button: Allows logged in users to create personal, private group, or public annotations referencing a particular section of the text.

Highlight Button: Allows logged in users to highlight specific passages of the text. Users can remove highlighting by re-selecting a portion of the text that has been highlighted, and clicking on the “Highlight” button.

Page Count: Shows the total number of pages contained within the document. Users can jump to a page by typing a page number into the text box.

Show/Hide Icon: Allows logged in users to show or hide all user-generated content associated with a document.

3.3.3 Document Info Panel

The Document Info Panel displays all bibliographic information associated with an open document (Figure 14). It also permits users to review user-generated content such as tags, annotations, bookmarks, and discussions related to the open document.

Figure 14: Document Info Panel

The different sections of the document info panel are:

Keyword Search Box: Allows users to conduct a full-text keyword search of an open document’s content, including text and annotations. Conduct a keyword search by entering a term into the textbox at the top of the document info panel.

Document Details: Displays a document’s bibliographic information, including title, author, date, publisher, etc.

Tags: Displays personal, private group, and public tags associated with an open document. Users can edit or delete their own personal, private group, or public tags, but they cannot edit or delete private group or public tags created by other users.

Annotations: Displays personal, private group, and public annotations associated with an open document. Users can edit or delete their own personal, private group, or public annotations, but they cannot edit or delete private group or public annotations created by other users. Users can also report inappropriate annotations to the YDJ Administrator by clicking on the “Report” button.

NOTE: Certain annotations will contain a green “YDJ Editor Approved” icon above their content. These annotations were either written or approved by one of the archive’s editorial board members.

Bookmarks: Displays personal and public bookmarks associated with an open document. Users can edit or delete their own personal bookmarks, but they cannot edit or delete public bookmarks created by the YDJ Editorial staff. Users can share personal bookmarks by clicking on the “chain” icon and copying the accompanying URL. Please note that only YDJ Editorial Board members can create public bookmarks.

NOTE: Clicking on any bookmark, tag or annotation in the document info panel will take the user directly to the relevant section of the document. Similarly, clicking on a bookmark, tag or annotation icon in a text’s margins will open that bookmark, tag or annotation in the document info panel.

4.0 My YDJ

My YDJ is the site’s center for personalized content and community interaction, and is accessible via the My YDJ tab at the top of the screen.

4.1 My YDJ Home

The My YDJ homepage allows users to view notifications; access recently viewed documents; manage a personal library of saved documents, tags, annotations, and searches; and participate in Private Groups (Figure 15). See Section 2.1 for more information on how to create a My YDJ account.

Figure 15: My YDJ homepage

4.2 Notifications

The Notifications area of My YDJ displays updates from both administrators and fellow YDJ members. Notifications cover such topics as additions to the digitized archive; new discussion topics for private group discussion threads; invitations to join new private groups; the addition of new documents to private group folders; site news and updates from the site admin; and other updates related to a user’s personal account and/or the general functionality of the site. Notifications are presented in a tabular view, and can be sorted by date or notification type (i.e. Forum, Group, Message).

Figure 16: My YDJ notifications

4.3 Private Groups

Private Groups represent a more selective, focused and member-specific subset of the YDJ’s community functionality. Anyone with a My YDJ account can create a Private Group. The creator of a Private Group becomes that group’s owner by default, and thus has the ability to define the name and description of the group; invite other My YDJ users to the group; manage the group’s folder permissions (i.e. Read/Write); remove users from the group; and designate a new owner of the group.

A list of all of the Private Groups to which a My YDJ user has access is available via the My YDJ homepage, or by mousing over the My YDJ tab at the top of the screen and clicking on “Private Groups” (Figure 17). This will indicate the name of each group; the number of members belonging to each group; the user’s group status (i.e. Invited, Member, Owner); the user’s group options (i.e. Accept Invitation, Decline Invitation, Leave Group, Remove Group); and the date on which the user was invited to the group.

Figure 17: Private Groups area of My YDJ

Each Private Group has a corresponding forum in which participating users can discuss relevant topics and documents. Users must joint a Private Group before they can participate in its forum.

4.3.1 Joining a Private Group

A user must first receive an invitation before she can join a Private Group. To join a Private Group:

1. Click on the My YDJ tab at the top of the screen.
2. Click on the Community Pages tab in the left-hand navigation panel.
3. Select “Private Groups.”
4. Click the “Accept” or “Decline” button in the Options column next to the group name to which the user has been invited.

NOTE: The user may also accept/decline a private group invitation via the Notifications page.

4.3.2 Creating a New Private Group

Any user can create a new Private Group. Once a user creates a Private Group she becomes the owner of the group. To create a new Private Group:

1. Click on the My YDJ tab at the top of the screen.
2. Click on the Community Pages tab in the left-hand navigation panel.
3. Select “Private Groups.”
4. Click on the “Create New Group” button at the top of the Private Groups homepage.
5. Enter the group name and description.
6. Select the Member Folder Access.

NOTE: “Read Only” means that all non-owner members can only view documents in shared folders. “Read/Write” means that all non-owner members can add and remove documents from shared folders.

7. Enter the email addresses of the users whom you would like to invite to the group.

NOTE:You can only invite users with currently existing My YDJ accounts to join Private Groups.

8. Click “Submit.”

NOTE: If a private group owner wants to leave a group, she must first designate a current group member as the new owner. The owner can do this by clicking on the “Edit” button on the Private Group’s homepage, and then by clicking on “Assign New Owner.”

4.4 Library

The My YDJ Library enables users to save and share documents from within the archive. Personal Folders enable users to view and manage documents they have saved for their own personal research. Private Groups Folders allow users to share documents with other members of related Private Groups. To access the My YDJ library, go to the My YDJ homepage and click on the appropriate tab in the left-hand navigation panel.

4.4.1 Saving a document

Users can save a document to the My YDJ library from the search page, browse page, or document viewer. To save a document from the search or browse page:

1. Go to the search or browse page, and select the checkboxes next to the appropriate documents.
2. Click on the “Save” button in the top toolbar.
3. Select an existing personal or private group folder to which to save the documents. Users can also save the documents to a new personal folder by using the “Create new folder” option.
4. Click the “Save” button at the bottom of the dialogue box.

To save a document from the Document Viewer:

1. Open a document in the Viewer and click the “Save” button in the document viewer toolbar.
2. Follow steps 3 and 4 as outlined above.

4.4.2 Managing and Sharing Documents in the My YDJ Library

In the Library section of My YDJ, users can create new folders, rename existing folders, create and edit folder descriptions, sort folders by various criteria, and delete individual folders (and the documents contained within).

Click on a personal or private group folder title to view the list of documents contained within. Clicking on the title of a document will open it in the viewer. Buttons at the top of the folder’s screen allow users to export academic citations or user-generated annotations on selected documents; copy or move documents from one folder to another; or remove a document from the current folder. Users can also adjust the view of the document list by using the View Options and “Sort by” drop-down menus on the right side of the screen.

NOTE: Users must have Read/Write access to copy, move or delete documents contained in a Private Group.

Figure 18: Library section of My YDJ

To share a saved document from a personal, or private group folder with another private group folder, go to the corresponding Private Group and click the “Share Document” button under the Recently Shared Documents header.

NOTE: Users must belong to a Private Group before they can share a document with that group’s folder.

4.5 Community Pages

Community Pages display information about individual users to the YDJ community.

4.5.1 My Profile

The My Profile page displays a user’s public profile, and is accessible via the My YDJ left-hand navigation panel. The My Profile page displays basic biographical information (e.g. name, email address, academic institution, “about me,” etc.) as well as site usage information (e.g. Public tags and annotations created by a user, etc...).

To edit the My Profile page:

1. Click the “Manage Profile” button in the top right-hand corner of the screen.

2. Click the Edit tab.

3. Update the relevant profile fields.

4. Click “Apply” at the bottom of the screen.

NOTE: Users can set their email address to public or private. When a user selects “private,” her email address is hidden from all other users on the site.

4.5.3 Private Groups

The Private Groups page shows a list of all of the user’s affiliated Private Groups. See section 4.3 to learn more about Private Groups.

4.6 My Annotations

Users can manage their personal, private group, and public annotations via the My Annotations tab, available via the My YDJ left-hand navigation panel. This page allows users to sort annotations by document title, annotation type, or date created; export selected annotations to a text file or browser tab; edit annotations; and delete annotations (Figure 19).

Figure 19: My Annotations page in My YDJ

4.7 My Tags

Users can manage their personal, private group, and public tags via the My Tags tab, available via the My YDJ left-hand navigation panel. The My Tags page displays a list of personal, private group, and public tags created by the user (Figure 20). The number in parentheses that follows each tag indicates how many times the user has applied that tag throughout the archive. Clicking on the grey arrow before a tag name will reveal the other tags with which the initial tag shares a document.

Figure 20: My Tags page in My YDJ

Thank you for your interest in the Yale Digital Edition of the Works of Samuel Johnson. If you have any questions or concerns about the User Guide, the website, or anything else related to the archive, please send an email to the YDJ Support Team at support@yalejohnson.com. Please click here to download a PDF copy of the User Guide