Applications for Encoders
Encoders will find the following resources useful in determing, accelerating, and reviewing their workflow.
Search the MoEML Praxis
Use the advanced search feature to find keywords or phrases in our documentation.
Access the Index for Praxis
The index for MoEML’s praxis allows the user to search for common terms, elements, and attributes across praxis documents. The praxis index file (praxis_index.htm) is generated through a transformation that processes
<div>s in praxis documents. The transformation compiles, sorts, and groups the following:
- Manually encoded
<term>s nested in
- Elements (tagged as
<gi>s) and attributes (tagged as
@atts) referenced in documentation
- Elements and attributes used in example code (tagged as
Use the Index
If you know the term you are looking for, use CTRL+F (⌘+F on Apple computers) to navigate through the file. Otherwise, you can browse the index by either scrolling through the file or using the linked list of first letters at the top of the file. Once you find the term you are looking for, the list of pages nested beneath it will indicate where the term occurs in praxis. Click on the links to access the pages or, in the case of elements and attributes, click on the CodeSharing or TEI links to access external documentation.
Regenerate the Index
The index file (praxis_index.xml) does not update automatically, so it must be manually regenerated every time index information is added to a praxis document. To regenerate the index file, run the IndexCreator scenario in oXygen. Open IndexCreator.xsl, which can be found in the Utilities folder in SVN, and press the red
playbutton in the top menu (CTRL+Shift+T) to apply the transformation scenario. Finally, commit the revised index file to SVN and upload it to eXist.
General Encoding Practicesfor information on indexing praxis documents.
Find an Item in the Document Collection
A-Z Index of All Items in the Document Collection(ids.htm) contains a list of all published and unpublished documents in the MoEML document collection sorted by title, document type, and
@xml:id. Use this document to determine which
@xml:ids are in use as well as to quickly determine if a particular person, location, or bibliographic source has been added to our document collection. Note that ids.htm is different from azindex.htm insofar as the former contains both published and unpublished content whereas the latter contains only published content.
@xml:id and a New Location Document
next available @xml:idapplication to assist you in assigning unique identifiers to elements in the project. Enter the first four letters of a proposed
@xml:idand this application will return an identifier unique to the project’s document and spreadsheet collection that consists of the same four letters followed by a number.
This application also gives you the option to create a new location document using the next available
@xml:id. A link labelled
create a new MoEML location documentwill appear along with the next available
@xml:id. Clicking on this link will produce a form. If you fill out and submit this form, the application will generate a complete location document that is ready to be added to SVN.
For more information about how to use
@xml:ids, see section 16.1 (
Links) in TEI P5: Guidelines for Electronic Text Encoding and Interchange.
Search For Encoding Examples
Search for examples of MoEML’s TEI encoding using our CodeSharing Service. This features allows you search the entire back end of the website to see how the project employs certain elements and attributes. The program can also generate lists of used attributes and elements, as well as the namespaces used on the website.
Simply fill out the search form, hit Submit, and wait for the results to appear below.
For more detailed instructions, please visit The CodeSharing Protocol for TEI Markup.
Identify Unmapped Locations
The Agas Progress Report is a document created through XSLT which lists all locations in our document structure that are not on the Agas map. These locations fall into four categories based off of information contained within each location’s
- Locations identified on the deprecated Agas map (the
Star map) that have geo-coordinates;
- Locations identified on the Star map without geo-coordinates;
- Locations not identified on the Star map but have geo-coordinates;
- Locations neither identified on the Star map nor have geo-coordinates.
To generate the report:
- Make sure you have the MoEML project open in Oxygen (Project/Open Project, then locate the
moeml.xprproject file in
/db/dataor in the root of your MoEML documents).
- Open the file /db/data/utilities/agasProgressReport.xsl.
- Run its default transformation (Document/Transformation/Apply Transformation Scenario(s), or click on the red triangle button () in the toolbar).
- The report should automatically open in your browser.
Check if MoEML is Down
Last modification: 2016-05-27 14:37:29 -0700 (Fri, 27 May 2016) (tlandels)