Merge pull request #3 from davidmreed/paperwork

Paperwork rendering + PLT guide

build-assets/epub-metadata.txt → build-assets/epub-metadata.yaml

@@ -1,5 +1,2 @@
----
-author: Stacktrace / David Reed
 rights: Creative Commons Attribution-ShareAlike 4.0
 language: en-US
----

build-assets/epub.css

@@ -0,0 +1,84 @@
+.canonical-link {
+    display: inline-block !important;
+}
+
+h1,
+h2,
+h3, summary {
+    font-family: 'Arial Black';
+    font-weight: bold;
+    text-align: left;
+    padding: 0;
+}
+
+summary {
+    padding-top: 2em;
+}
+
+h1 {
+    font-size: 14pt;
+    border-bottom: 3pt solid;
+    border-bottom-color: black;
+    padding-bottom: 2pt;
+}
+
+h2, summary {
+    font-size: 13pt;
+}
+
+h3 {
+    font-size: 12pt;
+}
+
+h4 {
+    font-size: 11pt;
+}
+
+h5 {
+    font-size: 10.5pt;
+}
+
+html {
+    margin: 0;
+    padding: 0;
+    font-size: 10pt;
+    line-height: normal !important;
+}
+
+
+dl {
+    margin: 0;
+    padding: 0;
+}
+
+dl dd {
+    display: inline;
+    margin: 0;
+    padding: 0;
+    margin-right: 2rem;
+}
+
+dl dt {
+    display: inline;
+    font-style: italic;
+    color: inherit;
+    margin: 0;
+    padding: 0;
+    margin-right: 1rem;
+}
+
+abbr {
+    font-size: 80%;
+    text-decoration: none !important;
+}
+
+body {
+    font-size: 1.15rem;
+    line-height: 1.3;
+    font-family: serif;
+}
+
+a {
+    color: inherit;
+    text-decoration: none;
+}

build-assets/epub.lua

@@ -0,0 +1,50 @@
+function Div(el)
+    -- Discard the internal Div representing the header.
+    if el.classes[2] == "header" then
+        return {}
+    end
+
+    -- Find a Plain with content "Table of Contents"
+    -- followed by a BulletList, and drop them both if found.
+    local filteredBlocks = {}
+    if el.content then
+        for i, v in ipairs(el.content) do
+            if v.tag == "BulletList" and i > 1 then
+                previousTag = el.content[i-1]
+                if pandoc.utils.stringify(previousTag.content) == "Table of Contents" then
+                    -- Omit the previous tag and this tag
+                    table.remove(filteredBlocks)
+                else
+                    table.insert(filteredBlocks, v)
+                end
+            else
+                table.insert(filteredBlocks, v)
+            end
+        end
+
+        el.content = filteredBlocks
+    end
+
+    return el
+end
+
+function Pandoc(el)
+    -- Retain only the Div that has the role `main`.
+    -- Discard all other top-level elements, which
+    -- are HTML-only.
+
+    -- Promote this Div's own contents to top-level
+    -- This prevents Pandoc from getting confused
+    -- and adding an extra H1 to our doc.
+    -- See https://github.com/jgm/pandoc/blob/main/src/Text/Pandoc/Writers/EPUB.hs#L556
+
+    for i, v in ipairs(el.blocks) do
+        if v.tag == "Div" and v.attributes["role"] == "main" then
+            newEl = el:clone()
+            newEl.blocks = v.content
+            return newEl
+        end
+    end
+
+    return el
+end

build-assets/print.css

@@ -43,6 +43,14 @@ h3 {
     font-size: 12pt;
 }
 
+h4 {
+    font-size: 11pt;
+}
+
+h5 {
+    font-size: 10.5pt;
+}
+
 @page {
     size: letter;
     margin: 1in;

content/guides/jam-timer.md

@@ -1,6 +1,6 @@
 ---
 title: "Jam Timer"
-date: "2024-08-28"
+date: "2024-09-23"
 template: "guide.html"
 extra:
     author: "David Reed / Stacktrace"
@@ -223,6 +223,8 @@ In all of these situations, whistle an Official Time Out instead of starting the
 
 Keep in mind that whistling an official time out instead of starting the jam often results in skater confusion, and some may begin skating in derby direction. Ensure that you're not in a position to be struck.
 
+Sometimes the jam is started incorrectly when it _should_ have gone into an Official Time Out. See [Officiating Procedures 6.1.1](https://resources.wftda.org/officiating/standards-and-procedures/), which specifies that a jam started in error should be allowed to conclude naturally in a situation where a queued skater is not lined up, before transitioning into an Official Time Out to issue the penalty. The jam started in error _must_ be whistled dead if an injured skater returns to play too early.
+
 #### Are the medics present and attending to the game?
 
 At least one medic must be available to treat skaters and attending to the track at all times, per the WFTDA Risk Management Guidelines (section 5.2). It's fine if one medic is tending to an injured skater provided that the other medic is in position and attending.

content/guides/penalty-box-manager.md

@@ -51,7 +51,7 @@ Blockers and pivots should be seated on the two outer seats of each team's box,
 
 Visual cues used to direct skaters are not standardized. Most Penalty Box Managers use one arm to signal each side of the box (i.e., the skaters from one team). The arm is raised to draw the skater's attention and then lowered to point to the desired seat, repeatedly. 
 
-If the seated skater is a jammer, the Penalty Box Manager is responsible for timing their penalty.However, the Penalty Box Timer for the relevant team actually records the penalty on their paperwork. For instruction on how to perform penalty timing, reference WFTDA Online Learning's [Intro to Penalty Box Training for Officials](https://learning.wftda.org/courses/intro-to-penalty-box-training-for-officials). This guide does not cover these core procedures in deference to this resource.
+If the seated skater is a jammer, the Penalty Box Manager is responsible for timing their penalty. However, the Penalty Box Timer for the relevant team actually records the penalty on their paperwork. For instruction on how to perform penalty timing, reference WFTDA Online Learning's [Intro to Penalty Box Training for Officials](https://learning.wftda.org/courses/intro-to-penalty-box-training-for-officials). This guide does not cover these core procedures in deference to this resource.
 
 An example series of events in the penalty box might look like this:
 
@@ -213,17 +213,15 @@ If a skater in the box is bleeding, vomiting, or in a state where they cannot sa
 
 The Penalty Box Manager is empowered to assess relevant penalties unless forbidden by the Head Referee. Typically, the Penalty Box Manager will assess penalties related to entry and exit of the penalty box and to skater conduct within the penalty box.
 
-Leaving the penalty box early is an Illegal Procedure.
+- Leaving the penalty box early is an Illegal Procedure.
 
-Removing gear other than the mouthguard while seated is an Illegal Procedure - Equipment Violation ([Rules 4.4](https://rules.wftda.com/04_penalties.html#enforcing-penalties)).
+- Removing gear other than the mouthguard while seated is an Illegal Procedure - Equipment Violation ([Rules 4.4](https://rules.wftda.com/04_penalties.html#enforcing-penalties)).
 
-Anyone other than a penalized skater (such as a coach or teammate) entering the box is an Illegal Procedure. (Rules [2.1](https://rules.wftda.com/02_gameplay.html#the-track) and [4.4](https://rules.wftda.com/04_penalties.html#enforcing-penalties)). Note that putting a foot or skate into the box, or reaching into the box to hand an item to a penalized skater, does not count as entering the box. See [Casebook C4.2.4.F](https://rules.wftda.com/casebook/04_c_penalties.html#other-illegal-procedures).
+- Anyone other than a penalized skater (such as a coach or teammate) entering the box is an Illegal Procedure. (Rules [2.1](https://rules.wftda.com/02_gameplay.html#the-track) and [4.4](https://rules.wftda.com/04_penalties.html#enforcing-penalties)). Note that putting a foot or skate into the box, or reaching into the box to hand an item to a penalized skater, does not count as entering the box. See [Casebook C4.2.4.F](https://rules.wftda.com/casebook/04_c_penalties.html#other-illegal-procedures).
 
-Profanity or abusive language may be penalizable. In a WFTDA game, profanity directed at an official or audible by the audience is a Misconduct. See [Casebook C4.3.F](https://rules.wftda.com/casebook/04_c_penalties.html#penalties-for-unsporting-conduct-misconduct). 
+- Profanity or abusive language may be penalizable. In a WFTDA game, profanity directed at an official or audible by the audience is a Misconduct. See [Casebook C4.3.F](https://rules.wftda.com/casebook/04_c_penalties.html#penalties-for-unsporting-conduct-misconduct). 
 
-JRDA conduct rules are considerably stricter than WFTDA. Review [JRDA Rules](https://www.juniorrollerderby.org/rules) section J4.3.1-2 for a description of conduct violations you might observe.
-
-All profanity merits a Misconduct penalty in JRDA games, even if non-directed. See [JRDA Casebook JC4.3.1.B](https://www.juniorrollerderby.org/rules) and [JRDA Code of Conduct 5.8](https://www.juniorrollerderby.org/rules).
+  JRDA conduct rules are considerably stricter than WFTDA. Review [JRDA Rules](https://www.juniorrollerderby.org/rules) section J4.3.1-2 for a description of conduct violations you might observe. All profanity merits a Misconduct penalty in JRDA games, even if non-directed. See [JRDA Casebook JC4.3.1.B](https://www.juniorrollerderby.org/rules) and [JRDA Code of Conduct 5.8](https://www.juniorrollerderby.org/rules).
 
 When you assess a penalty, write the skater's number and the penalty code on the appropriate side of your whiteboard. Circle the penalty code to indicate that you are assessing the penalty. Hold your whiteboard up until acknowledged by the Penalty Lineup Tracker.