Change the approach to IETF builds to support for md I-Ds

.github/workflows/ci.yml

@@ -19,17 +19,9 @@ jobs:
   specs-ietf:
     runs-on: ubuntu-latest
     steps:
+      - name: Install docker-compose
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y docker-compose
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-      - run: pip install --requirement requirements.txt
-      - run: xml2rfc --version
-      - run: make all
-      - uses: actions/upload-artifact@v4
-        with:
-          name: specification-docs
-          path: |
-              *.html
-              *.txt
-              !requirements.txt
+      - run: npm run build-ietf

.gitignore

@@ -2,17 +2,7 @@
 web/
 
 # IETF builds
-json-schema-use-cases.html
-json-schema-use-cases.pdf
-json-schema-use-cases.txt
-relative-json-pointer.html
-relative-json-pointer.pdf
-relative-json-pointer.txt
-
-# For the Python enviornment
-.venv
+.refcache/
 
 # For the node-based build tools
 node_modules/
-
-.env

Dockerfile

@@ -0,0 +1,14 @@
+FROM fedora
+
+RUN dnf install -y ruby python3-pip
+RUN gem install kramdown-rfc
+RUN pip install xml2rfc
+
+WORKDIR /app
+
+COPY . .
+
+# First covert md to xml. Then convert xml to html
+CMD sh -c "xml2rfc --version \
+        && ls ietf/*.md | xargs -n1 sh -c 'kramdown-rfc \"\$0\" > \"\${0%.md}.xml\"' \
+        && ls ietf/*.xml | xargs -n1 sh -c 'xml2rfc --html \"\$0\" -p web'"

README.md

@@ -113,17 +113,7 @@ features they make available to you.
 ### Internet-Drafts
 
 To build components that are being maintained as IETF Internet-Drafts, run
-`make`. The Makefile will create the necessary Python venv for you as part of
-the regular make target.
-
-`make clean` will remove all output including the venv. To clean just the spec
-output and keep the venv, use `make spec-clean`.
-
-If you want to run `xml2rfc` manually after running make for the first time, you
-will need to activate the virtual environment: `source .venv/bin/activate`.
-
-The version of "xml2rfc" that this project uses is updated by modifying
-`requirements.in` and running `pip-compile requirements.in`.
+`npm run build-ietf`.
 
 Descriptions of the xml2rfc, I-D documents, and RFC processes:
 

docker-compose.yml

@@ -0,0 +1,7 @@
+services:
+  build:
+    build:
+      context: .
+    working_dir: /app
+    volumes:
+      - .:/app:Z

ietf/.remarkrc.js

@@ -0,0 +1,12 @@
+import lintPreset from "../.remarkrc-lint.js";
+import remarkLintNoMultipleToplevelHeadings from "remark-lint-no-multiple-toplevel-headings";
+import remarkLintFencedCodeMarker from "remark-lint-fenced-code-marker";
+
+
+export default {
+  plugins: [
+    lintPreset,
+    [remarkLintNoMultipleToplevelHeadings, false],
+    [remarkLintFencedCodeMarker, "~"]
+  ]
+};

ietf/example.md

@@ -0,0 +1,32 @@
+---
+
+stand_alone: true
+ipr: trust200902
+submissiontype: independent
+category: info
+
+author:
+- name: Jason Desrosiers
+  email: [email protected]
+  role: editor
+
+title: Example
+
+--- abstract
+
+An example of an I-D in markdown
+
+--- middle
+
+# Introduction
+
+## Notational Conventions
+
+{::boilerplate bcp14+}
+
+# Security Considerations
+
+TODO: Required section
+
+--- back
+

package.json

@@ -6,7 +6,8 @@
   "main": "index.js",
   "scripts": {
     "lint": "eslint . ; remark --no-stdout --frail .",
-    "build": "remark --rc-path specs/.remarkrc-build.js --output web/"
+    "build": "remark --rc-path specs/.remarkrc-build.js --output web/",
+    "build-ietf": "docker-compose run --rm build"
   },
   "license": "MIT",
   "devDependencies": {

remark/rehype-link-transformer.js

@@ -1,14 +1,15 @@
-import { existsSync } from "fs";
+import { existsSync } from "node:fs";
+import { basename } from "node:path";
+import url from "node:url";
 import { visit } from "unist-util-visit";
-import url from "url";
 
 
 const rehypeLinkTransformer = () => (tree, vfile) => {
   visit(tree, "element", (node) => {
     if (node.tagName === "a") {
       const href = url.parse(node.properties.href);
       if (href.hostname === null && href.pathname?.endsWith(".md") && existsSync(vfile.history[0])) {
-        href.pathname = href.pathname.replace(/.md$/, ".html");
+        href.pathname = basename(href.pathname).replace(/.md$/, ".html");
         node.properties.href = url.format(href);
       }
     }