Splitting document into sections (guide)

[scmanjarrez]

Hello! I recently discovered this repository and was amazed by the quality of the report. I wanted to thank you for all the hard work that went into creating it!

After creating some mock-up reports for OSCP A/B/C, I found myself overwhelmed by how large the final report could get. This led me to look for a way to split the document into multiple sections, similar to a LaTeX document.

While researching, I discovered this Lua filter, which allowed me to do just that. I tested the filter alongside your template, and it worked perfectly! So, I wanted to share this quick guide with anyone interested in organizing their report across multiple documents.

Here’s how to get started:

• Download this file to your working directory.
• Then, add --lua-filter=include-files.lua to the Pandoc command line, like so:

  pandoc OSCP-exam-report-template_whoisflynn_v3.2.md -o OSCP-OS-XXXXXX-Exam-Report.pdf --lua-filter=include-files.lua --from markdown+yaml_metadata_block+raw_html --template eisvogel --table-of-contents --toc-depth 6 --number-sections --top-level-division=chapter --highlight-style breezedark --resource-path=.:src

To include a section in the report, simply add this snippet in the desired location:

``` {.include}
path_to_file.md