latex docs and tag cleanup / organization

[svenevs]

There's a couple of docs cleanups that I would like to achieve over at https://hub.docker.com/r/pandoc/latex

• [X] Supported stacks <a name="supported-stacks"></a> I think this should be an id.
  • It's working again
• [X] TeXLive Version table is not so great since it does not render. I asked for help in https://github.com/docker/hub-feedback/issues/2229 but I don't think <table> is supported so we may just want to fallback on a bulleted list.
  • Table support was added!
• [x] Delete -old tags that I created many moons ago during the initial latex archive infrastructure woes.
• [ ] Figure out why some of them are broken and either document them as deprecated or (manually) fix them. See 2.10.1 as example. Could be scripting error.
• [x] Populate the table of pandoc <=> latex versions fully since they have now all been scraped :slightly_smiling_face:
• [ ] Finally: see if I can revive the automatic description updating once the docs are up to date so that it can be added to the release pipeline. :crossed_fingers:

I ran a quickly written script latex-check.sh.txt overnight to scrape all of the versions, pasting the output here for my own future bookkeeping. I aim to whittle through this slowly.

---

results.md from script.

Using the output below, populate a verification of / additions to versions.md table checklist here:

• [ ] TODO: parse the below output

---

Checking docs locally: docker run --rm -it --volume "$(pwd):/data" --entrypoint= pandoc/core:latest /bin/sh -c 'apk add make && make docs-latex' | xclip -i -selection clipboard (note that you need to delete a bit of apk output at the top).

[tarleb]

Oh interesting, looks like Markdown rendering on Docker Hub has changed: I can no longer get raw HTML to work, it always becomes normal text now. On the bright side, pipe tables are actually supported now.

[svenevs]

I can no longer get raw HTML to work, it always becomes normal text now.

I think they fixed it for us, the <table> and the <a name="supported stacks"></a> are working (assuming you didn't change them yourself). I tried using a pipe table but it didn't work, maybe I did it wrong?

I started going through the version list, but am a little confused. What is the relationship between the tags 2.17 (working), 2.17.0 (broken), and 2.17.0.0? Are they all supposed to be the same image?

[tarleb]

I tried to document this in section "Supported Tags", but that might not be clear enough and need a little update: the tag 2.17.0 is no longer supported; 2.17 points to pandoc version 2.17.1.1.

[tarleb]

Closing, as the issue has become stale, and the most pressing issues have been addressed.