pandoc/dockerfiles

latex docs and tag cleanup / organization

svenevs opened this issue · 4 comments

svenevs commented

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

  • Supported stacks <a name="supported-stacks"></a> I think this should be an id.
    • It's working again
  • TeXLive Version table is not so great since it does not render. I asked for help in docker/hub-feedback#2229 but I don't think <table> is supported so we may just want to fallback on a bulleted list.
    • Table support was added!
  • 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.
  • Populate the table of pandoc <=> latex versions fully since they have now all been scraped 🙂
  • 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. 🤞

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 commented

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 commented

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 commented

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.

  • 👍1