┌─────────────┐    ┌──────────────┐    ┌─────────────┐    ┌──────────────┐
│  Markdown   │───▶│  Asset       │───▶│  Pandoc +   │───▶│  PDF Output  │
│  Chapters   │    │  Processing  │    │  LuaLaTeX   │    │  (Print/Web) │
└─────────────┘    └──────────────┘    └─────────────┘    └──────────────┘
       │                  │                   │
       ▼                  ▼                   ▼
   - Recipe MD        - SVG→PNG           - YAML config
   - TOC structure    - Emoji embed       - Header/footer
   - Front matter     - Cover convert     - Page layout

book/
├── 00a-cover.md             # Custom cover (LaTeX)
├── 00b-dedication.md        # Dedication page
├── 00c-introduction.md      # Author introduction
├── 00d-meet-author.md       # About the author/transparency
├── 00e-readers-guide.md     # How to use, legend, family notes
├── cover.svg                # SVG cover design
├── chapters/
│   ├── 01-appetizers/
│   │   └── README.md        # Chapter content
│   └── .../
├── appendices/
│   └── appendix-a-*/
└── assets/
    ├── banners/             # Chapter SVG banners
    │   └── png/             # Converted PNGs (generated)
    ├── emojis/              # Twemoji PNG files
    │   └── emoji-map.json   # Emoji → filename mapping
    └── images/              # Recipe photos

build/
├── build-pdf.ps1            # Main build script
├── cookbook.yaml            # Print config (twoside)
├── cookbook-digital.yaml    # Digital config (oneside)
├── convert-svgs.js          # Banner conversion
├── convert-cover.js         # Cover conversion
├── emoji-map.json           # Build-time emoji map
└── extract-emojis.js        # Scan for missing emojis

// 1. Download Twemoji PNGs from CDN
const TWEMOJI_CDN = 'https://cdn.jsdelivr.net/gh/twitter/twemoji@14.0.2/assets/72x72/';

// 2. Create emoji → filename map
{
    "🍳": "1f373.png",      // Simple emoji
    "👨‍🍳": "1f468-200d-1f373.png",  // ZWJ sequence
    "🧔‍♂️": "1f9d4-200d-2642-fe0f.png"  // Gender variant
}

// 3. Replace <text> with embedded <image>
function replaceEmojisInSvg(svg) {
    // <text x="25" y="45" font-size="28">🥣</text>
    // becomes:
    // <image x="25" y="17" width="28" height="28"
    //        href="data:image/png;base64,..."/>
}

// Get codepoint for emoji
const codepoint = '🍳'.codePointAt(0).toString(16); // "1f373"

// ZWJ sequences (multiple codepoints joined by 200d)
const zwj = [...'👨‍🍳'].map(c => c.codePointAt(0).toString(16)).join('-');
// "1f468-200d-1f373"

{
    "sharp": "^0.33.5"  // High-performance image processing
}

const sharp = require('sharp');

async function convertSvgToPng(svgPath, pngPath) {
    let svg = fs.readFileSync(svgPath, 'utf8');

    // 1. Embed relative image paths as base64
    svg = embedImagePaths(svg);

    // 2. Replace emoji text with base64 PNG images
    svg = replaceEmojisInSvg(svg);

    // 3. Convert with Sharp at high DPI
    await sharp(Buffer.from(svg), { density: 300 })
        .png({ quality: 100, compressionLevel: 6 })
        .toFile(pngPath);
}

// Convert relative paths to embedded base64
function embedImagePaths(svg) {
    // href="./assets/emojis/1f373.png"
    // becomes:
    // href="data:image/png;base64,iVBORw0KGgo..."

    return svg.replace(
        /<image([^>]*)href="\.\/([^"]+)"([^>]*)\/>/g,
        (match, before, relPath, after) => {
            const data = fs.readFileSync(absPath);
            const base64 = data.toString('base64');
            return `<image${before}href="data:image/png;base64,${base64}"${after}/>`;
        }
    );
}

documentclass: book
classoption:
  - twoside      # Print: alternating margins
  - openright    # Print: chapters start on right page
  # OR
  - oneside      # Digital: no blank pages

papersize: letter
geometry:
  - margin=1in
  - top=1.25in
  - bottom=1.25in
fontsize: 11pt

# Custom fonts (LuaLaTeX)
header-includes:
  - |
    \usepackage{fontspec}
    \setmainfont{Segoe UI}
    \setsansfont{Segoe UI}
    \setmonofont{Cascadia Code}

\usepackage{fancyhdr}
\pagestyle{fancy}
\fancyhf{}
\fancyhead[LE,RO]{\thepage}           % Page number outside
\fancyhead[RE]{\textit{Book Title}}    % Even pages: title
\fancyhead[LO]{\textit{\leftmark}}     % Odd pages: chapter
\fancyfoot[C]{\small Tagline}

% In combined markdown, before content:
\thispagestyle{empty}
\begin{center}
\includegraphics[width=\textwidth]{path/to/cover.png}
\end{center}
\newpage
\pagenumbering{roman}
\tableofcontents
\newpage
\pagenumbering{arabic}

# build-pdf.ps1
$ErrorActionPreference = "Stop"

# 1. Convert SVG assets to PNG
node build/convert-svgs.js
node build/convert-cover.js

# 2. Combine markdown files
$chapters | ForEach-Object {
    $content = Get-Content $_ -Raw
    # Process: banner paths, emoji, HTML→MD
}

# 3. Build both versions
function Build-CookbookPdf {
    param($ConfigFile, $OutputPdf, $Label)

    pandoc $CombinedMd `
        --defaults $ConfigFile `
        --pdf-engine=lualatex `
        --output $OutputPdf
}

Build-CookbookPdf -ConfigFile "cookbook.yaml" -OutputPdf "Print.pdf"
Build-CookbookPdf -ConfigFile "cookbook-digital.yaml" -OutputPdf "Digital.pdf"

# Move banner AFTER heading to prevent page break separation
# Before: <img banner> \n # Chapter
# After:  # Chapter \n <img banner>

$Content = $Content -replace `
    '(<img[^>]*banner[^>]*>)\s*\n(#\s+[^\n]+)', `
    '$2`n$1'

# Convert SVG references to PNG
$Content = $Content -replace `
    'src="\.\.(/assets/banners/)([^"]+)\.svg"', `
    'src="../$1png/$2.png"'

# Convert <br> to line breaks
$Content = $Content -replace '<br\s*/?>', '  '

# Convert details/summary to markdown
$Content = $Content -replace '<details[^>]*>', ''
$Content = $Content -replace '<summary>(.*?)</summary>', '**$1**'

# Check for missing emojis
node build/extract-emojis.js

# Test single SVG conversion
node -e "require('./build/convert-svgs.js')"

# Verbose Pandoc output
pandoc ... --verbose 2>&1 | Select-String "error|warning"

# In cookbook.yaml
header-includes:
  - |
    \usepackage{setspace}
    \setstretch{1.2}  % Body text line spacing
    \renewcommand{\arraystretch}{1.15}  % Table row spacing

header-includes:
  - |
    \usepackage{needspace}
    % Before sections requiring space:
    % \needspace{5\baselineskip}
```yaml
header-includes:
  - |
    \usepackage{needspace}
    % Before sections requiring space:
    % \needspace{5\baselineskip}

```{=latex}
\newpage
```

# Match ALL front matter files for unnumbered headings
if ($Chapter -match 'book\\00(a[ab]?|[b-e])-') {
    $Content = $Content -replace '^(#{1,4} [^\r\n{]+)(\r?\n)', '$1 {.unnumbered}$2'
}

# Switch to appendix mode for back matter
if ($Chapter -match 'book\\16-') {
    $CombinedContent += "`n`n\appendix`n`n"
}