Comments (8)
I don't think the MMark math blocks are rendered specially, they seem to be just passed through as centered code blocks. We just need a nice way of representing them.
from asciidoctor-rfc.
For now I guess it would make most sense if we just <em>
the math blocks. I don't think XMLRFC will support Math anytime soon. We should apply the same formatting for inline math as well as block math syntax.
from asciidoctor-rfc.
OK; just be aware that <em>
will end up italicising numbers as well as letters in the Math markup, which is not strictly speaking correct. (But partially italicising numbers and not letters is even worse.)
from asciidoctor-rfc.
Ah ha, got it. Let's do it your way @opoudjis
from asciidoctor-rfc.
... What was my way? :-) I think it's leaving them alone. It does look ugly, admittedly.
The real way of doing these is to embed them in an appropriate external schema, which a downstream processor can pay attention to or ignore. But whether that makes any sense to do at all is a matter of what IETF have in place!
The native ASCIIdoc way of doing things looks like it's ASCIIMathML (http://www1.chapman.edu/~jipsen/mathml/asciimathsyntax.html), which a processor converts to MathML—and we could do the same, but only if that's going to be useful downstream.
@ronaldtse, at the moment I'm leaving these alone then, but let me know if there would be any appetite over at IETF for dealing with MathML.
from asciidoctor-rfc.
Since the RFC XML schema doesn't specify specific support for Math, we probably shouldn't mess with that right now.
But it might be a good idea to have that option later to convert math to MathML output within XML (https://github.com/asciidoctor/asciidoctor-mathematical)
from asciidoctor-rfc.
This issue does not need to be acted on in a hurry, since IETF does not say anything about Mathematical formatting yet; but I am already converting AsciiML to MathML for the asciidoctor-iso gem.
from asciidoctor-rfc.
Closing this for now, since no indication that IETF can deal with math formatting; if they ask for this, we reactivate this (and it will be a straightforward task).
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
- 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.