Structure the 'Areas and teams' page with tables, derived from the website "Teams" page tables.

Author: Ivorforce

_extensions/area_table.py

@@ -0,0 +1,92 @@
+"""
+A directive for organization/areas.rst to render the area tables.
+"""
+
+from docutils import nodes
+from docutils.parsers.rst import Directive
+import re
+
+area_table_rows = ["Communication", "GitHub reviews", "GitHub labels", "Triage project"]
+
+channel_re = re.compile(r'#([\w-]+)')
+godot_team_re = re.compile(r'@godotengine/([\w-]+)')
+labels_re = re.compile(r'<gh-label>(.+?)</gh-label>')
+triage_re = re.compile(r'<gh-triage project=(\d+)>(.*?)</gh-triage>')
+
+
+def transform_channels(match: re.Match):
+    old_value = match.group(1)
+    transformed = f'<a href="https://chat.godotengine.org/channel/{old_value}">#{old_value}</a>'
+    return transformed
+
+
+def transform_github_teams(match: re.Match):
+    old_value = match.group(1)
+    transformed = f'<a href="https://github.com/godotengine/godot/pulls?q=is%3Apr+is%3Aopen+team-review-requested%3Agodotengine%2F{old_value}">@godotengine/{old_value}</a>'
+    return transformed
+
+
+def transform_github_labels(match: re.Match):
+    old_value = match.group(1)
+    transformed = f'<code class="docutils literal notranslate"><span class="pre">{old_value}</span></code> (<a href="https://github.com/godotengine/godot/issues?q=is%3Aissue%20state%3Aopen%20label%3A{old_value}">issues</a>, <a href="https://github.com/godotengine/godot/pulls?q=is%3Apr+is%3Aopen+label%3A{old_value}">PRs</a>)'
+    return transformed
+
+
+def transform_github_triage(match: re.Match):
+    number = match.group(1)
+    name = match.group(2)
+    transformed = f'<a href="https://github.com/orgs/godotengine/projects/{number}">{name}</a>'
+    return transformed
+
+
+class TableDirective(Directive):
+    has_content = False
+    required_arguments = 0
+    optional_arguments = 0
+    final_argument_whitespace = False
+    option_spec = {column.lower().replace(" ", "_"): str for column in area_table_rows}
+
+    def run(self):
+        # Create a table node with the parsed header and data
+        table = nodes.table()
+        table.setdefault('classes', []).append("gdarea-table")
+        tgroup = nodes.tgroup(cols=2)
+        table += tgroup
+
+        # Set column specifications
+        tgroup += nodes.colspec(colwidth=2)
+        tgroup += nodes.colspec(colwidth=5)
+
+        # Create and add the table body
+        tbody = nodes.tbody()
+        tgroup += tbody
+        for column_title in area_table_rows:
+            row_text = self.options.get(column_title.lower().replace(" ", "_"), '')
+            if not row_text:
+                continue
+
+            body_row = nodes.row()
+
+            entry = nodes.entry()
+            entry.setdefault('classes', []).append("gdarea-table-header")
+            entry += nodes.paragraph(text=column_title)
+            body_row += entry
+
+            row_text = channel_re.sub(transform_channels, row_text)
+            row_text = godot_team_re.sub(transform_github_teams, row_text)
+            row_text = labels_re.sub(transform_github_labels, row_text)
+            row_text = triage_re.sub(transform_github_triage, row_text)
+
+            entry = nodes.entry()
+            paragraph = nodes.paragraph()
+            paragraph += nodes.raw('', row_text, format='html')
+            entry += paragraph
+            body_row += entry
+
+            tbody += body_row
+
+        return [table]
+
+
+def setup(app):
+    app.add_directive('gdareatable', TableDirective)

_static/css/custom.css

@@ -1865,3 +1865,38 @@ p + .classref-constant {
     border: 0px solid #7fbbe3;
     background: var(--role-button-background-color);
 }
+
+.rst-content table.docutils.gdarea-table {
+    background-color: var(--code-background-color);
+    border: 0;
+    border-left: 6px solid var(--code-border-color);
+    padding: 4px 10px;
+    width: 100%;
+    table-layout:fixed
+}
+
+.rst-content table.docutils.gdarea-table td.gdarea-table-header {
+    padding: 8px;
+    border-right:1px dashed var(--code-border-color);
+    text-align: left;
+    width:25%;
+}
+
+.rst-content table.docutils.gdarea-table td {
+    padding: 8px 0 8px 12px;
+    background-color: var(--code-background-color) !important;
+}
+
+.rst-content table.docutils.gdarea-table td.gdarea-table-header, .rst-content table.docutils.gdarea-table td {
+    border-bottom: 1px dashed var(--code-border-color);
+    border-collapse:collapse
+}
+
+.rst-content table.docutils.gdarea-table tr:last-of-type td, .rst-content table.docutils.gdarea-table tr:last-of-type td.gdarea-table-header {
+    border-bottom:0
+}
+
+.rst-content table.docutils.gdarea-table td.gdarea-table-header > p {
+    font-size: 1rem !important;
+    font-weight: bold;
+}

conf.py

@@ -11,12 +11,17 @@
 
 # -- General configuration
 
+import sys
+import os
+sys.path.insert(0, os.path.abspath('./_extensions'))
+
 extensions = [
     "sphinx_tabs.tabs",
     "notfound.extension",
     "sphinxext.opengraph",
     "sphinx_copybutton",
     "sphinxcontrib.video",
+    "area_table",
 ]
 
 intersphinx_mapping = {