3
0
Fork
You've already forked spec
0

Issues with IETF XML format #2

Closed
opened 2022年02月08日 13:55:33 +01:00 by pukkamustard · 1 comment

There are some minor issues with the IETF XML format:

  1. No explicit versioning. RFCs are in general not versioned and the format does not allow a version field. There has been a suggestion to add this (draft-claise-semver-02). Some recent RFCs just have the version in the title (e.g. RFC 7950 - The YANG 1.1 Data Modeling Language). This is what I've done for now.

  2. Expiration date. The rendering tool xml2rfc treats the specification as an Internet-Draft that has an expiration date. We don't wan't an expiration date.

  3. Copyright. The rendering tool adds the IETF standard copyright notice. Specification is however CC-BY-SA-4.0. Don't know how to fix this.

  4. Google Fonts. The rendering tool uses Google Fonts by default. I have disabled it by using a custom style.

Point 2 and 3 remain open. Don't know how to fix those without hacking the xml2rfc tool or writing our own XML->HTML tool.

There are some minor issues with the IETF XML format: 1. No explicit versioning. RFCs are in general not versioned and the format does not allow a version field. There has been a suggestion to add this ([draft-claise-semver-02](https://datatracker.ietf.org/doc/draft-claise-semver/)). Some recent RFCs just have the version in the title (e.g. [RFC 7950 - The YANG 1.1 Data Modeling Language](https://datatracker.ietf.org/doc/html/rfc7950)). This is what I've done for now. 2. Expiration date. The rendering tool xml2rfc treats the specification as an Internet-Draft that has an expiration date. We don't wan't an expiration date. 3. Copyright. The rendering tool adds the IETF standard copyright notice. Specification is however CC-BY-SA-4.0. Don't know how to fix this. 4. Google Fonts. The rendering tool uses Google Fonts by default. I have disabled it by using a custom style. Point 2 and 3 remain open. Don't know how to fix those without hacking the xml2rfc tool or writing our own XML->HTML tool.
Author
Owner
Copy link

I've started writing some custom XML->(X)HTML scripts, but it ended up being a time-drain.

For the moment we just do some manual hacking on the HTML output by xml2rfc.

I've started writing some custom XML->(X)HTML scripts, but it ended up being a time-drain. For the moment we just do some manual hacking on the HTML output by xml2rfc.
Sign in to join this conversation.
No Branch/Tag specified
main
pages
smalltall-samples
tup
ietf-rfc-xml
v1.0.0
v0.4.0
v0.3.0
v0.2.0
v0.1
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
eris/spec#2
Reference in a new issue
eris/spec
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?