pandoc-tcl-filter is a documentation tool to embed and evaluate Tcl, LaTeX, GraphViz (and other) code with Markdown (and other Markup documents). It works as filter for the pandoc document converter. Filters for other programming languages and command
line tools can be created as well using the Tcl code. Version 0.6.0 contains embedded in a single file application filters for the following tools:

* {.tcl} - the Tcl filter
* {.abc} - filter for ABC music notation (requires abcm2ps)
* {.cmd} (new) - shell scripts to be embedded easily (examples for Python, Octave, Gnuplot, R, C/ C++, EQN etc, required shell and the tools you like to use)
* {.dot} - filter for GraphViz tools like dot and neato (requires Graphviz)
* {.eqn} - filter for EQN equations (groff required)
* {.mmd} - filter for Mermaid diagrams (requires mermaid-cli)
* {.mtex} (extended) - filter for LaTex equations and various LaTeX packages for creating graphics (requires LaTeX installation)
* {.pik} - filter for Pikchr diagrams (requires pikchr or fossil)
* {.pic} - filter for PIC diagrams (groff required)
* {.puml} - filter for PlantUML diagrams (requires PlantUML)
* {.rplot} - filter for R plots (requires R)
* {.sqlite} - filter for SQLite3 terminal application (sqlite3 application required)
* {.tcrd} (new) - filter for typesetting musical lyrics with chords and transposing facilities (just Tcl required, no additional packages)
* {.tdot} (new) - filter for the tdot package (Tcl and GraphViz required)
* {.tsvg} - filter for the tsvg package (just Tcl required, no additional packages)

The code is tested on Linux only, it should work easily on other Unixes and as well on a Windows system with a properly installed Shell like cygwin or msys2.

The basic idea of the package is that you embed your code directly within a (for instance) Markdown document like this:

```{.tcl}
puts "Hello World!"
```

and the output and the code will be visible within your document.

Or for a GraphViz image (to just show the image but not the code in your final document):

```{.dot echo=false results="hide"}
diagraph G {
A -> B ;
}
```

To get an impression have a look for instance at the manual pages for

* filter-cmd - https://htmlpreview.github.io/?https://raw.githubusercontent.com/mittelmark/DGTcl/master/pandoc-tcl-filter/filter/filter-cmd.html
* filter-mtex - https://htmlpreview.github.io/?https://raw.githubusercontent.com/mittelmark/DGTcl/master/pandoc-tcl-filter/filter/filter-mtex.html

For more information and usage examples check the Wikipage https://wiki.tcl-lang.org/page/pandoc%2Dtcl%2Dfilter and the project page at github https://github.com/mittelmark/DGTcl

There is a single file Tcl-script build with tpack (https://wiki.tcl-lang.org/page/tpack) which can be download here: https://github.com/mittelmark/DGTcl/releases/download/latest/pandoc-tcl-filter.tapp - you should use this file if you do not need to add
your own filters, you should download the unpacked files if you like to add your own filters: https://downgit.github.io/#/home?url=https://github.com/mittelmark/DGTcl/tree/master/pandoc-tcl-filter. Have a look at the manual page if you need more
information: https://htmlpreview.github.io/?https://github.com/mittelmark/DGTcl/blob/master/pandoc-tcl-filter/pandoc-tcl-filter.html

DG

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)