Allow STD and BCP to be easily referenced

miekg · miekg · commit 5df4a776e79c · 2023-11-04T09:36:53.000+01:00
Signed-off-by: Miek Gieben &lt;miek@miek.nl&gt;
diff --git a/Syntax.md b/Syntax.md
@@ -575,11 +575,11 @@ citation to the references, but does not show up in the document as a citation.
 The first seen modifier determines the type (suppressed, normative or informative). Multiple
 citation can separated with a semicolon: `[@RFC1034;@RFC1035]`.
 
-If you reference an RFC, I-D or W3C document the reference will be added automatically (no need to
-muck about with an `<reference>` block). This is to say:
+If you reference an RFC, I-D, BCP or STD or W3C document the reference will be added automatically
+(no need to muck about with an `<reference>` block). This is to say:
 
-Any reference starting with *RFC*, *I-D.* or *W3C.* will be automatically added to the correct
-reference section.
+Any reference starting with *RFC*, *BCP*, *STD*, *I-D.* or *W3C.* will be automatically added to the
+correct reference section.
 
 For I-Ds you may want to add a draft sequence number, which can be done as such: `[@?I-D.blah#06]`.
 If you reference an I-D *without* a sequence number it will create a reference to the *last* I-D in
diff --git a/render/xml/bibliography.go b/render/xml/bibliography.go
@@ -63,11 +63,17 @@ func (r *Renderer) bibliographyItem(w io.Writer, node *mast.BibliographyItem) {
 	tag := ""
 	switch {
 	case bytes.HasPrefix(node.Anchor, []byte("RFC")):
-		tag = makeXiInclude(BibRFC, fmt.Sprintf("reference.RFC.%s.xml", node.Anchor[3:]))
+		tag = makeXiInclude(BibRFC, fmt.Sprintf("reference.RFC.%s.xml", prefixWithZero(node.Anchor[3:])))
 
 	case bytes.HasPrefix(node.Anchor, []byte("W3C.")):
 		tag = makeXiInclude(BibW3C, fmt.Sprintf("reference.W3C.%s.xml", node.Anchor[4:]))
 
+	case bytes.HasPrefix(node.Anchor, []byte("BCP")):
+		tag = makeXiInclude(BibBCP, fmt.Sprintf("reference.BCP.%s.xml", prefixWithZero(node.Anchor[3:])))
+
+	case bytes.HasPrefix(node.Anchor, []byte("STD")):
+		tag = makeXiInclude(BibSTD, fmt.Sprintf("reference.STD.%s.xml", prefixWithZero(node.Anchor[3:])))
+
 	case bytes.HasPrefix(node.Anchor, []byte("I-D.")):
 		hash := bytes.Index(node.Anchor, []byte("#"))
 		draft := ""
@@ -96,8 +102,25 @@ func makeXiInclude(url, reference string) string {
 	return fmt.Sprintf("<xi:include href=\"%s/%s\"/>", url, reference)
 }
 
+func prefixWithZero(num []byte) []byte {
+	switch len(num) {
+	case 0:
+		return num
+	case 1:
+		return append([]byte("000"), num...)
+	case 2:
+		return append([]byte("00"), num...)
+	case 3:
+		return append([]byte("00"), num...)
+	default:
+		return num
+	}
+}
+
 var (
 	BibRFC = "https://bib.ietf.org/public/rfc/bibxml"
 	BibID  = "https://bib.ietf.org/public/rfc/bibxml3"
 	BibW3C = "https://bib.ietf.org/public/rfc/bibxml4"
+	BibBCP = "https://bib.ietf.org/public/rfc/bibxml9" // reference.BCP.0014.xml
+	BibSTD = "https://bib.ietf.org/public/rfc/bibxml9" // reference.STD.0094.xml
 )
