basic-book-builder/chapters/Glossary.md

30 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

\backmatter
# Glossary {-}
| Term | Description |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **AST (Abstract Syntax Tree)** | Pandocs internal structured representation of a document. Lua filters operate on the AST before rendering to a target format. |
| **Bibliography** | A `.bib` file (e.g., Zotero export) used by Pandoc with `citeproc` to generate formatted citations and reference lists. |
| **Callout** | A styled block (e.g., `[!warning]`) transformed by Lua filters into format-specific output such as LaTeX environments or HTML `<div>` elements. |
| **Defaults File (YAML)** | A Pandoc configuration file defining output format, filters, metadata, and rendering options (e.g., `pdf.yaml`, `html.yaml`). |
| **DOCX** | Microsoft Word document format generated by Pandoc; styling is controlled via a `reference.docx` file. |
| **Filter (Lua)** | A script that modifies Pandocs AST before rendering. Used in this workflow for callouts and other structural transformations. |
| **Frontmatter** | Format-specific content inserted before the main body (e.g., `frontmatter.tex`, `frontmatter.html`, `frontmatter-docx.md`). |
| **HTML** | Web output format generated by Pandoc, typically styled via CSS and supporting interactive features. |
| **LaTeX** | Typesetting system used for high-quality PDF generation via XeLaTeX in this workflow. |
| **Lua Filter** | A lightweight scripting extension used by Pandoc to customize document transformations programmatically. |
| **Makefile** | Automation script orchestrating the build pipeline for PDF, HTML, DOCX, ODT, and Markdown outputs. |
| **Markdown** | Plain-text markup language serving as the source format for all outputs in the workflow. |
| **Metadata** | Keyvalue pairs (e.g., `metadata.yaml`) defining title, author, license, version, and other document variables. |
| **ODT** | OpenDocument Text format used by LibreOffice; similar to DOCX but open-standard. |
| **Pandoc** | Universal document converter used to transform Markdown into PDF, HTML, DOCX, ODT, EPUB, and more. |
| **PDF** | Portable Document Format output produced via Pandoc + XeLaTeX. |
| **Reference Document** | A DOCX or ODT file defining styles (fonts, headings, spacing) used when generating Word/LibreOffice outputs. |
| **Resource Path** | Directories Pandoc searches for images, diagrams, and other assets during rendering. |
| **Template** | A format-specific layout file (e.g., LaTeX template) used to control document structure beyond styling. |
| **TOC (Table of Contents)** | Automatically generated navigation structure controlled by `toc` and `toc-depth` options. |
| **XeLaTeX** | LaTeX engine used to generate PDFs with modern font support (via `fontspec`). |
| **Zotero** | Reference manager used to generate `.bib` files for citation processing with Pandoc. |