Skip to content

Commit

Permalink
Merge pull request #260 from dalibo/258-release-2301
Browse files Browse the repository at this point in the history
Release 23.01
  • Loading branch information
daamien authored Jan 23, 2023
2 parents 4577247 + 982b975 commit 77e028c
Show file tree
Hide file tree
Showing 4 changed files with 97 additions and 2 deletions.
23 changes: 23 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,29 @@ __Changes__

<https://github.com/dalibo/pandocker/milestone/14>

23.01 - Maintenance Release
-------------------------------------------------------------------------------

__Stack__

* Ubuntu Jammy
* Pandoc 2.19
* Eisvogel f5c1f20c94fa7fef4750ce46589416520bd76768

__Changes__

<https://github.com/dalibo/pandocker/milestone/14>

* 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
-------------------------------------------------------------------------------

Expand Down
67 changes: 67 additions & 0 deletions NEWS.md
Original file line number Diff line number Diff line change
@@ -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 : <https://github.com/dalibo/pandocker>
* Docker Hub : <https://hub.docker.com/r/dalibo/pandocker/>


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:

<https://github.com/dalibo/pandocker/labels/Junior%20Job>


----

Pandocker 22.12: Major upgrade
================================================================================

Expand Down Expand Up @@ -73,6 +138,8 @@ If you want to help, you can find a list of "Junior Jobs" here:
<https://github.com/dalibo/pandocker/labels/Junior%20Job>


----


Pandocker 22.03: awesomebox + fontawesome
================================================================================
Expand Down
7 changes: 6 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -88,13 +88,15 @@ 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

This docker image embeds a number of usefull pandoc filters. You can simply enable them
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
Expand All @@ -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



Expand All @@ -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
Expand All @@ -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

Expand Down
2 changes: 1 addition & 1 deletion ubuntu/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -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
#
Expand Down

0 comments on commit 77e028c

Please sign in to comment.