Section 3: Your First Audit | PasswordStore: LaTex installaion issue

[elsecaller0x]

I am having a hard time with pdf generation.

pandoc report.md -o report.pdf --from markdown --template=eisvogel --listings
Error producing PDF.
! Emergency stop.
<*> /tmp/tex2pdf.-6cc736234083ca02/input.tex
                                             
Here is how much of TeX's memory you used:
 14 strings out of 473584
 468 string characters out of 5730880
 1925905 words of memory out of 5000000
 23006 multiletter control sequences out of 15000+600000
 558069 words of font info for 36 fonts, out of 8000000 for 9000
 1141 hyphenation exceptions out of 8191
 12i,0n,13p,72b,8s stack positions out of 10000i,1000n,20000p,200000b,200000s

!  ==> Fatal error occurred, no output PDF file produced!

please help

[EngrPips]

The written lesson has some suggestions on how to fix issues related to pandoc; please check them out.

[mirmohmmadluqman]

Step-by-Step Fix (Best Practices)

1. Install Dependencies
   Ensure full LaTeX for reliability:

   # Linux (Ubuntu)
   sudo apt update && sudo apt install texlive-full pandoc -y
   
   # macOS (Homebrew)
   brew install pandoc && brew install --cask mactex

   Update: sudo tlmgr update --all.

2. Setup Template
   Download Eisvogel:

   mkdir -p ~/.pandoc/templates
   wget https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/master/eisvogel.tex -O ~/.pandoc/templates/eisvogel.tex

   Add YAML to report.md (fixes listings/hyphenation):

   ---
   title: "PasswordStore Audit Report"
   author: "Your Name"
   date: "2025-10-06"
   toc: true
   listings: true
   header-includes:
     - \usepackage{listings}
     - \usepackage{xcolor}
     - \usepackage[english]{babel}  # For hyphenation
   ---

3. Debug & Run
   Generate TeX:

   pandoc report.md -o report.tex --template=eisvogel --listings

   Compile & check log:

   xelatex report.tex  # Produces report.log for errors

   Fix missing packages: sudo tlmgr install <package> (e.g., listings).
   Final command (use xelatex for better error handling):

   pandoc report.md -o report.pdf --template=eisvogel --listings --pdf-engine=xelatex --verbose

   For memory errors, edit /etc/texmf/texmf.cnf: Add main_memory = 8000000, then sudo texhash && sudo mktexlsr.

4. Test Minimal File
   Create test.md:

   ---
   title: Test
   ---
   # Section
   ```solidity
   contract Test {}

   Run the command on it to isolate issues.
   
   

Alternative: Docker (Isolated Env)

# Dockerfile
FROM pandoc/latex:latest
RUN tlmgr update --self && tlmgr install eisvogel listings xcolor babel && mktexlsr
WORKDIR /data
VOLUME ["/data"]

Build: docker build -t pandoc-fix .
Run: docker run --rm -v "$(pwd):/data" pandoc-fix pandoc report.md -o report.pdf --template=eisvogel --listings.

[elsecaller0x]

This is great. This is what chatGPT gave me. Thanks.

[EngrPips]

Interesting.

[mirmohmmadluqman]

If issue is solved, mark it as answered