Kod |

tei-mcp

Sun, 15 Mar 2026 00:00:00 +0000

tei-mcp: TEI P5 för AI-agenter

tei-mcp är en -server med öppen källkod som ger AI-kodassistenter direkt tillgång till specifikationen . I stället för att förlita sig på memorerade träningsdata – vilket ofta ger uppmärkning som ser rimlig ut men är fel – kan AI:n fråga specifikationen i realtid.

Funktioner

Servern tolkar ODD-filen för TEI P5 och exponerar 16 verktyg:

Slå upp vilket element, vilken klass, vilket makro eller vilken modul som helst på namn, med skiftlägesokänslig matchning och förslag vid felstavning
Lös upp attribut genom hela TEI:s klasshierarki (lokala + ärvda)
Expandera innehållsmodeller till strukturerade träd med upplösning av klasser och makron
Kontrollera nästling – direkt förälder–barn eller rekursiv nåbarhet med spårad sökväg
Validera dokument mot TEI P5: innehållsmodeller, attribut, slutna värdelistor, referensintegritet och utfasningsvarningar
Validera enskilda element för stegvisa redigeringsflöden
Ladda ODD-anpassningar för att begränsa schemat till en projektspecifik delmängd
Sök bland alla entitetstyper med reguljära uttryck

Installation

pip install tei-mcp

Eller kör direkt med:

uvx tei-mcp

Användning

Lägg till i vilken MCP-kompatibel klient som helst (Claude, Cursor, Windsurf osv.):

{
 "mcpServers": {
 "tei": {
 "command": "uvx",
 "args": ["tei-mcp"]
 }
 }
}

Källkod och dokumentation finns i .

Multi-Saxon

Fri, 28 Mar 2025 00:00:00 +0000

Multi-Saxon: parallell XSLT-bearbetning av stora TEI-korpusar

Multi-Saxon fyller en kännbar lucka bland XML-verktygen genom att möjliggöra parallell körning av XSLT 2.0- och 3.0-transformationer som LXML (ett populärt XML-bibliotek för Python) inte klarar. Multi-Saxon är utformat särskilt för stora samlingar av XML-TEI-dokument och kortar bearbetningstiden avsevärt genom effektiv parallellkörning.

Huvudfunktioner

Avancerat XSLT-stöd: bearbetar XSLT 2.0- och 3.0-transformationer bortom LXML:s förmåga
Parallell bearbetning: kortar transformationstiden dramatiskt för stora dokumentsamlingar genom parallellisering
TEI-optimerat: särskilt konstruerat för XML-dokument enligt Text Encoding Initiative (TEI)
Skalbar prestanda: hanterar effektivt korpusar från hundratals till tusentals dokument
Plattformsoberoende: fungerar i olika operativsystem och miljöer

Problemet Multi-Saxon löser

Forskare inom digital humaniora som arbetar med TEI ställs ofta inför två stora svårigheter:

LXML (ett vanligt XML-bibliotek för Python) stöder bara XSLT 1.0, vilket gör det omöjligt att använda de mer avancerade funktionerna i XSLT 2.0/3.0
Att bearbeta stora TEI-korpusar sekventiellt kan ta oöverkomligt lång tid

Multi-Saxon löser båda problemen genom att utnyttja Saxons avancerade XSLT-funktioner och samtidigt fördela bearbetningen över flera processorkärnor, med betydande prestandavinster som följd.

Implementering

Multi-Saxon kombinerar Python med Javas Saxon-processor i en högpresterande transformationskedja:

använder Javas Saxon-bibliotek för robust XSLT 2.0/3.0-bearbetning
använder multiprocessing för att fördela transformationerna över tillgängliga processorkärnor
hanterar processorpooler effektivt för maximal genomströmning
erbjuder ett enkelt gränssnitt för batchbearbetning av TEI-dokument

Användningsexempel

from multi_saxon import MultiSaxon

# Initialize with your XSLT stylesheet
transformer = MultiSaxon("transform.xsl")

# Transform a single document
transformer.transform("input.xml", "output.xml")

# Transform an entire directory in parallel
transformer.transform_directory("input_dir", "output_dir")

Betydelse för digital humaniora

För projekt inom digital humaniora med stora TEI-samlingar möjliggör Multi-Saxon:

komplexa transformationer av hela korpusar som vore omöjliga med LXML
dramatiskt kortare bearbetningstider (ofta 5–10 gånger snabbare på flerkärniga system)
mer avancerad analys tack vare funktionerna i XSLT 2.0/3.0
ett enklare arbetsflöde för bearbetning av hela dokumentsamlingar

Källkod och dokumentation finns i .

persNamer

Fri, 28 Mar 2025 00:00:00 +0000

persNamer: TEI kopplat till Virtual International Authority File

persNamer är ett specialiserat Python-verktyg som förenklar integrationen av auktoriserade persondata från VIAF (Virtual International Authority File) i TEI-XML-dokument. Genom att omvandla VIAF-identifierare till färdig TEI-uppmärkning minskar persNamer avsevärt det manuella arbetet med att skapa strukturerade personposter för digitala vetenskapliga utgåvor.

Auktoritetskontrollens utmaning i TEI

Digitala vetenskapliga utgåvor kräver ofta exakt identifiering av historiska personer, med standardiserade namnformer och levnadsår. Att upprätthålla en konsekvent auktoritetskontroll genom ett helt projekt kräver att man:

identifierar personerna i de historiska texterna
hittar auktoritetsdata om dem
skapar korrekt formaterade TEI-poster
ser till att hänvisningarna är konsekventa genom hela projektet

Dessa steg är i regel manuella, tidskrävande och känsliga för inkonsekvenser.

Så fungerar persNamer

persNamer automatiserar arbetsflödet genom att:

hämta VIAF-data: utifrån en VIAF-identifierare hämtar verktyget RDF-data via HTTP-innehållsförhandling
extrahera nyckeluppgifter: tolkar RDF-data och plockar ut det föredragna namnet, födelsedatum och dödsdatum
generera TEI-uppmärkning: skapar två centrala XML-utdrag:
- en post för auktoritetsfilen (ett <person>-element med genererat xml:id, <persName>, <birth>, <death> och <idno type="VIAF">)
- en separat annotationstagg (<persName> med ett ref-attribut som pekar på auktoritetsposten)

Den dubbla utmatningen låter utgivaren underhålla en central auktoritetsfil och samtidigt enkelt infoga annotationstaggar i sina TEI-texter.

Huvudfunktioner

Standardiserad ID-generering: skapar konsekventa XML-ID:n i formatet pers-[familyname]-[givenname initial] (t.ex. pers-deteligny-c)
RDF-tolkning: använder rdflib för att hämta uppgifter ur olika RDF-egenskaper (t.ex. rdfs:label, schema:name, viaf:mainHead)
Kommandoradsgränssnitt: körs enkelt med ett VIAF-nummer som enda obligatoriska argument
Utförlig utmatning: ger detaljerad information om bearbetningen vid sidan av den färdiga XML-koden

Exempel

python persNamer.py 314802260

Kommandot ger:

<person xml:id="pers-deteligny-c">
 <persName>Charles deTéligny</persName>
 <birth>1535</birth>
 <death>1572-08-24</death>
 <idno type="VIAF">314802260</idno>
</person>

<persName ref="#pers-deteligny-c">Charles deTéligny</persName>

Användning inom digital humaniora

persNamer är särskilt värdefullt för:

digitala vetenskapliga utgåvor som kräver auktoritetskontroll
TEI-kodningsprojekt som arbetar med historiska personer
initiativ kring länkade data som kopplar dokument till auktoritetsposter
att säkra konsekvens i stora TEI-korpusar
undervisning i auktoritetskontroll på kurser i digital humaniora

Implementering

persNamer är skrivet i Python och bygger på:

requests för HTTP-anrop
rdflib för RDF-tolkning
lxml för XML-hantering

Källkod och dokumentation finns i .

ITA2-telegrafemulator

Thu, 13 Feb 2025 00:00:00 +0000

Den här ITA2-emulatorn är ett handfast hjälpmedel i undervisningen: den gör abstrakta kodningsbegrepp synliga och interaktiva. När studenterna skriver in text och genast ser den förvandlas till hålmönster lär de sig flera av datorteknikens och telekommunikationens nyckelbegrepp.

Pedagogisk nytta

För det första åskådliggör den binär representation – hur text blir mönster av ettor och nollor. Det brukar vi lära ut abstrakt, men när hålen faktiskt dyker upp blir det lättare att begripa hur fysiska system kan bära digital information.

ITA2 (Baudot-Murray) Telegraph Type Emulator

Type a word in the input below to see its representation on the ITA2 tape.

Type word:

Skiftmekanismen mellan BOKSTÄVER och SIFFROR (LETTERS/FIGURES) är en naturlig ingång till tillståndsmaskiner. Genom att pröva sig fram upptäcker studenterna att samma mönster kan stå för olika tecken beroende på vilket läge apparaten befinner sig i. Den praktiska erfarenheten av tillståndsberoende kodning förbereder dem för mer avancerade datavetenskapliga begrepp.

Teknisk utformning

Emulatorn är skriven i JavaScript och HTML/CSS och kan därför enkelt bäddas in på vilken webbsida som helst. Koden är modulär och kan anpassas till olika undervisningssammanhang.

Källkoden finns i , där du också kan pröva emulatorn själv.