mirror of
https://github.com/Kaffesky/kaffesky-markdown-templates.git
synced 2026-04-18 10:37:30 +02:00
Update tex conversion
This commit is contained in:
jostein
parent
6df06a39a1
commit
db70d3f46d
2 changed files with 323 additions and 0 deletions
|
|
@ -0,0 +1,163 @@
|
||||||
|
# template_first-skyfritt-example.tex
|
||||||
|
|
||||||
|
Pandoc template for generating PDFs via XeLaTeX. Produces a document with a title page, table of contents, Roboto font, A4 format, 2.5 cm margins, and page numbering.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- [Pandoc](https://pandoc.org)
|
||||||
|
- A TeX Live installation with XeLaTeX
|
||||||
|
- Homebrew (for installing fontconfig)
|
||||||
|
- Roboto and Roboto Mono fonts
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## macOS Installation
|
||||||
|
|
||||||
|
### 1. Install Homebrew (if not already installed)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Install Pandoc
|
||||||
|
|
||||||
|
```bash
|
||||||
|
brew install pandoc
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Install MacTeX / TeX Live
|
||||||
|
|
||||||
|
Download and install [MacTeX](https://tug.org/mactex/) from `https://tug.org/mactex/`, or install the lighter BasicTeX:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
brew install --cask basictex
|
||||||
|
```
|
||||||
|
|
||||||
|
After installation, open a new terminal session so that `/Library/TeX/texbin` is on your PATH.
|
||||||
|
|
||||||
|
### 4. Update tlmgr and install LaTeX packages
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo tlmgr update --self
|
||||||
|
|
||||||
|
sudo tlmgr install \
|
||||||
|
titlesec \
|
||||||
|
tocloft \
|
||||||
|
booktabs \
|
||||||
|
tools \
|
||||||
|
fancyhdr \
|
||||||
|
parskip \
|
||||||
|
float \
|
||||||
|
listings \
|
||||||
|
fancyvrb \
|
||||||
|
caption \
|
||||||
|
hyperref \
|
||||||
|
xcolor \
|
||||||
|
fontspec \
|
||||||
|
geometry \
|
||||||
|
babel
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Install fontconfig
|
||||||
|
|
||||||
|
`fc-list` and `fc-cache` are needed for font verification and are not included on macOS by default:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
brew install fontconfig
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. Install fonts
|
||||||
|
|
||||||
|
Download Roboto and Roboto Mono from Google Fonts and install them into `~/Library/Fonts/`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -L "https://fonts.google.com/download?family=Roboto" -o roboto.zip && \
|
||||||
|
curl -L "https://fonts.google.com/download?family=Roboto+Mono" -o roboto-mono.zip && \
|
||||||
|
unzip roboto.zip -d ~/roboto && \
|
||||||
|
unzip roboto-mono.zip -d ~/roboto-mono && \
|
||||||
|
cp ~/roboto/static/*.ttf ~/Library/Fonts/ && \
|
||||||
|
cp ~/roboto-mono/static/*.ttf ~/Library/Fonts/ && \
|
||||||
|
fc-cache -f -v
|
||||||
|
```
|
||||||
|
|
||||||
|
Clean up:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
rm -rf roboto.zip roboto-mono.zip ~/roboto ~/roboto-mono
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. Verify fonts are available to XeLaTeX
|
||||||
|
|
||||||
|
```bash
|
||||||
|
fc-list | grep -i roboto
|
||||||
|
```
|
||||||
|
|
||||||
|
You should see several lines listing the Roboto and Roboto Mono font files. If nothing appears, double-check that the `.ttf` files are present in `~/Library/Fonts/`.
|
||||||
|
|
||||||
|
### 8. Verify LaTeX packages are installed
|
||||||
|
|
||||||
|
```bash
|
||||||
|
kpsewhich titlesec.sty tocloft.sty fancyhdr.sty caption.sty
|
||||||
|
```
|
||||||
|
|
||||||
|
Each line should return a file path. If any are blank, install the missing package individually:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo tlmgr install <packagename>
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Add a YAML front matter block to the top of your Markdown file:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
title: "My Document"
|
||||||
|
subtitle: "An optional subtitle"
|
||||||
|
author: "Jane Doe"
|
||||||
|
date: "March 2026"
|
||||||
|
description: "An optional blurb shown at the bottom of the title page."
|
||||||
|
---
|
||||||
|
```
|
||||||
|
|
||||||
|
Then compile with:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pandoc input.md -o output.pdf \
|
||||||
|
--pdf-engine=xelatex \
|
||||||
|
--template=template_first-skyfritt-example.tex
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Fonts used
|
||||||
|
|
||||||
|
| Role | Font | Source |
|
||||||
|
|------------|--------------|-------------------------------------------------|
|
||||||
|
| Main text | Roboto | https://fonts.google.com/specimen/Roboto |
|
||||||
|
| Monospace | Roboto Mono | https://fonts.google.com/specimen/Roboto+Mono |
|
||||||
|
|
||||||
|
Both fonts are open source and licensed under the Apache License 2.0.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
**`xelatex: createProcess: find_executable: failed`**
|
||||||
|
XeLaTeX is not installed or not on your PATH. Install MacTeX or BasicTeX and open a new terminal session.
|
||||||
|
|
||||||
|
**`The font "Roboto" cannot be found`**
|
||||||
|
The font is not installed. Follow step 6 above.
|
||||||
|
|
||||||
|
**`File 'titlesec.sty' not found`**
|
||||||
|
A required LaTeX package is missing. Run the `tlmgr install` command in step 4.
|
||||||
|
|
||||||
|
**`No counter 'none' defined`**
|
||||||
|
A known pandoc + longtable bug. The template includes a fix for this — make sure you are using the latest version of `template_first-skyfritt-example.tex`.
|
||||||
|
|
||||||
|
**`fc-list: command not found`**
|
||||||
|
fontconfig is not installed. Run `brew install fontconfig`.
|
||||||
|
|
@ -0,0 +1,160 @@
|
||||||
|
%% Pandoc LaTeX Template
|
||||||
|
%% Usage: pandoc input.md -o output.pdf --template=template_first-skyfritt-example.tex
|
||||||
|
|
||||||
|
\documentclass[12pt, a4paper]{article}
|
||||||
|
|
||||||
|
%% ── Encoding & language ───────────────────────────────────────────────────────
|
||||||
|
\usepackage[T1]{fontenc}
|
||||||
|
\usepackage[utf8]{inputenc}
|
||||||
|
\usepackage[english]{babel}
|
||||||
|
|
||||||
|
%% ── Page geometry ─────────────────────────────────────────────────────────────
|
||||||
|
\usepackage[
|
||||||
|
a4paper,
|
||||||
|
top=2.5cm,
|
||||||
|
bottom=2.5cm,
|
||||||
|
left=2.5cm,
|
||||||
|
right=2.5cm
|
||||||
|
]{geometry}
|
||||||
|
|
||||||
|
%% ── Font: Roboto (requires XeLaTeX or LuaLaTeX) ──────────────────────────────
|
||||||
|
\usepackage{fontspec}
|
||||||
|
\setmainfont{Roboto}[
|
||||||
|
UprightFont = *-Regular,
|
||||||
|
BoldFont = *-Bold,
|
||||||
|
ItalicFont = *-Italic,
|
||||||
|
BoldItalicFont = *-BoldItalic
|
||||||
|
]
|
||||||
|
\setsansfont{Roboto}
|
||||||
|
\setmonofont{Menlo}[Scale=0.9]
|
||||||
|
|
||||||
|
%% ── Colours ───────────────────────────────────────────────────────────────────
|
||||||
|
\usepackage{xcolor}
|
||||||
|
\definecolor{accent}{HTML}{2C3E50}
|
||||||
|
\definecolor{muted}{HTML}{7F8C8D}
|
||||||
|
|
||||||
|
%% ── Hyperlinks ────────────────────────────────────────────────────────────────
|
||||||
|
\usepackage[
|
||||||
|
colorlinks = true,
|
||||||
|
linkcolor = accent,
|
||||||
|
urlcolor = accent,
|
||||||
|
citecolor = accent
|
||||||
|
]{hyperref}
|
||||||
|
|
||||||
|
%% ── Headers & footers ─────────────────────────────────────────────────────────
|
||||||
|
\usepackage{fancyhdr}
|
||||||
|
\pagestyle{fancy}
|
||||||
|
\fancyhf{}
|
||||||
|
\fancyhead[L]{\small\textcolor{muted}{$title$}}
|
||||||
|
\fancyhead[R]{\small\textcolor{muted}{$date$}}
|
||||||
|
\fancyfoot[C]{\small\textcolor{muted}{\thepage}}
|
||||||
|
\renewcommand{\headrulewidth}{0.4pt}
|
||||||
|
\renewcommand{\footrulewidth}{0pt}
|
||||||
|
|
||||||
|
%% ── Section styling ───────────────────────────────────────────────────────────
|
||||||
|
\usepackage{titlesec}
|
||||||
|
\titleformat{\section}
|
||||||
|
{\large\bfseries\color{accent}}{\thesection}{1em}{}[\titlerule]
|
||||||
|
\titleformat{\subsection}
|
||||||
|
{\normalsize\bfseries\color{accent}}{\thesubsection}{1em}{}
|
||||||
|
\titleformat{\subsubsection}
|
||||||
|
{\normalsize\itshape}{\thesubsubsection}{1em}{}
|
||||||
|
|
||||||
|
%% ── Table of contents styling ─────────────────────────────────────────────────
|
||||||
|
\usepackage{tocloft}
|
||||||
|
\renewcommand{\cftsecfont}{\bfseries}
|
||||||
|
\renewcommand{\cftsecpagefont}{\bfseries}
|
||||||
|
\setlength{\cftbeforesecskip}{4pt}
|
||||||
|
|
||||||
|
%% ── Tables ────────────────────────────────────────────────────────────────────
|
||||||
|
\usepackage{booktabs}
|
||||||
|
\usepackage{longtable}
|
||||||
|
\usepackage{array}
|
||||||
|
\usepackage{caption}
|
||||||
|
|
||||||
|
%% Fix pandoc longtable empty-placement bug ("No counter 'none' defined")
|
||||||
|
\makeatletter
|
||||||
|
\newcounter{none}
|
||||||
|
\makeatother
|
||||||
|
|
||||||
|
%% ── Graphics & figures ────────────────────────────────────────────────────────
|
||||||
|
\usepackage{graphicx}
|
||||||
|
\usepackage{float}
|
||||||
|
\makeatletter
|
||||||
|
\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
|
||||||
|
\makeatother
|
||||||
|
\setkeys{Gin}{width=\maxwidth, keepaspectratio}
|
||||||
|
|
||||||
|
%% ── Code listings ─────────────────────────────────────────────────────────────
|
||||||
|
\usepackage{fancyvrb}
|
||||||
|
\usepackage{listings}
|
||||||
|
\lstset{
|
||||||
|
basicstyle = \small\ttfamily,
|
||||||
|
breaklines = true,
|
||||||
|
frame = single,
|
||||||
|
rulecolor = \color{muted},
|
||||||
|
commentstyle = \color{muted},
|
||||||
|
keywordstyle = \color{accent}\bfseries
|
||||||
|
}
|
||||||
|
|
||||||
|
%% ── Pandoc shims ──────────────────────────────────────────────────────────────
|
||||||
|
\providecommand{\tightlist}{%
|
||||||
|
\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
|
||||||
|
|
||||||
|
$if(highlighting-macros)$
|
||||||
|
$highlighting-macros$
|
||||||
|
$endif$
|
||||||
|
|
||||||
|
%% ── Spacing ───────────────────────────────────────────────────────────────────
|
||||||
|
\usepackage{parskip}
|
||||||
|
\setlength{\parskip}{6pt}
|
||||||
|
|
||||||
|
%% ══════════════════════════════════════════════════════════════════════════════
|
||||||
|
%% DOCUMENT
|
||||||
|
%% ══════════════════════════════════════════════════════════════════════════════
|
||||||
|
\begin{document}
|
||||||
|
|
||||||
|
%% ── Title page ────────────────────────────────────────────────────────────────
|
||||||
|
\begin{titlepage}
|
||||||
|
\thispagestyle{empty}
|
||||||
|
\centering
|
||||||
|
\vspace*{4cm}
|
||||||
|
|
||||||
|
{\Huge\bfseries\color{accent} $title$ \par}
|
||||||
|
\vspace{0.5cm}
|
||||||
|
\textcolor{muted}{\rule{0.4\textwidth}{0.4pt}}
|
||||||
|
\vspace{1cm}
|
||||||
|
|
||||||
|
$if(subtitle)$
|
||||||
|
{\large\itshape $subtitle$ \par}
|
||||||
|
\vspace{1cm}
|
||||||
|
$endif$
|
||||||
|
|
||||||
|
$if(author)$
|
||||||
|
{\large $for(author)$$author$$sep$ \\ $endfor$ \par}
|
||||||
|
\vspace{0.5cm}
|
||||||
|
$endif$
|
||||||
|
|
||||||
|
$if(date)$
|
||||||
|
{\normalsize\textcolor{muted}{$date$} \par}
|
||||||
|
$endif$
|
||||||
|
|
||||||
|
\vfill
|
||||||
|
|
||||||
|
$if(description)$
|
||||||
|
\begin{minipage}{0.7\textwidth}
|
||||||
|
\centering\small\textcolor{muted}{$description$}
|
||||||
|
\end{minipage}
|
||||||
|
$endif$
|
||||||
|
|
||||||
|
\end{titlepage}
|
||||||
|
|
||||||
|
%% ── Table of contents ─────────────────────────────────────────────────────────
|
||||||
|
\clearpage
|
||||||
|
\tableofcontents
|
||||||
|
\clearpage
|
||||||
|
|
||||||
|
%% ── Main content ──────────────────────────────────────────────────────────────
|
||||||
|
$body$
|
||||||
|
|
||||||
|
\end{document}
|
||||||
Loading…
Add table
Add a link
Reference in a new issue