diff --git a/CHANGELOG.md b/CHANGELOG.md index 7f7da6a..630d2fd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,6 +14,29 @@ __Changes__ +23.01 - Maintenance Release +------------------------------------------------------------------------------- + +__Stack__ + +* Ubuntu Jammy +* Pandoc 2.19 +* Eisvogel f5c1f20c94fa7fef4750ce46589416520bd76768 + +__Changes__ + + + +* Add pandoc-jinja and panda for variable substitution +* Remove duplicate latex packages +* Adds draftwatermark and glossaries latex packages (colindean) +* Update filters +* Add test for pandoc-cover +* python is python3 +* Add pandoc-cover filter +* Add pandoc-run-postgres + + 22.12 ------------------------------------------------------------------------------- diff --git a/NEWS.md b/NEWS.md index a6ab4da..3ef7f0c 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,4 +1,69 @@ +Pandocker 23.01: Maintenance Version +================================================================================ + +Eymoutiers, Janvier 23, 2022 + + +What is this ? +-------------------------------------------------------------------------------- + +Pandocker is a docker image containing a complete document production toolchain +based on `pandoc` with filters, templates, fonts, and the latex bazaar + +It allows you to generate slides and documents without installing the required +depencies on your machine. It is also very usefull to integrate pandoc into +a CI workflow such as Github Actions, Gitlab Pipelines, etc. + +For instance to generate an EPUB file from a markdown source, you can simply +type: + +``` +docker run --rm -v `pwd`:/pandoc dalibo/pandocker test.md -o test.epub +``` + +This image is available under BSD Licence and it has 4 main tags: + +* `stable` should be used in production +* `stable-full` for non-european languages +* `latest` and `latest-full` are the development versions + +You can also retrieve older versions by their version number: +`dalibo/pandocker:19.11`, `dalibo/pandocker:21.02-full`, etc. + +For more details : + +* Github : +* Docker Hub : + + +Maintenance release +-------------------------------------------------------------------------------- + +This new version brings minor updates and prepares the ground before important +changes. + + +How to upgrade +-------------------------------------------------------------------------------- + +```console +docker pull dalibo/pandocker:stable +``` + + +How to contribute +-------------------------------------------------------------------------------- + +Pandocker is an open project, contributions are welcome. + +If you want to help, you can find a list of "Junior Jobs" here: + + + + +---- + Pandocker 22.12: Major upgrade ================================================================================ @@ -73,6 +138,8 @@ If you want to help, you can find a list of "Junior Jobs" here: +---- + Pandocker 22.03: awesomebox + fontawesome ================================================================================ diff --git a/README.md b/README.md index ba1497f..c87ac83 100644 --- a/README.md +++ b/README.md @@ -72,7 +72,7 @@ So far, we provide the 3 templates below: * [eisvogel] is designed for lecture notes and exercises with a focus on computer science. It works with `pdflatex` and `xelatex`. -* [leaflet] creates simple 3-fold brochures. Works only with `xelatex` +* [easy templates] is a collection of HTML templates * [letter] is for writing letters in markdown. Works only with `xelatex` You can use them simply by adding `--template=xxx` to your compilation @@ -88,6 +88,7 @@ Please go the project page of each template for more details. [eisvogel]: https://github.com/Wandmalfarbe/pandoc-latex-template [leaflet]: https://gitlab.com/daamien/pandoc-leaflet-template [letter]: https://github.com/aaronwolen/pandoc-letter +[easy templates]: https://github.com/ryangrose/easy-pandoc-templates ## Filters @@ -95,6 +96,7 @@ This docker image embeds a number of usefull pandoc filters. You can simply enab by adding the option `--filter xxx` where `xxx` is the name of one of the following filters below: +* [panda] : Multi-purpose Lua filter * [pandoc-citeproc] : manage bibliographies and citations * [pandoc-codeblock-include] : insert an external file into a codeblock * [pandoc-cover] : Add a PDF cover based on an SVG template @@ -110,6 +112,7 @@ filters below: * [pandoc-minted] : advanced syntax highlighting * [pandoc-crossref] : support for cross-referencing sections, figures, and more * [pandoc-run-postgres] : Execute SQL queries inside a markdown document +* [pandoc-jinja] : Render pandoc metadata inside the document itself @@ -120,6 +123,7 @@ You can use the docker arg `--workdir="some/place/elsewhere"` to specify another location. The same principle applies to the [pandoc-codeblock-include] and [pandoc-mustache] filters. +[pando]: https://github.com/CDSoft/panda [pandoc-cover]: https://github.com/daamien/pandoc-cover [pandoc-citeproc]: https://pandoc.org/demo/example19/Extension-citations.html [pandoc-codeblock-include]: https://github.com/chdemko/pandoc-codeblock-include @@ -135,6 +139,7 @@ and [pandoc-mustache] filters. [pandoc-minted]: https://github.com/nick-ulle/pandoc-minted [pandoc-crossref]: https://github.com/lierdakil/pandoc-crossref [pandoc-run-postgres]: https://github.com/daamien/pandoc-run-postgres +[pandoc-jinja]: https://github.com/daamien/pandoc-jinja ## Fonts diff --git a/ubuntu/Dockerfile b/ubuntu/Dockerfile index 7a85f10..68f32d0 100644 --- a/ubuntu/Dockerfile +++ b/ubuntu/Dockerfile @@ -89,7 +89,7 @@ RUN mkdir -p ~/.ssh && \ ## # -# The easiest to produce reveal slides is to point to a CDN like this: +# The easiest way to produce reveal slides is to point to a CDN like this: # # -V revealjs-url=https://unpkg.com/reveal.js #