Merge pull request #40 from trustedsec/2025-Update

2025 update

Author: darkoperator

Build/COVER_PAGE_FEATURE.md

@@ -1,10 +1,18 @@
-%% Adds pagebreak between chapters
-% from comments of accepted answer
-% https://superuser.com/questions/601469/getting-chapters-to-start-on-a-new-page-in-a-pandoc-generated-pdf
+%% Chapter/Section Styling
+%% Customize appearance of level 1 headings (sections in Pandoc = # in markdown)
+
 \usepackage{sectsty}
-\sectionfont{\clearpage}
 
-% accepted answer gave error
-%\usepackage{titlesec}
-%\newcommand{\sectionbreak}{\clearpage}
+% Level 1 headings: centered, larger, bold, with spacing but NO page break
+\sectionfont{\centering\LARGE\bfseries}
+
+% Add some vertical space before and after level 1 headings
+\usepackage{titlesec}
+\titlespacing*{\section}
+  {0pt}        % left margin
+  {3ex plus 1ex minus .2ex}  % space before (vertical)
+  {2ex plus .2ex}             % space after (vertical)
 
+% Optional: Keep subsections and subsubsections left-aligned
+\subsectionfont{\large\bfseries}
+\subsubsectionfont{\normalsize\bfseries}

Build/Sysmon.md

@@ -29,16 +29,20 @@ SCRIPT=$(readlink -f "$0")
 SCRIPTPATH=$(dirname "$SCRIPT")
 echo "Running Pandoc to generate the LaTeX file..."
 pandoc "$1" \
-    -f gfm \
+    -f markdown \
     --toc \
+    --toc-depth=3 \
     --listings \
     --include-in-header ${SCRIPTPATH}/chapter_break.tex \
     --include-in-header ${SCRIPTPATH}/inline_code.tex \
     --include-in-header ${SCRIPTPATH}/bullet_style.tex \
     --include-in-header ${SCRIPTPATH}/pdf_properties.tex \
     --include-in-header ${SCRIPTPATH}/listings-setup.tex \
+    --include-in-header ${SCRIPTPATH}/toc-styling.tex \
+    --include-in-header ${SCRIPTPATH}/title_page.tex \
+    --include-in-header ${SCRIPTPATH}/toc_pagebreak.tex \
     --highlight-style ${SCRIPTPATH}/pygments.theme \
-    -V toc-title='Table of contents' \
+    -V toc-title='Sysmon Guide Contents' \
     -V linkcolor:blue \
     -V geometry:a4paper \
     -V geometry:margin=2cm \
@@ -59,6 +63,24 @@ xelatex -interaction=nonstopmode ${fn}.tex > pdfgen.log 2>&1
 echo "Generating PDF (second pass for TOC)..."
 xelatex -interaction=nonstopmode ${fn}.tex >> pdfgen.log 2>&1
 
+# Replace first page with custom cover if cover image exists
+COVER_IMAGE="${SCRIPTPATH}/../chapters/media/TS_SysmonCommunityGuide_Cover.png"
+if [ -f "$COVER_IMAGE" ]; then
+    echo "Replacing first page with custom cover..."
+    TEMP_PDF="${fn}_temp.pdf"
+    mv "${fn}.pdf" "$TEMP_PDF"
+
+    if python3 "${SCRIPTPATH}/replace_cover.py" "$TEMP_PDF" "$COVER_IMAGE" "${fn}.pdf"; then
+        echo "Cover page replaced successfully"
+        rm "$TEMP_PDF"
+    else
+        echo "Warning: Failed to replace cover page, using original PDF"
+        mv "$TEMP_PDF" "${fn}.pdf"
+    fi
+else
+    echo "Warning: Cover image not found at $COVER_IMAGE, skipping cover replacement"
+fi
+
 echo "Cleaning temp files..."
 rm /tmp/temp.tex "$fn".{tex,toc,aux,log}