# CHEATSHEET.md

## TSYSDevStack - Toolboxes - DocsAndDiagrams

Quick Reference for Document Production Tools

---

## 🐳 Docker Commands

| Task | Command |
|------|---------|
| Run interactively | `docker run -it --rm -v $(pwd)/output:/home/tsysdevstack/TSYSDevStack/Toolbox/docs/output tsysdevstack/toolboxes-docs` |
| Run specific command | `docker run --rm -v $(pwd)/output:/home/tsysdevstack/TSYSDevStack/Toolbox/docs/output tsysdevstack/toolboxes-docs <command>` |
| Build image | `docker build -t tsysdevstack/toolboxes-docs .` |
| Run with local files | `docker run --rm -v $(pwd):/data -v $(pwd)/output:/home/tsysdevstack/TSYSDevStack/Toolbox/docs/output tsysdevstack/toolboxes-docs` |

## 📝 Pandoc Commands

| Task | Command |
|------|---------|
| Markdown to PDF | `pandoc input.md -o output.pdf --pdf-engine=xelatex` |
| Markdown to DOCX | `pandoc input.md -o output.docx` |
| HTML to PDF | `pandoc input.html -o output.pdf --pdf-engine=xelatex` |
| With custom template | `pandoc input.md -o output.pdf --template=mytemplate --pdf-engine=xelatex` |
| Resume from Markdown | `pandoc resume.md -o resume.pdf --template=eisvogel --pdf-engine=xelatex` |
| Include CSS | `pandoc input.md -o output.pdf --css=styles.css --pdf-engine=xelatex` |

## 📘 mdBook Commands

| Task | Command |
|------|---------|
| Create new book | `mdbook init mybook` |
| Build book | `mdbook build /path/to/book -d /home/tsysdevstack/TSYSDevStack/Toolbox/docs/output` |
| Serve book locally | `mdbook serve /path/to/book --hostname 0.0.0.0 --port 3000` |
| Watch and rebuild | `mdbook watch /path/to/book` |

## ✍️ Typst Commands

| Task | Command |
|------|---------|
| Compile document | `typst compile document.typ output.pdf` |
| Watch for changes | `typst watch document.typ output.pdf` |
| Export as PNG | `typst compile document.typ output.png` |

## 🎞️ Marp Commands

| Task | Command |
|------|---------|
| Convert to PDF | `marp input.md --pdf --output /home/tsysdevstack/TSYSDevStack/Toolbox/docs/output/presentation.pdf` |
| Convert to PPTX | `marp input.md --pptx --output /home/tsysdevstack/TSYSDevStack/Toolbox/docs/output/presentation.pptx` |
| Serve presentation | `marp --server --port 8080` |

## 📊 Quarto Commands

| Task | Command |
|------|---------|
| Render document | `quarto render document.qmd --to pdf` |
| Convert to HTML | `quarto render document.qmd --to html` |
| Convert to DOCX | `quarto render document.qmd --to docx` |
| Render with custom format | `quarto render document.qmd --to revealjs` |
| Create new project | `quarto create-project myproject --type book` |

## 🚦 Kroki Commands

| Task | Command |
|------|---------|
| Convert diagram | `kroki --file diagram.yaml --output /home/tsysdevstack/TSYSDevStack/Toolbox/docs/output/diagram.svg` |
| Convert with format | `kroki --file diagram.txt --type blockdiag --output /home/tsysdevstack/TSYSDevStack/Toolbox/docs/output/diagram.png` |

## 📜 Vale Commands

| Task | Command |
|------|---------|
| Check document | `vale /path/to/document.md` |
| Check with specific style | `vale --config=/path/to/.vale.ini /path/to/document.md` |

## 🔧 System Tools

| Tool | Purpose | Example |
|------|---------|---------|
| `jq` | JSON processor | `echo '{"name":"test"}' | jq '.'` |
| `yq` | YAML processor | `yq '.key' file.yaml` |
| `wkhtmltopdf` | HTML to PDF | `wkhtmltopdf input.html output.pdf` |
| `bibtool` | Bibliography tool | `bibtool -s -i refs.bib` |

## 🛠️ Mise Commands

| Task | Command |
|------|---------|
| Install runtimes | `mise install` |
| Use specific Python version | `mise use --global python@3.12.6` |
| Use specific Node.js version | `mise use --global node@21.7.3` |
| Show current tools | `mise current` |
| Install specific tool | `mise install python@3.12.6` |

## 🌐 TeXLive Commands

| Task | Command |
|------|---------|
| Compile with XeTeX | `xelatex document.tex` |
| Compile with PDFLaTeX | `pdflatex document.tex` |
| Manage packages | `tlmgr install package-name` |
| Update packages | `tlmgr update --all` |

## 📁 Directory Locations

- **Input/Working Directory**: `/data` (when mounting local files)
- **Output Directory**: `/home/tsysdevstack/TSYSDevStack/Toolbox/docs/output`
- **User Home**: `/home/tsysdevstack`
- **Mise Configuration**: `/home/tsysdevstack/.config/mise`
- **Mise Data**: `/home/tsysdevstack/.local/share/mise`

## 🔑 User Information

- **Username**: `tsysdevstack`
- **UID**: `1000`
- **Shell Options**: `bash`, `zsh`, `fish`