Template repo để viết tài liệu LaTeX và render PDF tự động bằng GitHub Actions (XeLaTeX, hỗ trợ tiếng Việt).
Repo này cũng là marketplace cho plugin latex: tạo dự án LaTeX mới, mỗi dự án
một repo GitHub riêng, PDF build bằng GitHub Actions — máy không cần cài TeX.
/plugin install latex --marketplace pnstack/latex-template
Cần git và gh đã đăng nhập với scope workflow (gh auth refresh -h github.com -s workflow).
| Lệnh | Việc làm |
|---|---|
/latex:new <repo> <chủ đề> |
Scaffold dự án, viết nội dung, tạo repo, push, tải PDF về build/ |
/latex:build [thư mục] |
Commit + push thay đổi, chờ CI build, tải PDF về build/ |
Skill latex-vietnamese (cấu hình tiếng Việt, quy ước chương) nằm trong
plugins/latex.
- Bấm Use this template để tạo repo mới.
- Viết tài liệu trong
example/(hoặc đổi tên thư mục và sửaexampletrong.github/workflows/latex.yml). - Push lên
mainhoặc mở PR → tải PDF ở tab Actions → artifactpdf.
example/ chứa một tài liệu mẫu (tổng hợp công thức ma trận) để kiểm thử workflow — thay bằng nội dung của bạn.
latex.yml dùng xu-cheng/latex-action:
- Tự động: push lên
main/ PR thay đổiexample/**. - Thủ công: Actions → Render LaTeX to PDF → Run workflow, với các input:
| Input | Mặc định | Ý nghĩa |
|---|---|---|
branch |
(default) | Branch cần build |
working_directory |
example |
Thư mục chứa file .tex |
root_files |
main.tex |
Các file gốc, phân tách bằng dấu phẩy/xuống dòng |
artifact_name |
pdf |
Tên artifact upload |
cd example && latexmk -xelatex main.tex