Merge pull request #118 from dalibo/release_19_11

Release 19 11

CHANGELOG.md

@@ -1,9 +1,10 @@
 Changelog
 ===============================================================================
 
-19.11 - WIP
+19.11
 -------------------------------------------------------------------------------
 
+<!-- git log 19.08..19.11 --oneline -->
 
 __Stack__
 * Debian 9 stretch
@@ -16,6 +17,8 @@ __Changes__
 
 * Switch to Pandoc 2.7.3 (colindean)
 * Switch to Eisvogel 1.3 (daamien)
+* [doc] FAQ
+* [CI] enable Github Actions
 
 
 19.08

NEWS.md

@@ -1,3 +1,72 @@
+Pandocker 19.11 is out !
+================================================================================
+
+Paris, november 12
+
+What is this ?
+--------------------------------------------------------------------------------
+
+Pandocker is a docker image containing a complete document production toolchain.
+
+It allows you to generate slides and documents using `pandoc`, but without
+installing the required depencies on your machine.
+
+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 is designed to work without
+specific templates.
+
+The project has 2 main branchs:
+
+* `dalibo/pandocker:stable` should be used in production ( = 19.11 )
+* `dalibo/pandocker:latest` is the development version
+
+You can also retrieve images by their version number : `dalibo/pandocker:18.03`,
+`dalibo/pandocker:17.12`, etc.
+
+For more details :
+
+* Github : <https://github.com/dalibo/pandocker>
+* Docker Hub : <https://hub.docker.com/r/dalibo/pandocker/>
+
+
+This is a maintenance release
+--------------------------------------------------------------------------------
+
+This is version brings very few changes. The version of Pandoc has been updated
+and the embbeded template ([eisvogel]) has been upgraded too. 
+
+
+
+How to upgrade
+--------------------------------------------------------------------------------
+
+```console
+docker pull dalibo/pandocker:stable
+```
+
+If you installed the toolchain locally, please read:
+<https://github.com/dalibo/pandocker/blob/master/UPGRADE.md#without-docker-local-setup>
+
+
+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%20Jobs>
+
+
+
+---
+
 Pandocker 19.08 is out !
 ================================================================================
 

UPGRADE.md

@@ -13,6 +13,24 @@ we will only support the latest stable version. If you want to make your life
 easier, use the docker image as described above.
 
 
+## Upgrade from 19.08 to 19.11
+
+1. Upgrade Pandoc
+
+```shell
+URL=https://github.com/jgm/pandoc/releases/download/2.7/pandoc-2.7-3-amd64.deb
+wget -O pandoc.deb $URL
+sudo dpkg --install pandoc.deb
+```
+
+2. Upgrade Eisvogel
+
+```shell
+$ export EISVOGEL_REPO=https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template
+$ export EISVOGEL_VERSION=v1.3.0
+$ export TEMPLATES_DIR=~/.pandoc/templates
+$ wget ${EISVOGEL_REPO}/${EISVOGEL_VERSION}/eisvogel.tex -O ${TEMPLATES_DIR}/eisvogel.latex
+```
 
 ### Upgrade from 19.05 to 19.08