﻿<?xml version="1.0" encoding="UTF-8"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0" xml:id="qme_userGuide">
   <teiHeader>
      <fileDesc>
         <titleStmt>
            <title type="main">User Guide</title>
            <title type="short">User</title>
            <respStmt>
               <resp ref="resp:aut">Author<date when="2022"/></resp>
               <persName ref="pers:HOUL3">Navarra Houldin</persName>
            </respStmt>
            <respStmt>
               <resp ref="resp:aut">Author<date when="2022"/></resp>
               <persName ref="pers:JENS1">Janelle Jenstad</persName>
            </respStmt>
            <respStmt>
               <resp ref="resp:aut">Author<date when="2023"/></resp>
               <persName ref="pers:COCK1">Peter Cockett</persName>
            </respStmt>
            <sponsor ref="org:QME1"/>
            <funder><ref target="http://www.sshrc-crsh.gc.ca/">Social Sciences and Humanities Research Council of Canada</ref></funder>             <funder><ref target="https://www.mcmaster.ca/">McMaster University</ref></funder>             <funder><ref target="https://pls.artsci.utoronto.ca/">Poculi Ludique Societas</ref></funder>             <funder><ref target="https://pls.artsci.utoronto.ca/">University of Waterloo</ref></funder>             <funder><ref target="https://pls.artsci.utoronto.ca/">University of Toronto Centre for Drama, Theatre &amp; Performance Studies</ref></funder>             <funder><ref target="https://www.uvic.ca/">University of Victoria</ref></funder>             <funder><ref target="https://internetshakespeare.uvic.ca/Foyer/makingwaves/friends/">Friends of the ISE</ref></funder> 
            </titleStmt>
         <editionStmt>
            <p>Released with Queen’s Men Editions 2.0</p>
         </editionStmt>
         <publicationStmt>
            <publisher>University of Victoria on the Linked Early Modern Drama Online Platform</publisher>
            <availability>
               <licence from="2023-09-01" resp="pers:COCK1" corresp="anth:qme"/>
               <licence from="2023-09-01" resp="pers:COCK1" corresp="anth:lemdo"/>
               <p>This file is licensed under a <ref target="https://creativecommons.org/licenses/by-nc-nd/4.0/">CC BY-NC_ND 4.0 license</ref>, which means that it is freely downloadable without permission under the following conditions: (1) credit must be given to the author, Queen’s Men Editions, and LEMDO in any subsequent use of the files and/or data; (2) the content cannot be adapted or repurposed (except in quotations for the purposes of academic review and citation); and (3) commercial uses are not permitted without the knowledge and consent of Queen’s Men Editions, the editor, and LEMDO. This license allows for pedagogical use of the critical paratexts in the classroom. Neither the content nor the code in this file is licensed for training large language models (LLMs), ingestion into an LLM, or any use in any artificial intelligence applications; such uses are considered to be commercial uses and are strictly prohibited.</p>
               
               <p>Production photographs and videos on this site may not be downloaded. They appear freely on this site with the permission of the actors and the ACTRA union. They may be used within the context of university courses, within the classroom, and for reference within research contexts, including conferences, when credit is given to the producing company and to the actors. Commercial use of videos and photographs is forbidden.</p>
            </availability>
         </publicationStmt>
         <seriesStmt>
            <p>Queen’s Men Editions</p>
         </seriesStmt>
         <sourceDesc>
            <p>Page written by <persName ref="pers:HOUL3">Navarra Houldin</persName>, <persName ref="pers:JENS1">Janelle Jenstad</persName>, and <persName ref="pers:COCK1">Peter Cockett</persName></p>
         </sourceDesc>
      </fileDesc>
      <profileDesc>
         <textClass>
            <catRef scheme="tax:emdDocumentTypes" target="cat:ldtBornDigAbout"/>
         </textClass>
      </profileDesc>
      <encodingDesc>
         <p>Encoded in TEI P5 according to the LEMDO Customization and Encoding Guidelines</p>
         <editorialDecl><p>n/a</p></editorialDecl>
      </encodingDesc>
      <revisionDesc status="published">
         <change who="org:LEMD1" when="2023-10-31" status="published">Published file.</change>
         <change who="pers:JENS1" when="2023-08-29" status="TEI_proofed">Proofread and made minor corrections and changes.</change>
         <change who="pers:JENS1" when="2023-08-28" status="TEI_proofed">Numbered paragraphs. Checked metadata.</change>
         <change who="pers:HOUL3" when="2023-08-23">Fixed links.</change>
         <change who="pers:HOUL3" when="2023-08-11">Moved some content around, added styling for images.</change>
         <change who="pers:HOUL3" when="2023-07-28" status="TEI_proofing">Finished incorporating COCK1’s suggestions.</change>
         <change who="pers:HOUL3" when="2023-07-26">Updated according to COCK1’s suggestions, added images.</change>
         <change who="pers:HOUL3" when="2023-07-12">Updated some metadata</change>
         <change who="pers:HOUL3" when="2022-12-09" status="TEI_INP">Created user guide, encoded metadata.</change>
      </revisionDesc>
   </teiHeader>
   
   <text>
      <body>
         <p xml:id="qme_userGuide_p1">The <title level="m">Queen’s Men Editions</title> anthology uses the LEMDO interface with custom colours, logos, and menus.</p>
         
         
         <div xml:id="qme_userGuide_siteNav">
            <head>General Site Navigation</head>
            
            <p xml:id="qme_userGuide_p2">These are some actions that you can take at any time:</p>
            <list rend="numbered">
               <item>Click the <title level="m">Queen’s Men Editions</title> logo at the top of any page in the anthology to go to the site homepage.
                  <figure>
                     <graphic url="img:qme_headerLogo.png" mimeType="image/png" width="453px" height="113px" style="width: 300px;">
                        <desc>QME logo</desc>
                     </graphic>
                  </figure>
               </item>
               <item>Click the <soCalled>Go</soCalled> button beside the search bar to go to our <ref target="https://endings.uvic.ca">Endings-compliant</ref> Static Search page. This page allows you to search based on document history, document types, early modern book formats, editorial treatments, and types of literary work. You can also type search terms directly into the search bar and then filter your results.
                  <figure>
                     <graphic url="img:qme_staticSearch.png" mimeType="image/png" width="326px" height="62px" style="width: 300px;">
                        <desc>Search bar with a Go button beside it</desc>
                     </graphic>
                  </figure>
               </item>
               <item>Click the buttons in the top navigation bar to see drop-down menus that link to anthology pages and editions. Note that the arrow beside each button points downwards when the drop-down menu is closed and points upwards when the drop-down menu is open.
                  <figure>
                     <graphic url="img:qme_navBar.png" mimeType="image/png" width="795px" height="63px">
                        <desc>Navigation bar from the QME website</desc>
                     </graphic>
                  </figure>
               </item>
               <item>Click on the menu with three horizontal stripes (the <soCalled>hamburger menu</soCalled>) at the top left of each page to access the side navigation bar (see <ptr target="#qme_userGuide_hamburgerMenu"/>).
                  <figure>
                     <graphic url="img:qme_hamburgerMenu.png" mimeType="image/png" width="42px" height="45px">
                        <desc>The QME hamburger menu button; a red square with three horizontal stripes</desc>
                     </graphic>
                  </figure>
               </item>
            </list>
         </div>
         
         
         <div xml:id="qme_userGuide_hamburgerMenu">
            <head>QME Site Tools: Side Navigation Bar</head>
            
            <p xml:id="qme_userGuide_p3">The side navigation bar gives you access to information and functionality that can enhance your engagement with any page on the QME site. To access the side navigation bar, click on the menu with three horizontal stripes (the <soCalled>hamburger menu</soCalled>) at the top left of each page: <figure rendition="rnd:inline">
               <graphic url="img:qme_hamburgerMenu.png" mimeType="image/png" width="42px" height="45px" style="display: inline; height: 1.5rem; width: auto; margin-bottom: 0;">
                  <desc>The QME side navigation bar button; a red square with three horizontal stripes</desc></graphic>
            </figure>. To close the menu and give yourself more space on your screen, click on the exit <q>X</q> icon: <figure rendition="rnd:inline">
               <graphic url="img:qme_hamburgerCloser.png" mimeType="image/png" width="43px" height="42px" style="display: inline; height: 1.5rem; width: auto; margin-bottom: 0;">
                  <desc>The QME side navigation bar closing button; a red square with a white X on it.</desc>
               </graphic>
            </figure>.</p>
            
            <p xml:id="qme_userGuide_p4">There are four tabs within the navigation bar: <quote>Content</quote>, <quote>Credits</quote>, <quote>Tools</quote>, and <quote>About</quote>.</p>
            
            
            <div xml:id="qme_userGuide_content">
               <head>Content</head>
               <p xml:id="qme_userGuide_p5">The side navigation bar opens by default to the <quote>Content</quote> pane, which contains the table of contents for the HMTL page that you are on. If you are looking at a modern edition, it will list all of the scenes and allow you to navigate directly to any scene of interest. In addition, you can access the character list for the play by clicking on <quote>Characters</quote>. The character list will appear on the right side of the page. Editorial notes about characters are indicated by a plus sign to the left of the character’s name. Click the plus sign to see the note. The plus sign will turn into a minus sign when you do this; click the minus sign to hide the note.</p><!-- See image below.</p>
                  <figure>
                     <graphic url="img:qme_FBFB_M_page.png" mimeType="image/png" width="1897px" height="885px">
                        <desc>Screenshot of the Friar Bacon and Friar Bungay modern text page with the Contents pane and the character list open. The character note for Edward Lacy is expanded.</desc>
                     </graphic>
                  </figure>-->
            </div>
            
            
            <div xml:id="qme_userGuide_credits">
               <head>Credits</head>
               
               <p xml:id="qme_userGuide_p6">The <quote>Credits</quote> tab provides information about all of the key contributors to the work visible on and underlying each of the HTML pages.</p>
            </div>
            
            
            <div xml:id="qme_userGuide_tools">
               <head>Tools</head>
               <p xml:id="qme_userGuide_p7">When you are viewing modern editions, you can choose to turn annotation and collation indicators on or off by selecting the <quote>Tools</quote> menu in the side navigation bar. Click the checkbox beside <quote>Display annotations</quote>, <quote>Display collations</quote>, or both to turn annotation and collation indicators on and off. They will both, by default, be on when you first open any modern text. For more information about how to use our annotations and collations, see <ptr target="#qme_userGuide_annotations"/> and <ptr target="#qme_userGuide_collation"/>.</p>
            </div>
            
            
            <div xml:id="qme_userGuide_about">
               <head>About</head>
               
               <p xml:id="qme_userGuide_p8">The <quote>About</quote> menu gives you access to metadata for each page (title, publisher, author, etc.) and allows you to see the open-access XML markup that underlies each HTML page.</p>
            </div>
         </div>
         
         
         <div xml:id="qme_userGuide_findQME">
            <head>Find QME Content</head>
            
            
            <div xml:id="qme_userGuide_QMEnavigation">
               <head>Performance Editions and Production Records</head>
               <p xml:id="qme_userGuide_p9">
                  <figure>
                     <graphic url="img:qme_navBar.png" mimeType="image/png" width="795px" height="63px">
                        <desc>Navigation bar from the QME website with drop down buttons for About, Performance Editions, Production Records, and Contexts</desc>
                     </graphic>
                  </figure>
                  The <quote>Performance Editions</quote> and <quote>Production Records</quote> menu items on the top navigation bar of this website provide two primary ways to access the Queen’s Men plays on this site. The <quote>Performance Editions</quote> menu opens a wide range of resources. Here you will find old-spelling texts and modernized texts of the plays integrated with the production records. The performance editions include introductions, supplementary materials, and the commentary written by the textual and performance editors.</p>
               
               <p xml:id="qme_userGuide_p10"><quote>Production Records</quote> takes you directly to video of the research productions of the plays. Taking this route, you can choose to watch the play in performance first and read the playtext later.</p>
               
               <p xml:id="qme_userGuide_p11">If you wish to read the text without commentary and without viewing the production videos, open the modernized text in the Performance Edition, and access the <quote>Tools</quote> menu in the side navigation bar to turn off annotations and collations (see <ptr target="#qme_userGuide_tools"/>). Alternatively, read the old-spelling text, a transcription of the playtext as it was first published in book format.</p>
            </div>
            
            
            <div xml:id="qme_userGuide_viewIntros">
               <head>Introductions</head>
               
               <p xml:id="qme_userGuide_p12">Each of our published editions has a general introduction providing an overview of the play. In a separate textual introduction, the editor of each play sets out the bibliographical history of the text. These introductions are particular to the play in question, but they often gesture to other plays to draw connections and encourage further reading.</p>
               
               <p xml:id="qme_userGuide_p13">You can find these text-specific introductions on each play’s edition page, which are linked from our <ref target="doc:qme_editions#qme_editions_perfeds">list of published editions</ref>.</p>
            </div>
            
            
            <div xml:id="qme_userGuide_modernEd">
               <head>Modernized Texts</head>
               <p xml:id="qme_userGuide_p14">To read a modern text of a play, navigate to that play’s edition landing page, which you can find by clicking on the dropdown menu for <quote>Performance Editions</quote> and selecting the play that you are interested in. Doing so will bring you to the edition’s landing page. You can also navigate to the edition landing pages from our <ref target="doc:qme_editions#qme_editions_perfeds">list of published editions</ref>. You will find the modern text in the <title level="a">Playtexts</title> section.</p>
               
               <p xml:id="qme_userGuide_p15">The literary divisions used in modern texts for this anthology are scenes and speeches. Each scene and speech in our published modern texts has a stable URL, which you can find by clicking the scene or speech number in the left margin of the modern text Site page. You can also navigate to scenes by opening the menu at the top-left of the page, selecting <quote>Content</quote>, and clicking on the scene to which you want to navigate.</p>
               
               <p xml:id="qme_userGuide_p16">The modernized texts on this site include our editors’ annotations and collations, which are accessed through clickable links.</p>
            </div>
            
            
            <div xml:id="qme_userGuide_annotations">
               <head>Annotations</head>
               
               <p xml:id="qme_userGuide_p17">Editors have added annotations to the modern-spelling editions of each play.</p>
               
               <p xml:id="qme_userGuide_p18">In QME there are two types of notes—textual notes and performance notes. Textual notes may include:
                  <list rend="bulleted"><item>Glosses (notes that give a short description of a term).</item>
                     <item>Commentary (discussion of the meaning of the text).</item>
                     <item>Textual notes (notes about editorial decisions).</item>
                     <item>Pedagogical notes (notes offering teaching tips and strategies).</item>
                     <item>Lexical notes (discussion of the etymology, meaning, and/or prevalence of a word).</item>
                     <item>Lineation notes (discussion of lineation and related editorial decisions).</item>
                  </list>
                  
                  Performance notes may include discussion of the choices made in the research production of the plays, such as:
                  <list rend="bulleted">
                     <item>Character choices by the actors.</item>
                     <item>Blocking (the arrangement of characters on the stage).</item>
                     <item>The production’s research on the staging practices of the Queen’s Men.</item>
                     <item>Commentary on the process and staging in relation to the politics of Elizabethan England and our modern politics.</item>
                     <item>Interpretive choices made in relation to stage directions present or absent in the texts.</item>
                  </list>
               </p>
               
               <p xml:id="qme_userGuide_p19">Annotations on a string of text that is one full verse line long or longer are indicated by vertical lines to the left of the text. Click on the vertical line to view the annotation. Annotations on a string of text that are shorter than one verse line are indicated by horizontal underlines. Click on the annotated text or the underline to view the annotation. Spans of text with more than one annotation on them are indicated with a double underline. Click on the annotated text or the double underline to view all annotations on that string of text. Annotations will appear in a window on the right side of the page.</p><!-- JENS1 to HOUL3: We may need to revise this paragraph if HOLM1 implements his interface changes. -->
            </div>
            
            
            <div xml:id="qme_userGuide_collation">
               <head>Collation</head>
               <p xml:id="qme_userGuide_p20">A collation is indicated by a small red symbol with diverging arrows inside of a circle. (A collation is a record of how the text differs across copies and has changed over time.) Click on this symbol and the collation details will appear on the right side of the page.</p>
            </div>
            
            
            <div xml:id="qme_userGuide_semiDipTranscriptions">
               <head>Old-Spelling Texts</head>
               
               <p xml:id="qme_userGuide_p21">Old-spelling texts are transcribed versions of early modern playbooks. We recommend juxtaposing modern and old-spelling texts in the classroom for lessons on editorial practice, book history, and bibliography.</p>
               
               <p xml:id="qme_userGuide_p22">The divisions used for old-spelling texts in this anthology are pages and speeches, which correspond with page divisions and speeches in the witnesses (i.e., sources) used for each edition. Each page and speech has a stable URL. You can navigate to pages by opening the menu at the top-left of the page, selecting <quote>Content</quote>, and clicking on the editorial signature number for the page to which you want to navigate.</p>
               
               <p xml:id="qme_userGuide_p23">You can also find facsimile images of the transcribed text some old-spelling texts. To view full-sized facsimile images, click on the thumbnail image beside each page beginning in the text.</p>
            </div>
         </div>
         
         
         <div xml:id="qme_userGuide_siteAccessibility">
            <head>Site Accessibility</head>
            
            <p xml:id="qme_userGuide_p24">If you are using a screen reader and are interested in early modern punctuation practices, we recommend adjusting your screen reader’s settings to read most or all punctuation aloud when reading semi-diplomatic transcriptions.</p>
         </div>
         
         <div xml:id="qme_userGuide_citation">
            <head>Citation</head>
            
            <p xml:id="qme_userGuide_p25">This anthology uses stable URLs for pages and entities. This practice means that the URLs for our online pages do not change and that you can expect links to pages on the QME website to be long-lasting. Furthermore, you can digitally cite specific scenes, speeches, sections, and paragraphs by using the URL for that scene, speech, section, or paragraph.</p>
            
            <p xml:id="qme_userGuide_p26">You can access the URL for scenes and sections by opening the table of contents in the side navigation bar, clicking on the scene or section of interest, and copying the URL from your browser’s search bar. You can also access section URLs by clicking on the pilcrow (¶) on the left of the section header and copying the URL from your browser’s search bar. You can access the URL for speeches and paragraphs by clicking on the speech or paragraph number on the left side of the HTML page and copying the URL from your browser’s search bar.</p>
            
            <p xml:id="qme_userGuide_p27"> For information on citing from the QME website, see <ptr target="doc:qme_citing"/>.</p>
         </div>
         
         <div xml:id="qme_userGuide_architecture">
            <head>Information Architecture</head>
            <p xml:id="qme_userGuide_p28">
               The About menu and <ref target="doc:qme_about">Introduction to the Site</ref> page take you to pages about the QME project, including an overview of the Queen’s Men and their plays as a rationale for the website. It gives <ref target="doc:qme_acknowledgements">acknowledgements</ref> to professors and students who helped in the project that is being completed by this website, and it lists (with links to short biographies) the <ref target="doc:qme_contributors">editorial board, the advisory board, contributors, and editors</ref> on the site.</p>
            <p xml:id="qme_userGuide_p29">
               The Performance Editions menu and <ref target="doc:qme_editions">landing page</ref> take you to the peer-reviewed editions of QME plays, fully annotated with performance links and notes.</p>
            <p xml:id="qme_userGuide_p30">
               The Production Records menu and <ref target="doc:qme_productions">landing page</ref> take you to the material archives of modern productions, research about historical performance, and production histories. It will include footage or links to film footage, photographs of performances, props, sets, costumes, and any special effects. It will include both historical and modern practices.</p><!-- Note that we have to find the resources and rebuild the pages. -->
            <p xml:id="qme_userGuide_p31">
               The Contexts menu takes you to other sources connected to QM plays: a history of the Queen’s Men, a bibliography of sources used in the creation of the editions, biographies of the QM actors, teaching resources, and links to other resources such as the <ref target="https://ebba.english.ucsb.edu/">English Broadside Ballads Archive at UCSB</ref>.</p>
         </div>
         
         
         
      </body>
   
    </text>
   </TEI>