MCP HubMCP Hub
← Retour aux compétences

render-puzzle-docs

pjt222
Mis à jour 2 days ago
5 vues
17
2
17
Voir sur GitHub
Testsgeneral

À propos

Cette compétence génère le site de documentation jigsawR Quarto pour GitHub Pages. Elle prend en charge le rendu complet du site avec vidage du cache, le rendu plus rapide avec cache, et le rendu de pages individuelles pour un travail itératif. Utilisez-la après des modifications de contenu, lors de l'édition de documentation, pour préparer des versions, ou pour déboguer des problèmes de rendu Quarto.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/render-puzzle-docs

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

name: render-puzzle-docs locale: de source_locale: en source_commit: 6f65f316 translator: claude translation_date: "2026-03-17" description: > Die jigsawR Quarto-Dokumentationsseite fuer GitHub Pages rendern. Unterstuetzt frisches Rendern (Cache loeschen), gecachtes Rendern (schneller) und Einzelseiten-Rendern. Verwendet das mitgelieferte Render-Skript oder direkten quarto.exe-Aufruf aus WSL. Anwenden beim Erstellen der vollstaendigen Seite nach Inhaltsaenderungen, beim Rendern einer einzelnen Seite waehrend iterativer Bearbeitung, beim Vorbereiten der Dokumentation fuer ein Release oder PR, oder beim Debuggen von Renderfehlern in Quarto-.qmd-Dateien. license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: jigsawr complexity: basic language: R tags: jigsawr, quarto, documentation, github-pages, rendering

Puzzle-Dokumentation rendern

Die jigsawR Quarto-Dokumentationsseite rendern.

Wann verwenden

  • Vollstaendige Dokumentationsseite nach Inhaltsaenderungen erstellen
  • Einzelne Seite waehrend iterativer Bearbeitung rendern
  • Dokumentation fuer ein Release oder PR vorbereiten
  • Renderfehler in Quarto-.qmd-Dateien debuggen

Eingaben

  • Erforderlich: Render-Modus (fresh, cached oder single)
  • Optional: Spezifischer .qmd-Dateipfad (fuer Einzelseiten-Modus)
  • Optional: Ob das Ergebnis im Browser geoeffnet werden soll

Vorgehensweise

Schritt 1: Render-Modus waehlen

ModusBefehlDauerVerwendung
Frischbash inst/scripts/render_quarto.sh~5-7 MinInhalt geaendert, Cache veraltet
Gecachtbash inst/scripts/render_quarto.sh --cached~1-2 MinKleine Aenderungen, Cache gueltig
EinzelnDirekter quarto.exe-Aufruf~30sIteration an einer Seite

Erwartet: Render-Modus basierend auf der aktuellen Situation ausgewaehlt: frisch fuer Inhaltsaenderungen oder veralteten Cache, gecacht fuer kleine Aenderungen, einzeln fuer Iteration an einer Seite.

Bei Fehler: Im Zweifelsfall ob der Cache veraltet ist, standardmaessig frisch rendern. Es dauert laenger, garantiert aber korrekte Ausgabe.

Schritt 2: Rendern ausfuehren

Frisches Rendern (loescht _freeze und _site, fuehrt allen R-Code erneut aus):

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

Gecachtes Rendern (verwendet vorhandene _freeze-Dateien):

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

Einzelne Seite (eine .qmd-Datei direkt rendern):

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

Erwartet: Rendern wird ohne Fehler abgeschlossen. Ausgabe in quarto/_site/.

Bei Fehler:

  • Auf R-Code-Fehler in .qmd-Chunks pruefen (nach #| label:-Markern suchen)
  • Sicherstellen dass pandoc ueber die Umgebungsvariable RSTUDIO_PANDOC verfuegbar ist
  • Cache loeschen versuchen: rm -rf quarto/_freeze quarto/_site
  • Pruefen ob alle in .qmd-Dateien verwendeten R-Pakete installiert sind

Schritt 3: Ausgabe ueberpruefen

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

Die Seitenstruktur bestaetigen:

  • quarto/_site/index.html existiert
  • Navigationslinks loesen korrekt auf
  • Bilder und SVG-Dateien werden korrekt dargestellt

Erwartet: index.html existiert und ist nicht leer. Navigationslinks loesen auf, und Bilder/SVGs werden im Browser korrekt dargestellt.

Bei Fehler: Wenn index.html fehlt, ist das Rendern wahrscheinlich stillschweigend fehlgeschlagen. Mit ausfuehrlicher Ausgabe erneut ausfuehren und auf R-Code-Fehler in .qmd-Chunks pruefen. Wenn nur einige Seiten fehlen, ueberpruefen ob diese .qmd-Dateien in _quarto.yml aufgefuehrt sind.

Schritt 4: Vorschau (Optional)

Im Windows-Browser oeffnen:

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

Erwartet: Die Dokumentationsseite oeffnet sich im Windows-Standardbrowser zur visuellen Pruefung.

Bei Fehler: Wenn der cmd.exe /c start-Befehl aus WSL fehlschlaegt, stattdessen explorer.exe "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html" versuchen. Alternativ die Datei manuell im Browser aufrufen.

Validierung

  • quarto/_site/index.html existiert und ist nicht leer
  • Keine Renderfehler in der Konsolenausgabe
  • Alle R-Code-Chunks wurden erfolgreich ausgefuehrt (auf Fehlermeldungen pruefen)
  • Navigation zwischen Seiten funktioniert
  • Alle .qmd-Dateien haben #| label: bei Code-Chunks fuer saubere Ausgabe

Haeufige Stolperfallen

  • Veralteter Freeze-Cache: Wenn sich R-Code geaendert hat, frisches Rendern zum Neugenerieren der _freeze-Dateien verwenden
  • Fehlende R-Pakete: Quarto-.qmd-Dateien koennten Pakete nutzen die nicht in renv enthalten sind; diese zuerst installieren
  • Pandoc nicht gefunden: Sicherstellen dass RSTUDIO_PANDOC in .Renviron gesetzt ist
  • Lange Renderzeiten: Frisches Rendern dauert 5-7 Minuten (14 Seiten mit R-Ausfuehrung); gecachten Modus waehrend der Iteration verwenden
  • Code-Chunk-Label: Alle R-Code-Chunks sollten #| label: fuer sauberes Rendering haben

Verwandte Skills

  • generate-puzzle — Puzzle-Ausgabe generieren auf die in der Dokumentation verwiesen wird
  • run-puzzle-tests — Sicherstellen dass Codebeispiele in der Doku korrekt sind
  • create-quarto-report — Allgemeine Quarto-Dokumenterstellung

Dépôt GitHub

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

Compétences associées

evaluating-llms-harness

Tests

Cette compétence Claude exécute le lm-evaluation-harness pour évaluer les modèles de langage sur plus de 60 tâches académiques standardisées telles que MMLU et GSM8K. Elle est conçue pour permettre aux développeurs de comparer la qualité des modèles, de suivre les progrès de l'entraînement ou de rapporter des résultats académiques. L'outil prend en charge différents backends, incluant les modèles HuggingFace et vLLM.

Voir la compétence

cloudflare-cron-triggers

Tests

Cette compétence fournit une connaissance complète pour la mise en œuvre de Déclencheurs Cron Cloudflare afin de planifier des Workers à l'aide d'expressions cron. Elle couvre la configuration de tâches périodiques, de travaux de maintenance et de flux de travail automatisés, tout en traitant des problèmes courants tels que les expressions cron non valides et les problèmes de fuseau horaire. Les développeurs peuvent l'utiliser pour configurer des gestionnaires planifiés, tester des déclencheurs cron et intégrer avec Workflows et Green Compute.

Voir la compétence

webapp-testing

Tests

Cette Compétence Claude fournit une boîte à outils basée sur Playwright pour tester des applications web locales via des scripts Python. Elle permet la vérification frontend, le débogage d'interface utilisateur, la capture d'écrans et la consultation des journaux, tout en gérant les cycles de vie du serveur. Utilisez-la pour les tâches d'automatisation de navigateur, mais exécutez les scripts directement plutôt que de lire leur code source pour éviter la pollution du contexte.

Voir la compétence

finishing-a-development-branch

Tests

Cette compétence aide les développeurs à finaliser leur travail en vérifiant que les tests passent, puis en présentant des options d'intégration structurées. Elle guide le processus de fusion, de création de PRs ou de nettoyage des branches une fois l'implémentation terminée. Utilisez-la lorsque votre code est prêt et testé pour finaliser systématiquement le cycle de développement.

Voir la compétence