sample-input-file

We have now explored Q<rakudoc-evo-chapter> at some length whether it would be better to use JSON or XML Q< JSONvsXMLmeta > to specify citation data or whether it might be better to design a bespoke DSL Q«10.1109/MODELS50736.2021.00031» instead.

If we cite Q<AbsentFriends> but don't provide the reference, it should still be okay Q<RD-citations_missing>.

The design of Raku commenced Q<Apocalypse1; P6&Parrot; ConwayKeynote2010> in late 2000...

=citation { id => 'Apocalypse1', type => "article-journal", title => "Apocalypse 1", author => { family => "Wall", given => "Larry" }, issued => { 'date-parts' => [[2001, 4, 2]] }, publisher => "Perl.com", URL => "https://www.perl.com/pub/2001/04/02/apocalypse1.html/", note => "Initial design document for Perl 6 based on RFCs." }, { id => 'P6&Parrot', type => "book", title => "Perl 6 and Parrot Essentials", author => [ { family => "Randal", given => "Allison" }, { family => "Sugalski", given => "Dan" }, { family => "Tötsch", given => "Leopold" } ], edition => "2nd", issued => { 'date-parts' => [[2004, 7]] }, publisher => "O'Reilly Media", ISBN => "978-0596007379", }, { id => 'ConwayKeynote2010', type => "speech", title => "ReDeveloping in Perl 6", author => { family => "Conway", given => "Damian" }, event => "The Perl Conference (YAPC::NA 2010)", event-place => "Columbus, Ohio, USA", issued => { 'date-parts' => [[2010, 6]] }, },

We have now explored Q<rakudoc-evo-chapter, pp. 32-47> at some length whether it would be better to use JSON or XML Q<JSONvsXMLmeta, table 8b> to specify citation data or whether it might be better to design a bespoke DSL Q<10.1109/MODELS50736.2021.00031, sect. III> instead.

=citation ({ id => "rakudoc-evo-chapter", type => "chapter", title => "The Evolution of RakuDoc: From Pod6 to Modern Documentation Standards", 'container-title' => "The Raku Renaissance: A Comprehensive Guide to the 6.e Ecosystem", author => { family => "Docsworthy", given => "Poderick" }, editor => { family => "Wally", given => "Larr" }, issued => { 'date-parts' => [[2025, 10]] }, publisher => "Camelid Press", page => "22-89", ISBN => "978-1-2345-6789-0", })

=citation { type => "paper-conference", title => "Model-Driven Development of Documentation: The Case of RakuDoc", author => [ { family => "GarcĂ­a-DomĂ­nguez", given => "Antonio" }, { family => "Worthington", given => "Jonathan" } ], 'container-title' => "2021 International Conference on Model Driven Engineering Languages and Systems (MODELS)", issued => { 'date-parts' => [[2021, 10]] }, publisher => "IEEE", DOI => "10.1109/MODELS50736.2021.00031", page => "233-243", note => "A pivotal paper describing the formal grammar and model-driven approach to RakuDoc." }

The design of Raku commenced Q<Apocalypse1; P6&Parrot, ch. 1; ConwayKeynote2010, ts=00:03:27> in late 2000...

=for citation :load< file:citations.json >

=for citation :load< https://gist.githubusercontent.com/larsgw/e5e7e7a5552df67d4dab4bd9378e5412/raw/82183d15daefe1d1c1d2999f261423e72193bf5c/csl-data.json >

Most programming languages use everyday words for their keywords, but some have taken that notion much further, basing their entire syntax on (subsets) of natural languages Q<Perligata> or on conlangs Q<tlhInganHol::yIghun>.

=begin citation :category<CSL> [ { "id": "tlhInganHol::yIghun", "type": "software", "title": "Lingua::tlhInganHol::yIghun: Perl code in the original Klingon", "author": { "family": "Conway", "given": "Damian" }, "issued": { "date-parts": [[2009, 6, 1 ]] }, "abstract": "Perl module that allows programs to written Klingon syntax and vocabulary.", "publisher": "MetaCPAN", "version": "20090601", "URL": "https://metacpan.org/pod/Lingua::tlhInganHol::yIghun", "accessed": { "date-parts": [[2025, 1, 25 ]] } }, { "id": "Perligata", "type": "paper-conference", "title": "Lingua::Romana::Perligata -- Perl for the XXI-imum Century", "author": { "family": "Conway", "given": "Damian" }, "event-title": "Proceedings of the Perl Conference 4.0", "event-place": "Monterey, CA, USA", "publisher": "O'Reilly and Associates", "publisher-place": "CA, USA", "issued": { "date-parts": [[2000, 7]] }, "page": "1-15", "ISBN": "0-596-00013-8" } ] =end citation

Cited References =place citation:cited

Further Reading =place citation:uncited

=for citation :category<SyntaxResearch>

=for citation :category<OtherImpls>

=for citation :category<SyntaxResearch Semantics>

=for citation :category<Semantics>

Categorized Bibliography

=numhead2 JSON-related references =place citation:JSON

=numhead2 CSL-related references =place citation:CSL

=numhead2 Raku or TeX =place citation:Raku,TeX

Full Bibliography

=place citation:*

Rakuast::RakuDoc::Render v1.0.14

Renders RakuDoc v2 to text, HTML, HTML-Extra, Markdown

Authors

  • Richard Hainsworth

License

Artistic-2.0

Dependencies

Test::Deeply::RelaxedPrettyDumpTest::OutputLibCurlURIDigest::SHA1::NativeText::MiscUtilsMethod::ProtectedTest::RunRakuAST::Deparse::HighlightRainbow:ver<0.3.0+>File::Directory::TreeJSON::FastYAMLishXML

Test Dependencies

Provides

  • RakuDoc::Citations
  • RakuDoc::MarkupMeta
  • RakuDoc::Numeration
  • RakuDoc::Plugin::HTML::Bulma
  • RakuDoc::Plugin::HTML::FontAwesome
  • RakuDoc::Plugin::HTML::Graphviz
  • RakuDoc::Plugin::HTML::Hilite
  • RakuDoc::Plugin::HTML::Latex
  • RakuDoc::Plugin::HTML::LeafletMaps
  • RakuDoc::Plugin::HTML::ListFiles
  • RakuDoc::Plugin::HTML::SCSS
  • RakuDoc::Plugin::Markdown::Graphviz
  • RakuDoc::Processed
  • RakuDoc::PromiseStrings
  • RakuDoc::Render
  • RakuDoc::ScopedData
  • RakuDoc::Templates
  • RakuDoc::To::Generic
  • RakuDoc::To::HTML
  • RakuDoc::To::HTML-Extra
  • RakuDoc::To::Markdown
  • RenderDocs

The Camelia image is copyright 2009 by Larry Wall. "Raku" is trademark of the Yet Another Society. All rights reserved.