Update Dependencies

[tajmone]

This repository hasn't been updated for quite a while, so at some point we might want to ensure its usability with the latest dependencies versions.

• Check that the docs can still build as expected with the latest versions of the third party tools and, if they don't, either fix the sources accordingly or skip updating:
  • pandoc v2.1 (x86) → v2.10.1
  • PP v2.2.2 (x86_64) → v2.14.1 — (download page)
    • CAN'T UPDATE! The PP macros won't work with latest PP version.
      We'll have to skip the PP update until they are fixed.
      • Task moved to Fix PP Macros to Work with Latest PP #33.
  • pandoc-crossref v0.3.0.0 (x86) → v0.3.7.0a
  • Highlight v3.42 (x86_64) → v3.57 — (download page)
• Update the current GitHub HTML5 Pandoc Template (v2.0) to the latest version from pandoc-goodies (v2.2) to ensure full compatibility with current pandoc version (see $table-of-contents$ instead of $toc$ pandoc-goodies#10).
• Update the download.bat script accordingly.

Although this isn't strictly necessary (end users can always download the exact versions of the dependencies via the download.bat script offered in the repo) it's still preferable to keep the assets up-to-date with the latest tools.

[tajmone]

Problems Updating PP

Updating PP and fixing the PP macros has now been moved to Issue #33

I've tried updating PP from v2.2.2 to v2.14.1 but the macros stopped working, so there must have been some significant changes in PP syntax or its internal that require fixing the macros.

The problem seems to be related to Shell scripts invocation, because the reported error is:

sh: C:UsersMyUserNameAppDataLocalTemppp4118467.sh: command not found

It seems an issue with missing path slashes, possibly affecting only Bash for Windows, unless there was a change in how PP handles special characters escaping.

Because the PP macros were taken from the pandoc-goodies repository, the ought to be fixed in their upstream project, rather than here — which could take some time since the pandoc-goodies repo hasn't been updated to the latest pandoc and PP versions for a long time, and would require some major revamping.

Since the currently used PP version (v2.2.2) works fine with the latest version of pandoc, we might just as well keep using the old PP version, and wait that the macros on pandoc-goodies are updated.