Overview

A research colleague introduced me to “FairCopy,” a TEI text creation support tool. This tool allows you to create TEI texts through a GUI, and I found it very useful.

It is a paid tool, but you can try it for free for 2 weeks, so I am sharing my findings here.

Installation

By submitting your information through the Sign Up page below, a trial code and the application download link will be displayed.

https://faircopyeditor.com/sign_up

After downloading and launching the application, a project selection screen like the following will appear.

Creating a Project

Create a project. For this example, I entered the following information.

After that, the following screen will be displayed.

Data to Create

This time, I will attempt to reproduce the TEI data for “Kiritsubo” from the publicly available Koui Genji Monogatari Text DB using this tool.

https://kouigenjimonogatari.github.io/tei/01.xml

This is a TEI/XML file that maps IIIF images published by the National Diet Library to text data transcribed by the project.

Creating a New Resource

Click “NEW RESOURCE” to display the following registration form. Assign an appropriate Name and ID.

For “Resource Type,” multiple options are displayed. If you want to create an XML file combining TEI with a TEI Header and IIIF, selecting “TEI Document” seems to be the best choice.

As a result, a “TEI Header” file is created inside the “Koui Genji Monogatari - Kiritsubo” folder as shown below.

Importing IIIF

First, let’s try importing IIIF images. Press the “IMPORT IIIF” button and enter the URL in the IIIF manifest import screen as shown below.

I entered the following manifest URL.

https://www.dl.ndl.go.jp/api/iiif/3437686/manifest.json

The images are then added as shown below.

Clicking on the row shows the images from the manifest file being imported. You can see that each image is assigned an ID in the ID column. These will be used later for linking text with images.

Clicking the image icon in the upper right of the screen also allows you to view the images.

For reference, returning to “Koui Genji Monogatari - Kiritsubo” and selecting the checkbox on the image row, then clicking “ACTIONS” > “Export,” outputs an XML file as shown below.

This creates an XML file containing the facsimile element as follows.

<<?T<<xEf<<<<.TmIas<</s<<.fElculgsulgs.aIxsraruraruc>vmifbarfbarselmaepfaepfirniclhaclhamssle>ice>icii=e1ce2celo"x<>x<>enhsm/mm/m>=tallilli"tm:am:am1peibeibe.:AdeTdeT0/s=ly=ly"/=">p">pw"fefeewh0=0=nwt0"0"c.t0a1aotp"p"pdesppii:ululn-/liligcxcxc=.w=a=a"ow"t"tUrw0i0iTg."o"oFdnn-nlu/u/8s.ljlj"nysys?1d=o=o>.l"n"n0.0"0""g"">ouu.lrlrjrlrlpx=x=/="="a"h"hp6t6ti8t8t/9p9pi0s0si":":i//fl/l//rwrw3ywyw4=w=w3".".74d4d67l7l80.0.66n6n/"d"dmllas.s.nagagimomofe.e.eAjAjsspspt=/=/."a"ajhphpstitiot/t/npipi"sisi>:i:i/f/f////w3w3w4w4w3w3.7.7d6d6l8l8.6.6n/n/dRdRl0l0.0.0g0g0o0o0.0.0j0j0p1p2/"/"a/a/p>p>ii//iiiiiiff//33443377668866//ccaannvvaass//12"">>

Later, we will export a TEI/XML that combines the TEI Header with text - body, but as shown above, the tool provides functionality to export TEI/XML for individual elements such as images, text, and TEI Header.

Importing Text

Next, let’s import text. For now, register a sample text file as follows.

A text entry named sample is registered as shown below.

Clicking on the row displays the text editing screen as shown below.

Since the content would become too extensive, I will cover the operation of this editing screen in a separate article.

One key point is that you can select which tags to use for each project, as shown below, which helps avoid confusion from the large number of TEI tags.

As a result, the text was created as follows. By mapping it to images, you can confirm that the corresponding page images are displayed on the right side of the screen.

Editing the TEI Header

Next, edit the TEI Header. Since the editing method is the same as for the text above, I will explain the details in a separate article.

While still partial, the TEI Header can also be edited using the GUI as shown below.

Export

The TEI Header, text, and images created so far can be merged and exported as a single TEI/XML file.

Return to the project top screen, select the relevant rows, and click “Export” from Actions as shown below.

The following XML file is output as a result.

<T<<<<<<Et<<f<<<<<<<<<<<<.t<<TIef<<<<<<tas<</s<</s<</s<</s<</s<<.feb<<tEiit<</p</s<feculgsulgsulgsulgsulgsulgs.axop<<<<<<beIxHlitatuppopsiisraruraruraruraruraruraructd>lplslspox>meetiuib>uu>olHifbarfbarfbarfbarfbarfbarsybbbebe>dtlaDltttlbrueemaepfaepfaepfaepfaepfaepfix>//g/gy>ndeelhlilcrDaiclhaclhaclhaclhaclhaclhamm>f>>>sesSeoeciecedle>ice>ice>ice>ice>ice>icilacc=rct>rSacDesee1ce2ce3ce4ce5ce6cel:coo">m>ttaeDcrx<>x<>x<>x<>x<>x<>eisrrhxtmits<e>>sm/mm/mm/mm/mm/mm/m>d=rrtm>toic/sallillillillillilli="eetl>no>pcm:am:am:am:am:am:am"#ssp:S<n>>eibeibeibeibeibeibesfpp:i<t/SAdeTdeTdeTdeTdeTdeTa0==/d/mpts=ly=ly=ly=ly=ly=lym0""/=at>m=">p">p">p">p">p">pp5hhw"u>t"fefefefefefel"ttwht>h0=0=0=0=0=0=ettweht0"0"0"0"0"0""npp.a<t0a1a2a3a4a5a>=sstdrp"p"p"p"p"p"p"::eet>spppppp5//iri:ulululululul"//-"t/lililililili/wwc>l/xcxcxcxcxcxc>33.ew=a=a=a=a=a=aiio>w"t"t"t"t"t"tddrw0i0i0i0i0i0i..g."o"o"o"o"o"ooo/dnnnnnnrrnlu/u/u/u/u/u/ggs.ljljljljljlj///nysysysysysyskk1d=o=o=o=o=o=ooo.l"n"n"n"n"n"nuu0.0"0"0"0"0"0"ii"g""""""gg>ouuuuuuee.lrlrlrlrlrlrnnjrlrlrlrlrlrljjpx=x=x=x=x=x=ii/="="="="="="mma"h"h"h"h"h"hoop6t6t6t6t6t6tnni8t8t8t8t8t8too/9p9p9p9p9p9pggi0s0s0s0s0s0saai":":":":":":tti//////aafl/l/l/l/l/l/rr/rwrwrwrwrwrwii3ywywywywywyw//4=w=w=w=w=w=waa3".".".".".".pp74d4d4d4d4d4dii67l7l7l7l7l7l//80.0.0.0.0.0.ii66n6n6n6n6n6ntt/"d"d"d"d"d"deemllllllmmas.s.s.s.s.s.ssnagagagagagag//imomomomomomo00fe.e.e.e.e.e.00eAjAjAjAjAjAj00sspspspspspsp55t=/=/=/=/=/=/--."a"a"a"a"a"a00jhphphphphphp12stitititititi..ot/t/t/t/t/t/jjnpipipipipipiss"sisisisisisioo:i:i:i:i:i:innx/f/f/f/f/f/f""m////////////>>lw3w3w3w3w3w3:w4w4w4w4w4w4iw3w3w3w3w3w3d.7.7.7.7.7.7=d6d6d6d6d6d6"l8l8l8l8l8l8a.6.6.6.6.6.6pn/n/n/n/n/n/idRdRdRdRdRdRil0l0l0l0l0l0i.0.0.0.0.0.0ig0g0g0g0g0g0fo0o0o0o0o0o03.0.0.0.0.0.04j0j0j0j0j0j03p1p2p3p4p5p67/"/"/"/"/"/"6a/a/a/a/a/a/8p>p>p>p>p>p>6iiiiiim//////aiiiiiiniiiiiiiiiiiiifffffffe//////s333333t444444.333333j777777s666666o888888n666666"//////>ccccccaaaaaa<<nnnnnn//vvvvvvssaaaaaaeessssssgg//////>>123456"""""">>>>>>

Using this tool alone, I was able to create the intended TEI/XML file.

Summary

I found this to be a useful tool for reducing the cost of creating TEI/XML files. In the future, I plan to add related articles covering topics such as text data editing methods.

I hope this is helpful as a reference.