Add initial metadata registry

_data/metadata_registry.yml

@@ -0,0 +1,40 @@
+# User Metadata
+- name: User Metadata
+  values:
+    - key: avatar
+      description: Avatar that graphical clients can show alongside the user's name
+      format: URL with an optional `{size}` substitution denoting the size to load in pixels
+      examples: https://example.com/avatar/16/asdf.jpg
+    - key: bot
+      description: >-
+        Lets bot runners provide the name of their bot software. Setting this key
+        identifies the client as a bot.
+      format: Any string
+      examples: |-
+        PacketBot v1.2
+        JitiBot
+        melo3
+    - key: display-name
+      description: >-
+        Alternative name to use instead of a nick for display purposes. Useful for gateways
+        to chat services that allow spaces and other characters in nicks. A nick is
+        required for standard protocol level stuff but can be less prominent in the UI.
+        May contain emoji.
+      format: Any string
+      examples: |-
+        James Wheare
+        Posiden
+        ダニエル
+        Борис
+    - key: homepage
+      description: >-
+        URL of a webpage that contains more information about the user/bot themselves,
+        or bot software in use.
+      format: Valid URL
+      examples: |-
+        https://example.com/bot-info.html
+    - key: status
+      description: Status text that can be shown for users without making them 'away'
+      format: Any string
+      examples: |-
+        Working from home

_data/validation/metadata_registry.meta.yaml

@@ -0,0 +1,19 @@
+root:
+  type: listofdicts
+  kids:
+    name:
+      type: string
+    values:
+      type: listofdicts
+      kids:
+        key:
+          type: string
+        format:
+          type: string
+        description:
+          type: string
+        examples:
+          type: string
+        specs:
+          type: listofstrings
+          required: false

css/style.sass

@@ -278,6 +278,9 @@ table
         margin-top: 0
     &:last-child
         margin-top: 0
+    code.examples
+        margin-top: 0.4em
+        display: block
 th
     font-weight: 500
     text-align: left

registry.md

@@ -8,10 +8,13 @@ page-header: >
 
 This page lists the tags, capabilities, commands, batches and metadata keys that have been defined by the IRCv3 Working Group, are described by our specifications, or that we otherwise recommend using.
 
-<div class="irc-sw-list flexy-list">
+<div class="irc-sw-list flexy-list" style="max-width: 60rem;">
 {% for type in site.data.registry %}
 <a href="#{{ type.name | slugify }}">{{ type.name }}</a>
 {% endfor %}
+{% for type in site.data.metadata_registry %}
+<a href="#{{ type.name | slugify }}">{{ type.name }}</a>
+{% endfor %}
 {% for type in site.data.standard_replies_registry %}
 <a href="#{{ type.name | slugify }}">{{ type.name }}</a>
 {% endfor %}
@@ -56,6 +59,43 @@ This page lists the tags, capabilities, commands, batches and metadata keys that
 </table>
 {% endfor %}
 
+{% for type in site.data.metadata_registry %}
+<h2 id="{{ type.name | slugify }}">{{ type.name }}</h2>
+<table class="fullwidth">
+  <thead>
+    <tr>
+      <th style="text-align: center">Key</th>
+      <th>Format</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    {% for val in type.values %}
+    <tr>
+      <td style="min-width: 5rem; white-space: nowrap">
+        <code>{{ val.key }}</code>
+      </td>
+      <td style="min-width: 10rem">
+        {% if val.format-mono %}<code>{{ val.format }}</code>{% else %}{{ val.format | markdownify | replace:"<p>","" | replace:"</p>","" }}{% endif %}
+        <br>
+        {% if val.examples %}
+        <code class="examples">{{ val.examples | newline_to_br }}</code>
+        {% endif %}
+      </td>
+      <td>
+        {{ val.description | markdownify | replace:"<p>","" | replace:"</p>","" }}
+        {% assign i = 1 %}
+        {% for link in val.links %}
+          <sup><a href="{{ site.baseurl }}{{ link }}">({{i}})</a></sup>
+          {% assign i = i | plus: 1 %}
+        {% endfor %}
+      </td>
+    </tr>
+    {% endfor %}
+  </tbody>
+</table>
+{% endfor %}
+
 {% for type in site.data.standard_replies_registry %}
 <h2 id="{{ type.name | slugify }}">{{ type.name }}</h2>
 <table class="fullwidth">