>= Pandoc 3.2.1: warn about LaTeX writer changes

[cscheid]

Pandoc 3.4 introduces a larger-than-usual change in the LaTeX writer that we should warn our users about. See discussion.

[cwickham]

Do we have a plan for when and how we'll do this?

It feels like extension authors might get complaints from their users as soon as we roll over to the 1.6 download. It would be nice to give them some advance warning.

[cscheid]

True. I think the best we can do is:

• point users to the actual Pandoc commit that made the change: jgm/pandoc@26b25a4

• explain to them that they if they override the graphics.tex partial, they need to update (it's src/resources/formats/pdf/pandoc/graphics.tex in our repo)

[mcanouil]

If it helps.

• https://github.com/cmarquardt/quarto-simple-article
• https://github.com/kelly-sovacool/asm-msystems
• https://github.com/smnnlt/sportrxiv

# gh auth login

CSV_FILE="https://raw.githubusercontent.com/mcanouil/quarto-extensions/refs/heads/main/extensions/quarto-extensions.csv"
SEARCH_FILE="graphics.tex"

includes_file() {
  local repo=$1
  local branch=$2
  local search_file=$3
  gh api -X GET "repos/${repo}/git/trees/${branch}?recursive=1" --jq ".tree[] | select(.path | endswith(\"${search_file}\"))" 2>/dev/null
}

curl -s "${CSV_FILE}" | while IFS= read -r REPO; do
  RESULT=$(check_branch "${REPO}" "main" "${SEARCH_FILE}")
  if [[ "${RESULT}" == *'"status":"404"'* ]]; then
    RESULT=$(check_branch "${REPO}" "master" "${SEARCH_FILE}")
  fi
  if [[ "${RESULT}" == *'"status":"404"'* ]]; then
    echo "Default branch unknown ..."
  elif [ -n "${RESULT}" ]; then
    echo "https://github.com/${REPO}"
  fi
done

[cwickham]

Using the old Pandoc syntax directly in a template would also cause problems, right?

https://github.com/mps9506/quarto-cv/blob/a52baf31f57a6b732e02c2520785da9b958b5821/_extensions/quarto-cv/quarto-cv.tex#L24-L28

@mcanouil Could you expand your search to include that kind of use?

[mcanouil]

Yes, but it needs a bit more work as this needs to search in the files.

[mcanouil]

Here is an alternative version to find keyword in files (tex).

Below are the repository using "graphics":

• https://github.com/christopherkenny/nature
• https://github.com/cmarquardt/quarto-simple-article
• https://github.com/dfolio/quarto-ieee
• https://github.com/dialoa/first-line-indent
• https://github.com/ihrke/mdpi
• https://github.com/juliantao/quarto-asce
• https://github.com/mps9506/quarto-cv
• https://github.com/nareal/naletter
• https://github.com/nareal/nastatement
• https://github.com/nmfs-opensci/quarto_titlepages
• https://github.com/quarto-journals/biophysical-journal
• https://github.com/quarto-journals/elsevier
• https://github.com/quarto-journals/jasa
• https://github.com/quarto-journals/plos
• https://github.com/sebdunnett/quarto-iop
• https://github.com/smnnlt/sportrxiv

#!/usr/bin/env bash

CSV_FILE="https://raw.githubusercontent.com/mcanouil/quarto-extensions/refs/heads/main/extensions/quarto-extensions.csv"
KEYWORD="graphics"

includes_keyword() {
  local repo=$1
  local branch=$2
  local keyword=$3
  if [[ "${repo}" == */*/* ]]; then
    repo=${repo%/*}
  fi
  tex_files=$(gh api -X GET "repos/${repo}/git/trees/${branch}?recursive=1" --jq '.tree[] | select(.path | endswith(".tex")) | .path' 2>/dev/null)
  if [[ "${tex_files}" == *'"status":"404"'* ]]; then
    echo "${tex_files}"
    return 0
  fi
  while IFS= read -r file; do
    file_content=$(gh api -X GET "repos/${repo}/contents/${file}?ref=${branch}" --jq '.content' 2>/dev/null | base64 --decode)
    if [[ "${file_content}" == *"${keyword}"* ]]; then
      echo "${repo}"
      return 0
    fi
  done <<< "${tex_files}"

  return 1
}

curl -s "${CSV_FILE}" | while IFS= read -r REPO; do
  RESULT=$(includes_keyword "${REPO}" "main" "${KEYWORD}")
  if [[ "${RESULT}" == *'"status":"404"'* ]]; then
    RESULT=$(includes_keyword "${REPO}" "master" "${KEYWORD}")
  fi
  if [[ "${RESULT}" == *'"status":"404"'* ]]; then
    echo "${REPO} has not main or master branch."
  fi

  if [[ -n "${RESULT}" && "${RESULT}" != *'"status":"404"'* ]]; then
    echo "https://github.com/${RESULT}"
  fi
done

[mcanouil]

Changing the keyword to look for:

KEYWORD="\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}"

• https://github.com/cmarquardt/quarto-simple-article
• https://github.com/dfolio/quarto-ieee
• https://github.com/dialoa/first-line-indent
• https://github.com/juliantao/quarto-asce
• https://github.com/mps9506/quarto-cv
• https://github.com/nareal/naletter
• https://github.com/nareal/nastatement
• https://github.com/nmfs-opensci/quarto_titlepages
• https://github.com/smnnlt/sportrxiv

[cderv]

We're working on 1.7 so I think this can be claused now. We'll do better for future change like that.