PulseExploreJournal ClubDebatesTrendingResearchersJournals
Instagram
HomeExploreJournal ClubTrending
Synapse
⌘+K
Synapse
May 14, 20260 citationsOpen Access

Pandoc Pipeline Configurations for Vietnamese Educational Publishing: PDF, EPUB, HTML

View Full Paper
TLThat LeElSohly Laboratories (United States)

Key Points

  • The aim is to establish a streamlined pipeline for producing multiple educational document formats from a single Markdown source.
  • Developed three output configurations: PDF via XeLaTeX, EPUB3 per W3C standards, and standalone HTML5.
  • Ensured fidelity of Vietnamese diacritics and support for various citation styles.
  • Included a Microsoft Word .docx version for teacher review generated from the same source.
  • Successfully generated three different document formats from a single Markdown source.
  • Ensured all formats maintain Vietnamese diacritic integrity at the codepoint level.
  • Configured each pipeline to comply with required academic and technical standards.

Abstract

The Document Engineering Vol 2 textbook (Markdown for Educational Writing, audience 14+, Vietnameselanguage) requires a publication pipeline that lets a single Markdown source produce three deliverables — a print-quality PDF, an EPUB3 ebook, and a standalone HTML page — without the author re-editing the source per output. The pipeline must preserve Vietnamese diacritics across the three outputs at the codepoint level, support four citation styles in common use (APA 7, IEEE, Vancouver, and a Vietnameseacademic style modelled on TCVN 7217-1 / ISO 690 as adopted by the VNU Journal of Science author guidelines), produce a Microsoft Word .docx for teacher review as an auxiliary output, and remain reproducible across operating systems. This paper specifies that pipeline anchored on Pandoc 1, 2. Three first-edition configurations are defined: PDF via XeLaTeX with polyglossia + fontspec 3, 4 and TeX Gyre / Noto fonts for Vietnamese coverage 5; EPUB3 conforming to the W3C 2023 Recommendation 6 with embedded XHTML and embedded fonts; and a self-contained HTML5 file using the WHATWG HTML Living Standard 7. Each pipeline is presented with its Pandoc command line, required filters and templates, CSL style selection rule 8, 9, Vietnamese diacritic fidelity test, imagehandling rule, font-fallback chain, and YAML metadata block. The Word docx output is treated as a fourth derivative produced by the same source — not a first-edition pipeline but a teacherreview affordance produced by a one-flag variation of the PDF pipeline. An auxiliary companion-template directory layout is specified for the Vol 2 advanced chapters, locating the shared YAML metadata, CSL files, LaTeX preamble, EPUB CSS, and HTML CSS in a single tree. The first edition deliberately ships three outputs; an expansion roadmap (Beamer slides, reveal.js / Slidev presentations, ODT, JATS XML, plain LaTeX-source distribution) is sketched in section 5.4. The paper-grade target is rigor at audit standard, not venue submission.

Ask AI
Helpful
Bookmark
Share
View Full Paper

Cite This Study

That Le (2026) studied this question.

synapsesocial.com/papers/6a05680ea550a87e60a2062ehttps://doi.org/10.5281/zenodo.20131585
Ask AI
Helpful
Bookmark
Share
View Full Paper