Digital Humanities Questions & Answers » Forum: Markup & Metadata

Digital Humanities Questions & Answers » Forum: Markup & Metadata - Recent Posts http://digitalhumanities.org/answers/forum/markup-metadata Digital Humanities Questions & Answers » Forum: Markup & Metadata - Recent Posts en-US Wed, 20 Apr 2016 18:59:41 +0000 http://bbpress.org/?v=1.0.2 <![CDATA[Search]]> q http://digitalhumanities.org/answers/search.php anglebracket@gmail.com on "Advice for teaching myself XML?" http://digitalhumanities.org/answers/topic/advice-for-teaching-myself-xml#post-2299 Mon, 16 Mar 2015 18:11:04 +0000 anglebracket@gmail.com 2299@http://digitalhumanities.org/answers/ Although the question is a few years old, the answers still hold, but the best way is to learn by doing it. Pick a text, pick an editor, and try to mark it up. There are lots of gotchas in XML, but a decent editor will shield you from the worst of them. Unfortunately there are very few free XML editors (Emacs is one, but not recommended for beginners). If trial and error, or a book, is too much, there's always something like the Intro sessions at the XML Summer School and similar events -- <a href="http://xml.silmaril.ie/moreinfo.html#events" rel="nofollow">http://xml.silmaril.ie/moreinfo.html#events</a> (I edit this, so let me know any errors). Ben Marwick on "Planning for link rot in article bibliography" http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2143 Thu, 30 Jan 2014 19:52:57 +0000 Ben Marwick 2143@http://digitalhumanities.org/answers/ Another free web archiving service is <a href="http://www.webcitation.org/" rel="nofollow">http://www.webcitation.org/</a> This is required for citing webpages by journals published by Wiley. Ethan Gruber on "Extending TEI for image annotation" http://digitalhumanities.org/answers/topic/extending-tei-for-image-annotation#post-2140 Wed, 08 Jan 2014 11:26:38 +0000 Ethan Gruber 2140@http://digitalhumanities.org/answers/ I'm using the schema at <a href="http://www.tei-c.org/release/xml/tei/custom/schema/xsd/tei_all.xsd" rel="nofollow">http://www.tei-c.org/release/xml/tei/custom/schema/xsd/tei_all.xsd</a> Oddly enough, I am no longer getting validation errors on these attributes, but the modification date of the schema is dated July 2013. This doesn't make any sense to me. Thanks for your help, though. It appears I can proceed with relative coordinates. Conal Tuohy on "Extending TEI for image annotation" http://digitalhumanities.org/answers/topic/extending-tei-for-image-annotation#post-2139 Fri, 20 Dec 2013 19:30:16 +0000 Conal Tuohy 2139@http://digitalhumanities.org/answers/ Hi Ethan You should check the TEI schema you are using if you find real numbers are invalid. You may have a schema that's been customised to only accept integers. The base data type does include real numbers: <a href="http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-data.numeric.html" rel="nofollow">http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-data.numeric.html</a> These are not (necessarily) pixel coordinates; they can often be physical units such as mm. The unit doesn't really matter so long as a common coordinate system is used within the surface. Conal Tuohy on "Extending TEI for image annotation" http://digitalhumanities.org/answers/topic/extending-tei-for-image-annotation#post-2138 Fri, 20 Dec 2013 19:28:49 +0000 Conal Tuohy 2138@http://digitalhumanities.org/answers/ Hi Ethan You should check the TEI schema you are using if you find real numbers are invalid. You may have a schema that's been customised to only accept integers. The base data type does include real numbers: <a href="http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-data.numeric.html" rel="nofollow">http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-data.numeric.html</a> These are not (necessarily) pixel coordinates; they can often be physical units such as mm. The unit doesn't really matter so long as a common coordinate system is used within the surface. Kevin Hawkins on "Extending TEI for image annotation" http://digitalhumanities.org/answers/topic/extending-tei-for-image-annotation#post-2137 Fri, 20 Dec 2013 12:37:13 +0000 Kevin Hawkins 2137@http://digitalhumanities.org/answers/ Hello Ethan, Please do send an email to TEI-L raising your concerns. People do exactly this sort of thing all the time, and such discussions tend to lead to a consensus that what the person is trying to accomplish can, in fact, be done in TEI another way, or it leads to a bug report or feature request for the TEI Guidelines and associated schemas. If the such a report is not accepted by the TEI's Technical Council (because, for example, they feel that your use of these attributes violates the semantics of those attributes and that those attributes are defined as intended), you would still be free to customize the TEI in order to allow for your desired use. See <a href="http://www.tei-c.org/release/doc/tei-p5-doc/en/html/USE.html#MD" rel="nofollow">http://www.tei-c.org/release/doc/tei-p5-doc/en/html/USE.html#MD</a> for a discussion of how to do this. Basically, the TEI's preferred mechanism is that you use the ODD language to document your change and then generate your new schema from this, rather than taking a TEI schema provided by the TEI Consortium and hacking it directly. —Kevin Ethan Gruber on "Extending TEI for image annotation" http://digitalhumanities.org/answers/topic/extending-tei-for-image-annotation#post-2136 Fri, 20 Dec 2013 10:35:04 +0000 Ethan Gruber 2136@http://digitalhumanities.org/answers/ I am beginning to work on a project digitizing a series of notebooks, and each page in the notebook will contain annotations created by the project archivist. I am going to be using Annotorious (<a href="http://annotorious.github.io/" rel="nofollow">http://annotorious.github.io/</a>) for the annotation engine, following the model of using OpenLayers to annotate zoomable images. Much to my surprise, TEI can handle the storage of annotations natively within the schema with facsimile and surface elements. Some use cases are well-documented at <a href="http://tei.oucs.ox.ac.uk/Talks/2009-07-dublin/talk7_facsimile.xml" rel="nofollow">http://tei.oucs.ox.ac.uk/Talks/2009-07-dublin/talk7_facsimile.xml</a>. However, the attributes designated for storing x and y coordinates of the annotations only accept literal pixel coordinates, i. e., they must be positive integers. For annotations made in OpenLayers, for example, the x and y coordinates are represented relatively within the bounds of the image, which are dynamically calculated based on the height and width of the source image file. Therefore, the surface element may appear as follows: <div class="bb_syntax"><table><tr><td class="line_numbers"><pre>1 </pre></td><td class="code"><pre class="xml" style="font-family:monospace;"><surface ulx="-0.86269991934014" uly="0.34903242955874003" lrx="-0.053827751" lry="-0.216358041"/></pre></td></tr></table></div> The values of these attributes are invalid according to the schema. Ideally, I would like to use an official schema. Are there other semantically acceptable ways to encode these coordinates? Or should I edit the schema and validate on a local, modified copy? Furthermore, should I send an email out to a TEI list with this use case? It seems plausible that other projects may want to annotate images in this way, and perhaps the attributes should be relaxed to accept decimal numbers rather than integers. quinnanya on "Planning for link rot in article bibliography" http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2126 Mon, 28 Oct 2013 11:46:08 +0000 quinnanya 2126@http://digitalhumanities.org/answers/ Replying to @kevin.s.hawkins's <a href="http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2119">post</a>: Thanks, Kevin! perma.cc looks perfect for this. When I went to the webpage and saw it a "request beta access" sign-up form, I wasn't optimistic that it'd be ready in time for me to submit the paper. To my surprise and delight, though, I got a beta account notification yesterday, so now I'm set. quinnanya on "Planning for link rot in article bibliography" http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2122 Tue, 22 Oct 2013 11:23:06 +0000 quinnanya 2122@http://digitalhumanities.org/answers/ Replying to @<a href='/profile/acrymble'>acrymble</a>'s <a href="http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2120">post</a>: Neat, I didn't realize you could do that. I think it runs into the same basic problem, though, as my scenario #2: all in all, there's probably 100 relevant pages (including child and grandchild pages), and I'd rather avoid saving them all individually if possible. acrymble on "Planning for link rot in article bibliography" http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2120 Tue, 22 Oct 2013 09:22:51 +0000 acrymble 2120@http://digitalhumanities.org/answers/ Replying to @<a href='/profile/quinnanya'>quinnanya</a>'s <a href="http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2117">post</a>: You could ask the Internet Archive to archive the pages in question (<a href="http://faq.web.archive.org/can-i-get-just-one-page-archived/" rel="nofollow">http://faq.web.archive.org/can-i-get-just-one-page-archived/</a>) and then use the links in the archive. Kevin Hawkins on "Planning for link rot in article bibliography" http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2119 Tue, 22 Oct 2013 09:11:07 +0000 Kevin Hawkins 2119@http://digitalhumanities.org/answers/ Maybe use <a href="http://perma.cc/" rel="nofollow">http://perma.cc/</a> . This is a brand new service that's been getting a fair amount of publicity. Dorothea Salo on "Planning for link rot in article bibliography" http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2118 Tue, 22 Oct 2013 09:06:41 +0000 Dorothea Salo 2118@http://digitalhumanities.org/answers/ You could link to an Internet Archive version of the page, should that exist. That would have the added benefit of dating your access (up to a point; it won't be perfectly precise). quinnanya on "Planning for link rot in article bibliography" http://digitalhumanities.org/answers/topic/planning-for-link-rot-in-article-bibliography#post-2117 Tue, 22 Oct 2013 08:58:26 +0000 quinnanya 2117@http://digitalhumanities.org/answers/ I'm working on an article where most of my bibliography entries involve links to university wiki pages, or documents hosted by that same wiki service. I don't have a ton of confidence that the service will necessarily exist in five years, or at least, that it will exist in a way that won't break all the links. I'm personally committed to ensuring that the content remains available; in the past, when I've just needed a reliable link to an isolated wiki page, I've re-posted wiki content on my own website and used that link. It'd be harder to do that here, though, because in many cases I'm referencing entire sections of the wiki, consisting of multiple pages. When/if the day comes for me to "rescue" the whole thing, I'd probably take a different approach than re-posting content. I'd also expect that when/if the wiki service shuts down or changes, it probably won't be possible to set up (even temporarily) a redirect to wherever I'm hosting the content instead. Any suggestions for what I should do about these links in the paper? The three options that've come to mind, in increasing order of appeal, are: 1) Just use the current links, and get over it. 2) Include a link to a page on my own site somewhere in the paper, where I'll maintain a current list of reference URLs. 3) Look into creating an <a href="http://www.cdlib.org/services/uc3/ezid/">EZID</a> for each of the links, and use that to update the URL (I'm not 100% sure if I'll be able to get access to the EZID service). Has anyone come up with an elegant solution for this? Kevin Hawkins on "TEI question" http://digitalhumanities.org/answers/topic/tei-question#post-2053 Thu, 01 Aug 2013 22:33:56 +0000 Kevin Hawkins 2053@http://digitalhumanities.org/answers/ DigitalHumanitiesScholar, let me make sure I understand the situation. You have a transcription of a source document in plain text and you want to add just enough markup to identify section headings, people, places, and footnotes. Is that right? An XML schema only allows certain elements to nest within certain others, and the TEI schemas that come with <oXygen/> XML Editor similarly allow only certain elements in certain places. So you can't take a plain text document and add only <head>, <person>, <place>, and <note>. Now, perhaps you are already planning to have <TEI> containing a <teiHeader> and a <text>, and the <text> will contain a <body>, and then you wanted to put your whole transcription inside <body>. While such a document would validate according to the schemas in <oXygen/> XML Editor, as soon as you begin adding <head>s, you will need to break the document into <div> or <div1> elements, each of which starts with a <head>. For a personal or place name mentioned in passing in the text, you should use <name type="person"> or <persName> and <name type="place"> or <placeName>. The <person> and <place> elements are meant only for providing biographical and prosopographical data that occurs in certain types of documents, or which is added when creating a scholarly edition in TEI. See chapter 13 of the TEI Guidelines. As for encoding footnotes, see section 3.8.1, which discusses whether to insert the <note> at the point of attachment (as in the examples in this section) or whether to use <ptr> or <ref> at that location instead. For an example that uses <ref>, see the cross-reference to section 3.6, which gives this example: <pre> annotated text <ref target="#a51" type="noteAnchor">⁵¹</ref>  <note xml:id="a51" type="footnote">text of annotation</note> </pre> DigitalHumanitiesScholar on "TEI question" http://digitalhumanities.org/answers/topic/tei-question#post-2051 Mon, 29 Jul 2013 02:51:21 +0000 DigitalHumanitiesScholar 2051@http://digitalhumanities.org/answers/ Hi, I have a beginners question re TEI 5 and would be grateful for any suggestions re same. How does one begin to encode metdata? ie: I have a transcription and am doing a very light encoding thereof - just <head></head>, <person></person>, <place></place> (which hopefully are correct!). If I have footnotes re certain parts of the main body of text, how to encode it and where to I place it in the TEI that I am writing in Oxygen Editor (ie: How do I show what the info refers to? Do I keep the footnote system?) Thanks.