Create regesta with XML-Mind - Tutorial

This tutorial describes how to create regesta for charters with the help of XML-Mind editor (http://www.xmlmind.com/xmleditor/), the DTD schema and a CSS style sheet by Georg Vogeler. The resulting XML can be converted to cei-MOM with a XSL stylesheet directly or via this page.

Example file, Empty file (use this to start a new project).

Content



General

Overview of the User Interface

screenshot 010

  1. area for text input or "text panel"
  2. area for input of elements or "element panel" (to be entered by pressing CTRL-T or CTRL-J or by clicking in it)
  3. area of input of attributes or "attribute panel" (to be entered by CTRL-E or by clicking in it)

Shortcuts



How to create a new record?

click on the dotted frame of the preceding record to select it:
screenshot 001

press Crtl-J (or Menue: Edit->insert after)

screenshot 101

On the right in the upper part "Regest" is displayed and highlighted.

press Return:
screenshot 002

It appears a new dotted frame to insert the new record. The cursor is placed in the grey field in top of the frame, where you can enter the number of the charter.

screenshot 003

Text of abstract:

Move the cursor in front of the grey field in the next line by clicking there or by pressing the "move-right" button on your keyboard.

screenshot 112

and write your text. The grey field vanishes.

screenshot 013



Add markup in the regest

Inside of the regest you can mark:

Mark the word
screenshot 102

press Crtl-T and select in the upper part on the right side the appropriate element.

screenshot 004

and press Return

screenshot 008

Citations are displayed in italics with a grey background colour, place names and index entries with a yellow background colour.

screenshot 007

When marking a place name you can add a alternative version to be used in the index. Click in the passage marked as index and press Ctrl-e and enter "reg" into the upper field of the attribute area. After pressing Return you can enter the version to be displayed ("regularized version").

Date and place of issuing:

Place of issuing

If you want to state a place of issuing, put the cursor in the abstract and press Ctrl-J. The focus changes to the element area where "Ausstellungsort" is selected. Press Return.
screenshot 105
A new line on the right margin appears, starting with "Ausstellungsort:".

screenshot 106

You add/mark a placeName as citation from the original as described above.

Date of issuing

Position the cursor in front of the grey area after "Ausstellungsdatum: " (with the mouse or by pressing the move-right-button on your keyboard twice. Then insert the date in your preferred format.


screenshot 107

You can add a normalised version of the place to be displayed in the index by pressing CTRL-E and selecting "reg" in the attribute panel on the lower right side.



Normalised version of the date

To add the normalised version (as numeric value): press Crtl-E. The cursor moves to the attribute area in the lower right side.

screenshot 109

Replace the three question marks with a date in the format YYYYMMDD and press Return

Replace unkown parts of the date with 99: 1348 Mai => 13480599.

screenshot 110

Other information (archival signature, description, bibliography etc.)

Any other data can be entered in the same way: Press Ctrl-J to created the element (if not already visible), select the element in the upper right field, click on the grey field appearing and enter your data. The following elements are possible:

Archival identification

Click on the grey field after the caption "Archival Identification" and enter your data screenshot 012

To change the form of transmission from the default value "orig.", to "ins." (for inserted charters") or "cop." (for any other kind of copy) place the cursor in the archival identification, press Ctrl.-E. and select the value from the list behing "status".

screenshot 011

Authentication

Position the cursor in the archival Identification, press Ctrl-J, select "siegel" and enter your data at the grey field after the word "Seal".

screenshot 016

You can add more than one seal description.

Transcription of the legend

Inside the "seal"-area press Ctrl-I at the place where you want to enter the transcription, select "legend" and enter the transcription at the grey field.

The text of the transcription will be displayed in italics and with a grey background.
screenshot 020

To continue with the seal description after having added a legen, in particular to add more than one legend (e.g. recto/verso), press Ctrl-J when the cursor is in the previous legend text, select "(text)" to switch to the text modus. With Ctrl-I you can add a second legend.

Bibliography

Place the cursor in the element preceding the bibliography (e.g. the Archival identification), press Ctrl-J, select "Literatur" in the upper right panel.
htm_4390f12c

In the grey field appearing press Ctrl-I for each bibliographic entry, select "bibl" in the upper right panel.
htm_70d5cf16

It will appear a grey field between a colon (:) and a semicolon (;).
htm_m7ff1e4b0

Enter your data at this grey field
htm_1d8e8703
and classify the entry as edition ("ed."), image ("Abb."), regest ("reg.") or study ("Lit.") by pressing Ctrl-E and selecting the appropriate type in the lower right panel
htm_ma1e6232

The type will appear in front of the bibliographic entry:
htm_7dfa99c9

Add other bibliographic entries

You can add other bibliographic entries by placing the cursor in the bibliographic entry the shall precede the new entry, press Ctrl-J, select "bibl" and enter your data in the grey field between the colon and the semicolon
htm_756cae22

Classify each entry by pressing Ctrl-E and selecting the type in the lower right panel.

Physical description of the charter

If you want to enter physical description as the material, the condition and the measure of the charter, place the cursor in the element preceding the physical description (e.g. the archival identification), press Ctrl-J, select "physicalDesc". It appears a new line starting with "Writing support/material":
screenshot 036

Click on the grey field and enter the data for the material.
screenshot 037

To add other physical descriptions (condition or measures), press Ctrl-J, select in the element panel (upper right area) the appropriate element, press enter, and enter the data at the grey field:

screenshot 038

Language of charter

Place the cursor in the element preceding the language (e.g. Archival information or Seal), press Ctrl-J, select lang_MOM and press Enter
screenshot 040

Enter your data at the grey field following "Language:"
screenshot 041

Enter the source of the data

Place the cursor in the grey field following "Source of Data:" and enter your data.
screenshot 042

Introduction etc.

You can add an introduction to your file by selecting the first entry, pressing Ctrl-H, selecting "einleitung" in the element panel on the upper right and entering your date at the grey field.

screenshot 043

Inside the introduction you can add headings and paragraphs. To add the first click on the word "introduction" or putting the cursor in the grey field and then press Ctrl-J and select the element "h" for headings or "p" for paragraphs in the element panel on the upper right.



How to add elements when CTRL-J doesn't seem to work

or: How to select an existing element

If CTRL-J doesn't seem to work, although the general possibility to add a new element after the current is given, it is usually due to the nesting of the elements, i.e. the only text shown is that of a subelement to the element to which you want to add.

For example: If you want to add the bibliography after physical description, clicking into the text of the physical description and pressing CTRL-J in the element panel would give you the choice only between other subelements of the physical description but not the seal or the bibliography.

To solve the problem you have to select the upper element (in the example the physical description). That can be done by clicking at the name of your upper element in the grey bar above the the panels:

screenshot 021

and then pressing CTRL-J.

In General you can select a text element in three ways:

  1. By putting the cursor in the text (or the grey field substituting the text) of the element (but be aware, some element higher in the hierarchy don't have own text but only text of the sub elements!),
  2. by clicking on text / frames surrounding automaticaly the element (e.g. "Archival Identification", "Seal" etc.) or
  3. by clicking on the name of the element in the hierarchy bar between menu and panels

screenshot 201



How to delete elements / markup

Place your cursor in the text area you want delete, select in the grey adress line under the icon bar the section/element you want to delete and delete it by click with the right mouse button on the element and selection "delete"

screenshot 021

If you only want to delete the markup (e.g. taking a phrase out of the index) put the cursor into the text of the element, press CTRL-T and select "(text)" in the element panel on the upper right side.

screenshot 202



Save, load and print

Save the data pressing Ctrl-S or via the menue file -> save / save as. Open a save file via Ctrl-O or the menu file -gt; open. Use ".xml" as file extension.

You can print your data with the menu file -> print. With the help of PDF-printer (like FreePDF XP http://www.freepdfxp.de) oder CutePDF (http://www.cutepdf.com) you can create a PDF from your file.



How to convert the file to MOM-xml?

The resulting XML-File can be converted to cei-MOM via this page.



How to create a new file

Download the null.xml-file and into the same directory where you saved the CSS files, and open it in the editor.


General Remark

The method described here does not depend on a specific software. It can be applied with any kind of XML-editor which allows css-supportes xml-rendering and editing, but certainly any other software would have produced other screenshots so I decided to go for the XML-Mind-Editor which is at the moment freely available. Other editors capable of CSS-rendered editing include oXygen or XMLSpy, which are commercially licensed.