Abstract Processor (for Pandoc)

ABP is a Pandoc filter that works on internal Pandoc’s AST.

It provides several interesting features:

• variable expansion (minimalistic templating)
• conditional blocks
• file inclusion (e.g. for source code examples)
• script execution (e.g. to include the result of a command)
• diagrams (Graphviz, PlantUML, Asymptote, blockdiag, mermaid…)
• CSV tables

Warning: ABP may not be supported in the future

Their is no plan to support ABP from now on. ABP is meant to be replaced by a combination of:

• UPP: Lua-scriptable Universal PreProcessor
• Panda: Pandoc add-ons (Lua filters for Pandoc)

Upp and Panda are written in Lua and are way easier to deploy.

Installation

Prerequisites

• Stack
• Pandoc

Installation from source

$ git clone https://github.com/CDSoft/abp.git
$ cd abp
$ stack install         # install abp in ~/.local/bin
$ stack install pandoc  # if you need to install pandoc

Test

$ stack test

Usage

$ pandoc -F abp ...

Documentation

The full documentation is in doc/adp.md. The rendered version of the documentation is here: http://cdelord.fr/abp.

License

This file is part of ABP.

ABP is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

ABP is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with ABP.  If not, see <https://www.gnu.org/licenses/>.

For further information about ABP you can visit
http://cdelord.fr/abp