Appendix F — Reading in Another Language

Keywords

Quarto, reproducible publishing, coding agents, Markdown, Python, EPUB, data analysis, k-means clustering

The book is written in English, but its tools need not be used in English.

The website edition can be translated by your browser. In Chrome, the Google Translate extension translates the page in place (checked 2026-10-30). Code stays as written: translators skip code, so commands, file names and the prompts in the agent boxes remain in English. That is deliberate. The prompts name files, columns and options that must match your project exactly, and a translated file name would no longer be found.

The agent understands many languages. You can write your own prompts in Spanish, or any other language the model knows, and keep the literal names in backticks so they are not translated. To have the agent answer in Spanish while leaving code alone, make your first prompt:

Ask your coding agent
Responde siempre en español; deja el código y los nombres de archivo en inglés.

(“Always reply in Spanish; leave code and file names in English.”)

The workshop’s slides, which this book follows, were designed for browser translation: their prompts are translated for reading, while file names, columns and options are marked to stay in English.

TipIn practice

A translated page can mistranslate technical words. In testing, Google Translate rendered the column name mdm as “señora” and “Render” as “Prestar”. When a translated sentence seems odd, check the original, and always copy literal names from the code, never from translated prose.