Comments (8)
Your question is, where is bibliography building handled in RFC. The answer is that they are indeed handled in ref_section(); but asciidoctor-rfc already has functionality to query the RFC bibliographic database and add references from there: common/base.rb, cache_biblio() and insert_biblio(). No functionality needs to be added to asciidoctor-rfc.
Hypothetically, we could add isobib functionality to asciidoctor-rfc; that would necessitate translating Relaton XML to RFC XML. In practice, let's not do that unless Ronald asks for it; it will make things messier, and RFC documents don't cite outside of the IETF often enough for it to add much value.
from asciidoctor-rfc.
We should actually extract rfcbib from asciidoctor-rfc and move it to a common framework that combines IsoBib, gbbib and rfcbib.
from asciidoctor-rfc.
The two bibliographies of ISO and rfc are fetched completely differently, and serialised completely differently. If we keep the two separate, conflating some in the one gem is not useful. if we attempt to merge them, but somehow mapping rfc bibliographies that are already in the correct format into Relaton XML and back, it is even less useful.
from asciidoctor-rfc.
They are fetched differently but the fetched reference should be stored in ISODOC in the exact same format (i.e. Relaton XML). So it is useful to generalize this framework:
Fetch RFC/ISO/GB/IEC/IEV ---> Relaton model ---> Insert into ISODOC ---> Render into WhateverFormat
from asciidoctor-rfc.
@ronaldtse I finished RfcBib gem. If we shouldn't integrate it into asciidoctor-rfc, when what is next step?
from asciidoctor-rfc.
It is intended for integration into asciidoctor-iso and asciidoctor-gb. I will assign myself tickets to do so.
from asciidoctor-rfc.
The other part is to refactor asciidoctor-rfc into the same structure as asciidoctor-iso and asciidoctor-gb, but it's separate from this ticket.
from asciidoctor-rfc.
(https://github.com/riboseinc/asciidoctor-rfc/issues/105)
from asciidoctor-rfc.
Related Issues (20)
- 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
- Extract references as entities HOT 7
- 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.