Guide to Creating Image Citiations

Whenever one creates any scholarly document, it is critical to provide clear citations to the original source in order to validate the edition. In the case of a diplomatic edition, it becomes vital that one cites not only what document the information is coming from, but also where on the document specifically the cited text appears. In order to form this connection between our edited text and the original manuscript, we have made use of URN citations to provide for a system of unique identifiers for every block of edited text that will connect to both an image and the manuscript itself. Provided is the procedure for citing edited text:

• On the gen49 gitHub page, locate the "collections" folder. Within the folder one should find a document titled, "gen49-textCollection.csv". This document will be used to record the relationship between edited text. Already there should be a table with three columns: text, image, and bifolio.

• In a separate window or tab, access the image citation tool for images of gen49. The tool can be accessed by navigating from the CITE services page on the MID website. Follow the link to "overview of contents". Then under "Image Collections" select the "browse" button that corresponds to gen49. Finally under any one the images that appear select "Cite and Quote Image" regardless of whether or not this is the precise image one wants to cite. Once the page loads, note that the end of the page's URL corresponds to pages in the manuscript, e.g. 69v-70r. Simply adjust the URL to the appropriate tag for the image one wants to cite. One now is ready to begin creating citations.

• In the image citation tool, use the mouse to click and drag a box around the area one wishes to cite. Since Chronicles is arranged in a tabular format, it is easiest to organizes the areas of interest into rows. Thus one will want to form a box around just a single row; however, since text can easily spill into another row, we do not want to limit the box to being confined into fixed dimensions. The box should be as big as is necessary to completely envelope all the text that was edited in the XML edition, regardless of extra text that will appear in the box. So even if capturing a large block of text requires a box that will include two or three rows that are not meant to be cited, the box will have to include those two or three extra rows in order to fully capture the text of the intended row.

• With the box drawn, one should notice that above the image a URN will have appeared. Copy the entire URN to one's clipboard. This is the image URN.

• Return to the gitHub document and select edit. One should now be looking at the same document, but now with a black background and white text. While presumably one will be working on the newest entry and therefore one should scroll down to the bottom, one should find in the document where the specific folio which they are editing is located within the document. This can easily be done by examining the far-most column of the gitHub document whose last few digits provide an identification tag of the specific folio. Once the correct space is found, create a space and paste the image URN into the new space.

• Since, as noted, the image column is in the middle, one must make sure the image URN is in the middle. In this gitHub document, columns in a table are separated by one another with a comma. Thus one should put a comma before and after the image URN to ensure that it lies in the middle. However, the image URN itself contains commas, so an additional step is required to ensure the the URN's commas are not interpreted as new column dividers. Thus around the entire image URN, but with the surrounding commas, place quotation marks. Altogether the image URN should look like: ,"Image URN",

• The next step is the add the text URN which will go in the first column.