Skip to content

Add Quarto troubleshooting section#199

Open
Copilot wants to merge 5 commits intomainfrom
copilot/summarize-quarto-troubleshooting
Open

Add Quarto troubleshooting section#199
Copilot wants to merge 5 commits intomainfrom
copilot/summarize-quarto-troubleshooting

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 30, 2026

Adds troubleshooting guidance to the Quarto chapter with summary of diagnostic tools and link to official guide.

Changes

  • quarto/troubleshooting.qmd: New section covering quarto check, debug logging, stack traces, log file locations, and memory allocation options with cross-platform syntax for both Unix-like systems (macOS, Linux) and Windows PowerShell
  • quarto.qmd: Include troubleshooting section between Advanced Features and Additional Resources

The section provides comprehensive troubleshooting guidance including:

  • Checking Your Setup: Details about what quarto check verifies (Quarto version, dependencies, LaTeX, Python/Jupyter, R/knitr, library paths)
  • Diagnostic Tools: Commands for verbose logging (QUARTO_LOG_LEVEL=DEBUG), stack traces (QUARTO_PRINT_STACK), and log file locations (all platforms)
  • Common Issues: Out-of-memory errors, PDF rendering problems (with TinyTeX installation), and environment conflicts
  • Advanced Troubleshooting: Links to specialized topics (Jupyter debugging, Lua filter tracing, Julia-specific issues)

All content is based on the official guide at https://quarto.org/docs/troubleshooting/ and provides accurate, actionable guidance while maintaining a concise summary format.

Troubleshooting section screenshot

Original prompt

This section details on the original issue you should resolve

<issue_title>summarize and link to quarto troubleshooting guide</issue_title>
<issue_description>https://quarto.org/docs/troubleshooting/</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: d-morrison <2474437+d-morrison@users.noreply.github.com>
Copilot AI changed the title [WIP] Summarize and link to Quarto troubleshooting guide Add Quarto troubleshooting section Jan 30, 2026
Copilot AI requested a review from d-morrison January 30, 2026 09:04
@d-morrison
Copy link
Copy Markdown
Member

@copilot I unblocked https://quarto.org/docs/troubleshooting/; try again

Co-authored-by: d-morrison <2474437+d-morrison@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jan 30, 2026

@copilot I unblocked https://quarto.org/docs/troubleshooting/; try again

I've enhanced the troubleshooting section with content from the official guide in commit 3654a3f. The updated section now includes:

  • More comprehensive details about quarto check
  • Proper export syntax for environment variables on Unix systems
  • Command-line flag alternatives (e.g., --log-level debug)
  • New "Common Issues" section covering PDF rendering, memory errors, and environment conflicts
  • New "Advanced Troubleshooting" section linking to Jupyter, Lua filter, and Julia-specific topics

Screenshot of updated troubleshooting section

Copilot AI and others added 2 commits January 30, 2026 09:31
Co-authored-by: d-morrison <2474437+d-morrison@users.noreply.github.com>
Co-authored-by: d-morrison <2474437+d-morrison@users.noreply.github.com>
Copilot AI requested a review from d-morrison January 30, 2026 09:36
@d-morrison d-morrison marked this pull request as ready for review January 30, 2026 19:13
@github-actions
Copy link
Copy Markdown

PR Preview Action v1.8.1-1-g6f3a89d

QR code for preview link

🚀 View preview at
https://UCD-SERG.github.io/lab-manual/pr-preview/pr-199/

Built to branch gh-pages at 2026-01-30 19:17 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

summarize and link to quarto troubleshooting guide

2 participants