Skip to content

Publish /en/lessons/introduccion-a-tei-1 #3658

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 14 commits into
base: gh-pages
Choose a base branch
from
Open

Publish /en/lessons/introduccion-a-tei-1 #3658

wants to merge 14 commits into from

Conversation

@anisa-hawes
Copy link
Contributor

@anisa-hawes anisa-hawes commented Oct 13, 2025 •
edited
Loading

Preparing files for publication.

Closes #3657

Checklist

  • Assign yourself in the "Assignees" menu
  • Add the appropriate "Label"
  • If this PR closes an Issue, add the phrase Closes #ISSUENUMBER to your summary above
  • Ensure the status checks pass: if you have difficulty fixing build errors, please contact our Publishing Manager @anisa-hawes
  • Check the Netlify Preview: navigate to netlify/ph-preview/deploy-preview and click 'details' (at right)
  • Assign at least one individual or team to "Reviewers"
    • [ ] if the text needs to be translated, please follow the translation request guidelines, then assign the relevant language team(s) as "Reviewers" and tag both the team as well as the managing editor in your PR.

@anisa-hawes
Upload en-tr images
a76fa85 
Upload en-tr images to directory
@anisa-hawes
Create encoding-texts-tei-1.md
592d3a6 
Upload Markdown for new EN translation.
@anisa-hawes
Update encoding-texts-tei-1.md
c693fe4 
Add doi.
@anisa-hawes anisa-hawes self-assigned this Oct 13, 2025
@anisa-hawes
Copy link
Contributor Author

anisa-hawes commented Oct 13, 2025 •
edited
Loading

Hello Alex @hawc2,

I’ve staged introduccion-a-tei-1 for publication. You can read it through in Preview. Please let me know if you notice anything which you'd like to adjust?

One thought I had is that we could improve accessibility if we were to replace Figures 11 and 12 (screenshots of tables listing possible elements within <text> and <body>) with two raw Markdown tables. Having said that, the elements that may be contained are not explained/expanded upon within the lesson, so perhaps the tables (and indeed those two screenshots provide more detail than is needed/explored here. An alternative could be to provide a link to the sections of the TEI guidelines referenced in these two captions. I'd be pleased to hear your thoughts.

Thank you,
Anisa

@anisa-hawes
Copy link
Contributor Author

anisa-hawes commented Oct 13, 2025 •
edited
Loading

I've quickly converted the source html from those two sections of the TEI guidelines into raw Markdown. If you like the idea of this option, I can make this change (add two tables, remove two figure images). Table 1 would replace Figure 11, Table 2 would replace Figure 12.

--

Module May Contain Elements
analysis interp, interpGrp, span, spanGrp
certainty certainty, precision, respons
core cb, ellipsis, gap, gb, index, lb, milestone, note, noteGrp, pb
figures figure, notatedMusic
iso-fs fLib, fs, fvLib
linking alt, altGrp, anchor, join, joinGrp, link, linkGrp, timeline
spoken incident, kinesic, pause, shift, vocal, writing
textcrit app, witDetail
textstructure back, body, front, group
transcr addSpan, damageSpan, delSpan, fw, listTranspose, metamark, space, substJoin

Table 1. List of elements that can appear within <text>.

--

Module May Contain Elements
analysis interp, interpGrp, span, spanGrp
certainty certainty, precision, respons
cmc post
core bibl, biblStruct, cb, cit, desc, divGen, ellipsis, gap, gb, head, index, l, label, lb, lg, list, listBibl, meeting, milestone, note, noteGrp, p, pb, q, quote, said, sp, stage
dictionaries entry, entryFree, superEntry
drama camera, caption, castList, move, sound, spGrp, tech, view
figures figure, notatedMusic, table
header biblFull
iso-fs fLib, fs, fvLib
linking ab, alt, altGrp, anchor, join, joinGrp, link, linkGrp, timeline
msdescription msDesc
namesdates listEvent, listNym, listObject, listOrg, listPerson, listPlace, listRelation
nets eTree, forest, graph, listForest, tree
spoken annotationBlock, incident, kinesic, pause, shift, u, vocal, writing
tagdocs classSpec, constraintSpec, dataSpec, eg, egXML, elementSpec, macroSpec, moduleSpec, outputRendition, schemaSpec, specGrp, specGrpRef
textcrit app, listApp, listWit, witDetail
textstructure argument, byline, closer, dateline, div, div1, docAuthor, docDate, epigraph, floatingText, opener, postscript, salute, signed, trailer
transcr addSpan, damageSpan, delSpan, fw, listTranspose, metamark, space, substJoin

Table 2. List of elements that can appear within <body>

@anisa-hawes
Copy link
Contributor Author

anisa-hawes commented Oct 13, 2025

Hola @jenniferisasi,

I just want to bring you into this conversation, as it may be that we have an opportunity to improve the accessibility of the ES original lesson introduccion-a-tei-1 as well.

The two figures I am proposing we could potentially replace with raw markdown tables (above) are found in the sections El elemento , labelled with the captions Elementos posibles de and Elementos posibles de .

anisa-hawes and others added 11 commits October 13, 2025 18:12
Merge branch 'gh-pages' into publish-introduccion-a-tei-1
eab70c0
@anisa-hawes
Update encoding-texts-tei-1.md
35e67b5 
Minor edits (primarily, to remove phrases that use metaphors for sight as understanding).
@hawc2
Final review and proof
9da36df 
Adding minor changes and improvements to formatting and style
@hawc2
Change difficulty level from 2 to 1
6ac4aae 
This should be described as an Introductory level lesson
@hawc2
Clarify XML section heading
10bf1be 
Updated the section heading from 'XML' to 'What is XML?' for clarity.
@hawc2
Correct capitalization in lesson title
e804ae8
@hawc2
Update software section for TEI encoding lesson
71772e3 
Reorganize section on software for text encoding and TEI.
@anisa-hawes
Update encoding-texts-tei-1.md
f4eef6e 
- Update `translation_date:`
- Correct link syntax, line 47
@anisa-hawes
Update encoding-texts-tei-1.md
08a14b3 
- Apply copyedits
- Update figure numbers in captions (images to be renamed due to restructuring of this lesson)
@anisa-hawes
Replace en-tr images 01-10
6a3abbd 
(renumbered due to restructuring of the lesson)
@anisa-hawes
Update encoding-texts-tei-1.md
dff5112 
Adjust filenames for figures (renumbered due to restructuring of the lesson)
@anisa-hawes
Copy link
Contributor Author

anisa-hawes commented Nov 7, 2025

I've noted the build error, and have started to investigate next steps: #3670

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@anisa-hawes anisa-hawes

Labels

English

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Preparing to publish a new EN translation from ES: encoding-texts-tei-1

3 participants

@anisa-hawes @hawc2