Magent: config template for Artificial Dumb festival lineup readers

2026-10-07T20:57:08Z

config template for Artificial Dumb festival lineup readers

New page

<noinclude>
== Festival source ==
Marks a page as a place an [[PickiPedia:Artificial Dumb|Artificial Dumb]] tool
can read a festival lineup from, and says how to read it.

One source page per festival per year. The page is config, not an article: it
exists so that the knowledge of ''where a lineup is published'' lives with the
people who go to festivals rather than with the people who have commit access.

=== Usage ===
<pre>
{{Festival source
|url=https://example.com/festivals/thing-2026/
|kind=html-list
|festival=Thing
}}
</pre>

Then, on the same page, the patterns:

<pre>
<pre class="lineup-patterns">
scope-from: class="lineupblock"
scope-to: </ul>
^(?P<artist>[A-Z0-9][^|]{1,70})$
</pre>
</pre>

=== Why the patterns go in a <nowiki><pre></nowiki> block ===
Because "|" is syntax to template parameters ''and'' to SMW properties, and a
regex made of alternations is mostly pipes. A pattern containing
<code>(?:Main Stage|Dance Tent)</code> comes back truncated from either. Read as
raw wikitext, a <nowiki><pre class="lineup-patterns"></nowiki> block survives
byte for byte. The podcast parsers learned this first and the hard way.

=== Parameters ===
* '''url''' - Where the lineup is published.
* '''kind''' - How to read it. In order of preference:
** <code>json-ld</code> — the site's own schema.org markup. Best: it cannot be broken by a redesign.
** <code>ical</code> — a calendar feed. Unambiguous dates.
** <code>html-table</code> — a schedule table. Needs a <code>cols:</code> line.
** <code>html-list</code> — anything else, read with regexes. Needs a scope.
** <code>pdf-text</code> — not implemented. Many schedules are only a PDF poster; this is left undone rather than done badly.
* '''festival''' - The series page, for the wikitext the reader offers to write.

=== Directives ===
These go in the pattern block alongside the regexes.
* <code>scope-from:</code>, <code>scope-to:</code> - Regexes bounding the region the lineup is in. '''Use them.''' A pattern loose enough to match a bare band name is loose enough to match "Privacy Policy", and a scope that stops matching is treated as an error so that a redesign halts the run instead of quietly shortening the lineup.
* <code>cols:</code> - For <code>html-table</code>: the column meanings, in order, e.g. <code>cols: time, artist, stage</code>. Deliberately not read from the table's own headers, which work until a festival writes "Who" instead of "Artist".

=== A caution about aggregators ===
A listing site is a '''secondary source''' and should be marked as one on the
pages it feeds. It is often the only machine-readable lineup available —
festival sites are frequently a single poster image — but it is one remove from
the festival, and festivals change their lineups.

[[Category:Festival templates]]
</noinclude><includeonly>{| class="wikitable" style="width: 100%; background: #f4f4f0;"
|-
! colspan="2" style="background: #cc9; text-align: left;" | Festival source{{#if:{{{festival|}}}| for [[{{{festival}}}]]}}
|-
! style="width: 7em;" | Lineup at
| {{#if:{{{url|}}}|[{{{url}}} {{{url}}}]|''(no url given)''}}
|-
! Read as
| <code>{{{kind|json-ld}}}</code>
|}
[[Category:Festival sources]]</includeonly>

Template:Festival source - Revision history

Magent: config template for Artificial Dumb festival lineup readers