Undefined control sequence. <argument> \bbl@ensure@chinese

[XiangyunHuang]

Bug description

quarto render --to pdf

[1/4] index.qmd
[2/4] intro.qmd
[3/4] references.qmd
[4/4] summary.qmd

pandoc 
  to: latex
  output-file: index.tex
  standalone: true
  toc: true
  number-sections: true
  top-level-division: chapter
  pdf-engine: xelatex
  variables:
    graphics: true
    tables: true
  default-image-extension: pdf
  
metadata
  crossref:
    chapters: true
  documentclass: book
  papersize: letter
  block-headings: true
  lang: zh
  bibliography:
    - references.bib
  title: mybook
  author: Norah Jones
  date: 9/17/2023
  

Rendering PDF
running xelatex - 1
  This is XeTeX, Version 3.141592653-2.6-0.999995 (TeX Live 2023) (preloaded format=xelatex)
   restricted \write18 enabled.
  entering extended mode
  
running xelatex - 2
  This is XeTeX, Version 3.141592653-2.6-0.999995 (TeX Live 2023) (preloaded format=xelatex)
   restricted \write18 enabled.
  entering extended mode
  
ERROR: 
compilation failed- Error compiling latex
Undefined control sequence.
<argument> \bbl@ensure@chinese 
                               -hans {附录} A\hspace {.3em}
l.6 ...附录} A\hspace {.3em}}Summary}{7}{appendix.A}
                                                  % 

see /Users/xiangyun/Downloads/Document/mybook/index.log for more information.

Steps to reproduce

Step 1: create book project

quarto create-project mybook --type book

Step 2: modify _quarto.yml as follow

project:
  type: book

lang: zh

book:
  title: "mybook"
  author: "Norah Jones"
  date: "9/17/2023"
  chapters:
    - index.qmd
    - intro.qmd
    - references.qmd
  appendices:
    - summary.qmd

bibliography: references.bib

format:
  html:
    theme: cosmo
  pdf:
    documentclass: book
    include-in-header:
      text: |
        \usepackage[heading=true]{ctex}
    keep-tex: true

Expected behavior

It should be work as Quarto 1.3.450

Actual behavior

No response

Your environment

• RStudio 2023.06.2+561 "Mountain Hydrangea" Release (de44a3118f7963972e24a78b7a1ad48b4be8a217, 2023-08-25) for macOS
  Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) RStudio/2023.06.2+561 Chrome/110.0.5481.208 Electron/23.3.0 Safari/537.36
• macOS 13.5.2 (22G91)

Quarto check output

quarto check

Quarto 1.4.369
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.1.8: OK
      Dart Sass version 1.55.0: OK
      Deno version 1.33.4: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.4.369
      Path: /Applications/quarto/bin

[✓] Checking tools....................OK
      TinyTeX: (external install)
      Chromium: (not installed)

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /Users/xiangyun/Library/TinyTeX/bin/universal-darwin
      Version: 2023

[✓] Checking basic markdown render....OK

[✓] Checking Python 3 installation....OK
      Version: 3.11.5
      Path: /usr/local/opt/[email protected]/bin/python3.11
      Jupyter: (None)

      Jupyter is not available in this Python installation.
      Install with python3 -m pip install jupyter

[✓] Checking R installation...........OK
      Version: 4.3.1
      Path: /Library/Frameworks/R.framework/Resources
      LibPaths:
        - /Library/Frameworks/R.framework/Versions/4.3-x86_64/Resources/library
      knitr: 1.44
      rmarkdown: 2.24

[✓] Checking Knitr engine render......OK

[cscheid]

        \usepackage[heading=true]{ctex}

When you add an arbitrary package to a LaTeX file, then it becomes your responsibility to ensure that the resulting file compiles. Unfortunately, we can't do much about that.

[XiangyunHuang]

Make sure \appendixname is defined firstly, then the problem is solved.

include-before-body:
  text: |
    \ifdefined\appendixname
      \renewcommand*\appendixname{附录}
    \else
      \newcommand\appendixname{附录}
    \fi

It's very strange that \contentsname \listfigurename \figurename \tablename are already defined except \appendixname

[XiangyunHuang]

And, I just find out that Quarto overwrite those commands, please see #2368 (reply in thread) , but Quarto forgot to overwrite \appendixname.

[mcanouil]

I believe it is defined as the value is localised.

---
language:
  section-title-appendices: "附录"
---

https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/language/_language-zh.yml#L19

See:

• https://quarto.org/docs/authoring/language.html
• https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/language

[XiangyunHuang]

@mcanouil Quarto already defines section-title-appendices: "附录" in _language-zh.yml

https://github.com/quarto-dev/quarto-cli/blob/b60509d5b4017dd11dc791310af1a9cb152285af/src/resources/language/_language-zh.yml#L19C19-L19C19

So, in theory, I only need to set lang: zh.

[mcanouil]

Could you check with a simple single file? (not a book project)
You can use keep-tex: true to take a look at the latex file.

[XiangyunHuang]

@cscheid Finally, I find out the root cause that Quarto will inject some latex code to LaTeX document, but it seems to forget to appendix. If I consider appendix, then the issue will be solved.

quarto-cli/src/resources/filters/crossref/meta.lua

Lines 12 to 20 in 591bae8

	inject(
	"\\AtBeginDocument{%\n" ..
	maybeRenewCommand("contentsname", param("toc-title-document", "Table of contents")) ..
	maybeRenewCommand("listfigurename", listOfTitle("lof", "List of Figures")) ..
	maybeRenewCommand("listtablename", listOfTitle("lot", "List of Tables")) ..
	maybeRenewCommand("figurename", titleString("fig", "Figure")) ..
	maybeRenewCommand("tablename", titleString("tbl", "Table")) ..
	"}\n"
	)

quarto-cli/src/resources/filters/crossref/meta.lua

Lines 53 to 56 in 591bae8

	function maybeRenewCommand(command, arg)
	local commandWithArg = command .. "{" .. arg .. "}"
	return "\\ifdefined\\" .. command .. "\n " .. "\\renewcommand*\\" .. commandWithArg .. "\n\\else\n " .. "\\newcommand\\" .. commandWithArg .. "\n\\fi\n"
	end

\AtBeginDocument{%
% Quarto injects some latex code
\ifdefined\contentsname
  \renewcommand*\contentsname{目录}
\else
  \newcommand\contentsname{目录}
\fi
\ifdefined\listfigurename
  \renewcommand*\listfigurename{插图目录}
\else
  \newcommand\listfigurename{插图目录}
\fi
\ifdefined\listtablename
  \renewcommand*\listtablename{列表目录}
\else
  \newcommand\listtablename{列表目录}
\fi
\ifdefined\figurename
  \renewcommand*\figurename{图}
\else
  \newcommand\figurename{图}
\fi
\ifdefined\tablename
  \renewcommand*\tablename{表格}
\else
  \newcommand\tablename{表格}
\fi
% consider appendix
\ifdefined\appendixname
  \renewcommand*\appendixname{附录}
\else
  \newcommand\appendixname{附录}
\fi
}