neelsmith / cd2md Goto Github PK
View Code? Open in Web Editor NEWCitedown to markdown library
Citedown to markdown library
The equivalent in pure markdown is unambiguously defined: this should be implemented ahead of any decisions about how to deal with quotation of texts and objects.
citedown notation allows quotation of content identified by URNs.
It is easy to express this in markdown: just use the ![] notation to embed image content.
What does it mean to quote a text? OHCO2 says that citable text can have a mixed content model, but markdown has a simple plain text content model. The most natural meaning then is to embed the text content only of the cited passage. If you want access to the mixed content of an edition, you have to get outside of markdown's design, so you should cite it, not quote it.
What does it mean to quote a CITE object? Since a CITE object has values for a defined set of properties, this probably corresponds most readily to a list or perhaps a two-column table of property name/value pairs. Lists are completely generic markdown, but if a table was used, that would put you into the realm of extensions. Perhaps we could check if the tables extension is turned on and use that as the guide for which option to use.
Right now, cd2md allows a single CITE service for an archive.
Should there be more complex configuration options that map individual CTS URN namespaces or CITE Collections to specific services?
Or should people just work harder at implementing aggregating virtual CITE services?
(Identical question raised in citedownmgr tracker of cite-architecture)
"Quotation" references in citedown (preceded by "!" ) can be directly converted to pure markdown when an image is quoted, since markdown has a notation for embedding images. For texts and objects, there is no corresponding markdown. Options include:
Each option has plusses and minuses. We should probably offer both options.
Since Ryan's parser extends the pegdown parser with its toHtml() method, we might consider just using the pure markdown output of toMarkdown() as input to a toHtml() method expecting pure markdown.
I'm pretty sure Ryan's citedown parser leaves intact the pegdown parser's options for configuring extensions to markdown.
Important if students are going to use MMD's footnote notation.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.