Citations and Q markup

Support for the citation block

=begin rakudoc

Prerequisites

Currently the citations support is provided using the `citeproc` and `pandoc` utilities, qudos to John MacFarlane, which are written in Haskell.

Some of the alternative citation block formats are supported by converting other xml formats to the one used by pandoc.

Consequently, these need to be installed. Assuming an Ubuntu OS.

  • pandoc

sudo apt install pandoc
  • cabal, which creates the citeproc utility

sudo apt install cabal-install
    cabal user-config init
    cabal --version
    ghc --version
    cabal update
  • citeproc, download repo, compile, then place in path

git clone https://github.com/jgm/citeproc.git citeproc
    cd citeproc
    cabal build -fexecutable
    sudo ln -sr dist-newstyle/build/x86_64-linux/ghc-*/citeproc-*/x/citeproc/build/citeproc/citeproc /usr/local/bin/citeproc
  • citeproc styles, download to a standard directory

sudo mkdir /usr/share/csl
    sudo git clone https://github.com/citation-style-language/styles.git /usr/share/csl
  • bibutils, needed to convert some bibliographic formats

mkdir bibutils
    cd bibutils
    wget https://sourceforge.net/projects/bibutils/files/latest/download -O bibutils.tgz
    tar -xzf bibutils.tgz && rm bibutils.tgz
    cd bibutils_*
    sh -f configure
    sudo make install 

=end rakudoc

Rakuast::RakuDoc::Render v1.1.5

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

Authors

  • Richard Hainsworth
  • Tim Nelson

License

Artistic-2.0

Dependencies

Test::Deeply::RelaxedPrettyDumpTest::OutputLibCurlURIDigest::SHA1::NativeText::MiscUtilsMethod::ProtectedTest::RunRakuAST::Deparse::HighlightRainbow:ver<0.3.0+>File::Directory::TreeJSON::FastJSON::TinyYAMLishXMLMIME::Base64Version::RakuLicense::SPDX

Test Dependencies

Provides

  • RakuDoc-Plugin-Test
  • 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 a trademark of the Yet Another Society. All rights reserved.

Built with Podlite — the markup and publishing tools behind this site.