pandoc-stylefrommeta: Pandoc filter to customize links, images and paragraphs

[ bsd3, program, text ] [ Propose Tags ]

Pandoc filter to customize links, images and paragraphs (with restrictions). Styles are read from the metadata of the document: they may reside inside the document or in a separate YAML file. See details here.


[Skip to Readme]
Versions [faq] 0.1.0.0, 0.1.0.1, 0.1.1.0, 0.2.0.0, 0.2.0.1, 0.2.0.2, 0.2.1.0, 0.2.1.1, 0.2.2.0, 0.2.3.0
Change log Changelog.md
Dependencies base (>=4.7 && <5), containers (>=0.2), HaTeX (>=3.3), MissingH (>=1.0.0), pandoc (>=1.12), pandoc-types (>=1.12) [details]
License BSD-3-Clause
Copyright 2016-2017 Alexey Radkov
Author Alexey Radkov <alexey.radkov@gmail.com>
Maintainer Alexey Radkov <alexey.radkov@gmail.com>
Category Text
Home page http://github.com/lyokha/styleFromMeta
Uploaded by lyokha at 2017-10-30T15:18:27Z
Distributions NixOS:0.2.3.0
Executables styleFromMeta
Downloads 4394 total (14 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
Last success reported on 2017-10-30 [all 3 reports]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for pandoc-stylefrommeta-0.1.1.0

[back to package description]

styleFromMeta

Pandoc filter to apply styles found in the metadata of the document for various objects.

Styling is supported for following types of objects:

  • Standalone images
  • Inline images
  • Links
  • Paragraphs (with restrictions, see below)

Styles are read from the metadata of the document: they may reside inside the document or in a separate YAML file. For example

    ---
    img_style :
      html : |
        <div style="clear: both; text-align: center; margin-bottom: 16px">
        <a href="$SRC$" style="margin-left: 10em;" alt="$ALT$">
        <img border="0" src="$SRC$" /></a></div>
      latex : |
        \begin{center}
        \includegraphics{$SRC$}
        \end{center}
    link_style :
      html : |
        <a href="$SRC$" style="margin-left: 1em; margin-right: 1em;">$ALT$</a>
      latex : |
        \href{$SRC$}{\colorbox{green}{$ALT$}}
    para_style :
      html : |
        <span style="display: block; margin-bottom: 16px;"></span>
    ...

declares styles img_style, link_style and para_style. Their names (except for the last) are arbitrarily chosen and may be referred from the document, for example

    ![$img_style$](../images/an_image.png)
    [$link_style$ *here*](http://example.com/)

Placeholders $ALT$, $SRC$ and $TITLE$ from style declarations are to be replaced by concrete data found in the object declaration. In the last example *here* corresponds to $ALT$, and http://example.com/ corresponds to $SRC$.

As soon as paragraphs do not have place where to put extra data, style para_style is applied to all paragraphs in the document. Currently only transformation to a span block is supported. Any contents found between opening and closing span tags are ignored: actual paragraph contents will be inserted inside them.