Comments (7)
Done. Goes through all recognisable anchor prefixes from xml2rfc cover page (https://xml2rfc.tools.ietf.org) , apart from XSF http://www.xmpp.org/extensions/refs/ , which is offline. Recognises the "miscellaneous" set as a hardcoded array of anchors.
from asciidoctor-rfc.
Wonderful! Could I have one more request — the IEEE Bibxml library is very incomplete, so when citing IEEE (and other) documents we want to be able to override the reference with a manual BibXML ENTRY. Would this work?
Currently I have this case for IEEE and Internet-Draft (a draft that is not yet published).
Also, when we cite an Internet-Draft we should be able to also specify the revision. I think this already works.
from asciidoctor-rfc.
The next step is to snarf the contents of those directories, and only replace references whose anchors are in the published list.
The xml2rfc page claims you can cite drafts, but the links do not resolve. If we don't care, then sure, I can strip out the "draft" and the suffix number when creating the entity. Do you have an example of a document citing a particular version?
from asciidoctor-rfc.
@opoudjis I don't think we should care about the contents of those directories because xml2rfc already does this?
Latest I-D cites work if we strip out the "draft-", and per-revision ones need to have "draft-":
wget https://xml2rfc.tools.ietf.org/public/rfc/bibxml-ids/reference.I-D.draft-oscca-cfrg-sm3-00.xml
wget https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.draft-oscca-cfrg-sm3-00.xml
from asciidoctor-rfc.
But sometimes yes you need to refer to a particular draft version.
from asciidoctor-rfc.
I am now building a cache of reference anchors at ~/.asciidoc-rfc-biblio-cache.json
, and I have a document option to clear it (which can also be issued at the command line). Only references actually present in the cache will be overwritten with includes/entities.
from asciidoctor-rfc.
Draft citations now work as well. Documented in Readme.
from asciidoctor-rfc.
Related Issues (20)
- Render RFC references HOT 8
- Warn if section after appendix not marked up as appendix HOT 8
- In RFC style, backticks should be presented as double quotes HOT 7
- Tests failed on windows HOT 2
- AsciiRFC Internet-Draft bug HOT 2
- RELAXNG validation error: <eref> inside <spanx> HOT 4
- Line numbers / file path missing in WARNING messages HOT 3
- Uncertainty in allowed values of <workgroup> and <area> HOT 4
- Inconsistent behavior of `[source]` block without figure wrapper in v3/v2 HOT 3
- Build failure needs to be resolved HOT 32
- Asciidoctor-biblio workaround HOT 11
- Canonical references have dots HOT 1
- Add xml-stylesheet `rfc2629.xslt` HOT 2
- Handling IRTF Working Groups HOT 1
- Referencing the latest I-D BibXML causes resulting ENTITY to lose link HOT 2
- CR before literal/sourcecode HOT 5
- Automatic section referencing overrides explicit references HOT 8
- Test errors HOT 1
- `NOT RECOMMENDED` should be labeled as `<bcp14>`
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from asciidoctor-rfc.