Comments (7)
I think we should allow RFC entity directives just like MMark does so that we donโt need to pull in the RFC references, but allow xml2rfc to do it.
I have already been downloading RFC references from this site and itโs really annoying.
from asciidoctor-bibliography.
This would mean that, whenever a preformatted reference was known to be available, the gem would need to insert not the preformatted reference in the biblio, but the following:
In the stylesheet of the XML document:
<!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml">
and in the bibliography itself:
&RFC2119;
The asciidoctor-rfc would presumably have to have the smarts of rearranging the XML, recognising the entities in the bibliography, and inserting the corresponding entity definitions into the XML stylesheet. (The different locations of the URLs should be inferrable from the anchor text prefix.) Paolo, ascii-bibliography would still need to realise that the entity &RFC2119;
corresponds to a citation with anchor RFC2119
.
from asciidoctor-bibliography.
When asciidoctor-rfc
sees a references like <<RFC1234>>
or <<I-D.author-topic-num>>
(or we give it some prefix, e.g., <<ietf:RFC1234>>
, then this reference should be inferred to be an external one, and:
- Rendered in the XML stylesheet as
<!ENTITY...>
- Rendered inside the
<references>
section - Known by
asciidoctor-bibliography
that the reference is external.
@opoudjis It's hard to wrap this around my head right now... ๐
from asciidoctor-bibliography.
I can do all of this in isolation from asciidoc-bibliography; it's the interaction with asciidoc-bibliography that I'm worried about.
from asciidoctor-bibliography.
Done in asciidoc-rfc.
from asciidoctor-bibliography.
I think I might be missing some points. I'll get back to speed with the changes asciidoctor-rfc
and report back with some questions.
from asciidoctor-bibliography.
metanorma/asciidoctor-rfc#86 . In accordance with that ticket, the scope of asciidoctor-biblio would be reduced to BibXML/RFC XML conversion...
from asciidoctor-bibliography.
Related Issues (20)
- Multi-Citation of more than two keys not working HOT 5
- [enhancement] nocite macro for bibliography entry without expicit citation HOT 1
- Incompatibility with asciidoctor version >= 2.0 HOT 3
- Bug with custom attributes when translating to DocBook HOT 3
- Question: own styles HOT 1
- :bibliography-database: not set via asciidoctor-epub3 for included documents HOT 6
- Bib entry with identical author and year HOT 18
- Minor APA format issue HOT 4
- Converting directly with Ruby HOT 2
- Variable interpolation breaks include
- anomalies when using Asciidoctor's ifeval::[] and asciidoctor-bibliography HOT 3
- Errors with asciidoctor-pdf HOT 2
- Numbered bibliography
- Comparison with asciidoc-bib and asciidoctor-bibtex
- A problem building Nokogiri, when installing on Windows HOT 7
- Migrate to GitHub Actions from Travis
- Change default branch to main HOT 1
- Asciidoc-bibliography messes with section levels after include
- Feature request: Styling per bibliography
- Target on cite or bibliography not working (getting all refs)
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-bibliography.