Bosser dur pour que les marathoniens du #RunInLyon 2025 aient de quoi 𝘭𝘪𝘳𝘦 et 𝘴'𝘪𝘯𝘧𝘰𝘳𝘮𝘦𝘳 pendant leur épreuve de 10km ? C'est bien la moindre des choses.
Bonne course à tou·te·s ! 🏃
www.runinlyon.com
#Balisage #Parcours #Lyon #RunIn #CRV #5octobre
Balisage de la chatte
Le balisage est le processus d'étiquetage ou de marquage dans un environnement donné, notamment pour guider ou délimiter un espace. #Balisage #Etiquetage #Marquage #Environnement #Guide
#balisage HC: More to do
Guidelines themselves need to be made more accessible.
Add more language support.
Some content from old site not in new site yet. Want to be selective and prune cruft.
Incrementally improve: which is now easier to do than in the Wordpress world.
#balisage HC:
So: is this better?
A: It is for me [HC]
Seems better for users: these users are nerds, find editing Markdown easier than Wordpress. Lots of mental overhead.
Likely better support for internationallization.
Much more accessible.
#balisage HC:
Documentation is separate repo, so mount as subproject and pull it in during build
#balisage HC:
Documentation repository
TEI XML files
Needs to be integrated website in a couple of places, render to HTML
So extend 11ty to support TEI XML; use CETEIcean to do that
#balisage HC:
TEI guidelines has separate and complex build system with multiple targets, but does have to integrate with website (unlike the vault); same menu structures etc.
#balisage HC:
What wasn't managed by CMS?
TEI guidelines themselves
The Vault (but all static, fixed)
The Documentation repository
#balisage HC: recap
Handcrafted static HTML =>
Static HTML generated from XML =>
Dynamically processed HTML from XML =>
Same, managed by CMS =>
HTML goop =>
Static HTML generated from source
#balisage HC:
Sept 3rd 2024: New website!
Think it looks better.
Responsive sizing
Static site => vastly harder to hack
Built using Eleventy (https://www.11ty.dev
Sources on github repository (github as CMS)
Most sources in Markdown now
#balisage HC:
2019-2024 Wordpress still
Find it not nearly as easy as it was supposed to
Wordpress makes terrible markup
Every week new and exciting exploits so have to keep updating plugins
Proposed in 2023 to migrate to static site, ETA 1 year
#balisage HC:
2019: More churn
Needed to find stable home => Huma-Num but ended up doing it in more of a rush than we had expected
#balisage HC:
Time for content management systems
2007: mildly hacked OpenCMS (for next decade); edited via Java applet
mid 2018: Move to WordPress
Feb 8th, 2018: DISASTER!
Catastrophic disk failure (backups, but restoration took a very long time) moved to new infrastructure
#balisage HC:
1999 1st consortium webpage:
Very straightforward HTML
2001 more professional appearance; tables for layout; "this was generated from XML master"
2005 new design; XML pages dynamically rendered with Apache Cocoon ("where possible")
#balisage HC: History of the website
Background: TEI (Text Encoding Initiative) began in 1987, consortium formed in 1999
Parts of TEI website predate consortium:
(From archive.org) hand-crafted HTML
#balisage
(Re)building the TEI website: a bit of history and new directions—Hugh Cayless
www.balisage.net/Proceedings/vol30/html/C...
#balisage Q&A suggests looking at OpenLyrics as a target
#balisage EB:
In text analysis course?
Requires encountering multiple cultures in text analysis: flat strings/token streams vs structuralists: useless to be exposed to that
More of an adventure for students
Continue to teach? I think so
#balisage EB:
What did we learn?
Was it worth it?
Greatly enhanced command line upskilling
Grammar-writing encourages appreciation of meaningful structures
Learning as an art form
IXML vs regex search/replace
more elegant, harder, less sequential, more installations, more declarative
#balisage MS:
Look at iXML over ChordPro
Getting rid of ambiguity relied on special nullableText which also excluded meta charactrers
#balisage MS:
MEI focused on presentation of sheet music
MusicXML also to much so
ChordPro is non-XML markup, but closer to what we want and there is UltimateGuitar to ChordPro converter at https://ultimate.ftes.de
Discovered this after semester, but would have been much better for us
#balisage MS:
Weren't able to find good way to distinguish chord lines from text lines in iXML; just anything-that-isn't-eol
Ended up with "monster regex" in XSLT
#balisage MS:
Source => iXML => XSLT => output XML | output lyrics| output chords
Initially looked at Music Encoding Initiative but that is focused on sheet music so didn't work well for us
#balisage MS:
e.g.
Am Ammaj9 Am7 D/F# FMaj7 G Am
Lyrics below
Sometimes just lyrics, sometimes just chords
#balisage MS:
Project: Greta Van Zeppelin; comparing chord structures
ultimate-guitar.com for chords and tabs
Manual copy and paste; scraping didn't really work easily here [ouch]
#balisage EB:
Prep: battle testing group
Lots of command line shell stuff to learn
Various tools set up properly
Windows/Mac/Linux
Needed 2 separate installation instructions because Windows setup was so different
#balisage EB:
Class undergrad 200 level
Large-scale text analysis
Had been known as "regex and python course"
This year wanted a more XML-forward approach:
Too much "here, take this library" too little logical thinking
So: why not try teaching iXML?
#balisage EB/MS links
Slides: https://slides.com/elisabeshero-bondar/ixml-chord
Our Class Installation Instructions: github.com/newtfire/textAnalysis-Hu...
Project Website: https://afish2003.github.io/GretaVanZeppelin/
GitHub […]
#balisage
Is Invisible XML Ready for Undergraduates? Trying iXML and XProc on a Music Analysis Project in an Undergraduate Text Analysis Course—Michael Simons, Elisa E. Beshero-Bondar
www.balisage.net/Proceedings/vol30/html/B...
#balisage ST:
Another whitespace challenge:
pretty printing with spaces vs TABs
So: used a helper transform to strip whitespace
