Back to Skills

render-puzzle-docs

pjt222
Updated 2 days ago
7 views
17
2
17
View on GitHub
Metaworddesign

About

This skill renders the jigsawR Quarto documentation site for GitHub Pages, supporting fresh, cached, or single-page renders. Use it for full site builds after content changes, single-page rendering during iterative editing, or preparing documentation for releases. It can utilize either a bundled script or direct Quarto invocation via WSL.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/render-puzzle-docs

Copy and paste this command in Claude Code to install this skill

Documentation

渲拼之文檔

渲 jigsawR 之 Quarto 文檔站。

用時

  • 內變後建全文檔站乃用
  • 於迭編時渲單頁乃用
  • 為釋或 PR 備文檔乃用
  • 於 Quarto .qmd 之文中察渲誤乃用

  • 必要:渲模(freshcached、或 single
  • 可選:具體 .qmd 文之路(為單頁模)
  • 可選:是否於覽器開其果

第一步:擇渲模

用時
Freshbash inst/scripts/render_quarto.sh~5-7 分內變、緩陳
Cachedbash inst/scripts/render_quarto.sh --cached~1-2 分微編、緩有效
Single直 quarto.exe~30s迭一頁

得:依當境擇渲模:內變或緩陳用 fresh,微編用 cached,迭一頁用 single。

敗則:若不確緩是否陳,默用 fresh。其雖久而保正出。

第二步:行渲

Fresh 渲(清 _freeze_site,再行諸 R 碼):

cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh

Cached 渲(用現 _freeze 文):

cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh --cached

單頁(直渲一 .qmd 文):

QUARTO_EXE="/mnt/c/Program Files/RStudio/resources/app/bin/quarto/bin/quarto.exe"
"$QUARTO_EXE" render quarto/getting-started.qmd

得:渲畢無誤。出於 quarto/_site/

敗則:

  • 察 .qmd 塊中 R 碼之誤(尋 #| label: 之標)
  • 驗 pandoc 由 RSTUDIO_PANDOC 環變可得
  • 試清緩:rm -rf quarto/_freeze quarto/_site
  • 察 .qmd 文中所用之 R 包皆已裝

第三步:驗其出

ls -la /mnt/d/dev/p/jigsawR/quarto/_site/index.html

確站之構:

  • quarto/_site/index.html
  • 導鏈解正
  • 圖與 SVG 文渲正

得:index.html 存且非空。導鏈解,圖/SVG 於覽器渲正。

敗則:若 index.html 缺,渲或暗敗。重行附詳出察 R 碼之誤於 .qmd 塊。若獨某頁缺,驗其 .qmd 文於 _quarto.yml 中已列。

第四步:預覽(可選)

於 Windows 覽器開:

cmd.exe /c start "" "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"

得:文檔站於 Windows 默覽器開以視察。

敗則:若自 WSL cmd.exe /c start 命敗,試 explorer.exe "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"。或於覽器手導至文。

  • quarto/_site/index.html 存且非空
  • 控台之出無渲誤
  • 諸 R 碼塊皆順行(察誤信)
  • 諸頁之導行
  • 諸 .qmd 文之碼塊皆有 #| label: 以清渲

  • 陳之凍緩:若 R 碼變,用 fresh 渲再生 _freeze
  • 缺 R 包:Quarto .qmd 文或用 renv 中無之包;先裝之
  • 無 Pandoc:確 RSTUDIO_PANDOC 設於 .Renviron
  • 久之渲:fresh 渲 5-7 分(14 頁附 R 行);迭時用 cached 模
  • 碼塊之標:諸 R 碼塊宜有 #| label: 以清渲

  • generate-puzzle — 生文檔所引之拼出
  • run-puzzle-tests — 確文中之碼例為正
  • create-quarto-report — 通用之 Quarto 文檔之立

GitHub Repository

pjt222/agent-almanac
Path: i18n/wenyan/skills/render-puzzle-docs
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill