Central repository for Range42 project presentations, slides, and talk materials.
This repository contains presentation materials for Range42, an open cyber range platform developed by NC3 (National Cybersecurity Competence Center) at the Luxembourg House of Cybersecurity. All presentations are built using LaTeX Beamer with the Metropolis theme.
range42-presentation/
├── general-oscl2025.tex # Main presentation: Range42 Status Update
├── images/
│ ├── contribute.png # QR code for GitHub contributions
│ ├── work-with-us-qrcode.png # QR code for job applications
│ ├── logos/
│ │ └── FSFE_Public_Money_Public_Code_logo.pdf
│ └── diagrams/
│ └── architecture.png # Range42 architecture diagram
├── pdf_slides/
│ └── LHC_NC3.pdf # NC3/LHC branding slides
└── README.md
File: general-oscl2025.tex
Duration: 20 minutes
Audience: Open source community, cybersecurity educators, researchers
Topics:
- Range42 platform overview and current achievements
- Architecture and repository structure
- Development tracks and collaboration opportunities
- How to contribute to the project
Compile:
xelatex general-oscl2025.tex- TeX Distribution: TeX Live 2020+ or MacTeX 2020+
- Compiler: XeLaTeX (required for custom fonts)
- OS: Linux, macOS, or Windows with WSL
Install via tlmgr:
# OSCL Tex dependencies
sudo tlmgr install beamertheme-metropolis fira pgfopts fira plex tcolorbox tikzfill pdfcol fontawesome5 fontspec
# CyCon template needs the following
sudo tlmgr install titlesec enumitem titling preprintThe presentations use these fonts (must be installed system-wide):
- IBM Plex Sans - Primary sans-serif font
- IBM Plex Mono - Monospace font for code
- Fira Sans - Alternative sans-serif
- Fira Mono - Alternative Monospace font
Installation:
- macOS:
brew install --cask font-ibm-plex font-fira-sans - Linux (Ubuntu/Debian):
sudo apt install fonts-firacode fonts-ibm-plex
- Manual: Download from IBM Plex and Fira
git clone https://github.com/range42/range42-presentation.git
cd range42-presentationCheck if XeLaTeX is available:
xelatex --versionCheck if required fonts are installed:
fc-list | grep -i "IBM Plex"
fc-list | grep -i "Fira"# Compile the main presentation
xelatex general-oscl2025.tex
# If you need speaker notes or bibliography, run multiple times:
xelatex general-oscl2025.tex
xelatex general-oscl2025.texOutput: general-oscl2025.pdf
# macOS
open general-oscl2025.pdf
# Linux
xdg-open general-oscl2025.pdf
# Windows WSL
explorer.exe general-oscl2025.pdfToggle speaker notes by uncommenting one line in the .tex file:
% Show slides only (default)
% \setbeameroption{hide notes}
% Show notes on second screen (for presenting)
% \setbeameroption{show notes}
% Show only notes (for rehearsal)
% \setbeameroption{show only notes}The cyber-themed color palette is defined in each .tex file:
\definecolor{cyber-bg}{HTML}{0B0F14} % Dark background
\definecolor{cyber-ink}{HTML}{E6EEF5} % Light text
\definecolor{cyber-accent}{HTML}{217EAA} % Blue accent
\definecolor{cyber-mid}{HTML}{7D9CB7} % Secondary
\definecolor{cyber-soft}{HTML}{8CA4AC} % TertiaryModify these values to change the theme.
Presentations require these image files:
| File | Purpose | Format | Source |
|---|---|---|---|
images/contribute.png |
GitHub contribution QR code | PNG | Generate from https://github.com/range42 |
images/work-with-us-qrcode.png |
Recruitment QR code | PNG | NC3 careers page |
images/logos/FSFE_Public_Money_Public_Code_logo.pdf |
PMPC logo | PDF/Vector | FSFE Website |
images/diagrams/architecture.png |
Range42 architecture | PNG | Internal docs |
pdf_slides/LHC_NC3.pdf |
NC3/LHC branding | NC3 templates |
Missing images? The compilation will fail with clear error messages indicating which files are missing.
Problem: XeLaTeX can't find IBM Plex or Fira fonts.
Solution:
- Verify fonts are installed:
fc-list | grep "IBM Plex" - Rebuild font cache:
fc-cache -fv - Restart your terminal/IDE
Problem: Missing image files in images/ or pdf_slides/.
Solution:
- Check the file paths in the error message
- Ensure all required images are present (see table above)
- Verify file permissions:
ls -la images/
Problem: XeLaTeX gets stuck or produces cryptic errors.
Solution:
- Delete auxiliary files:
rm *.aux *.log *.nav *.out *.snm *.toc - Try compiling again
- Check for syntax errors in any recent
.texchanges
Problem: TeX Live packages conflict or are outdated.
Solution:
sudo tlmgr update --self
sudo tlmgr update --all- Create a new
.texfile (e.g.,workshop-2025.tex) - Copy the preamble from
general-oscl2025.tex - Update title, subtitle, date, and content
- Add entry to this README under "Presentations"
- Commit and push
- Edit the
.texfile - Test compilation locally:
xelatex <filename>.tex - Review generated PDF
- Commit changes with descriptive message
- Update README if structure/content changes significantly
- Logos: Use vector formats (PDF, SVG) when possible
- Diagrams: Export at 300 DPI minimum for clarity
- QR Codes: Generate at 1000x1000px minimum
- File size: Keep images under 2MB each for repository performance
- Commit compiled PDFs only for releases/archives
- Keep
.gitignoreupdated to exclude LaTeX auxiliary files - Tag presentation versions:
git tag v1.0-oscl2025
- Rehearse with notes: Compile with
\setbeameroption{show notes} - Check timing: Aim for 1-2 minutes per slide
- Test on presentation display: Colors may differ on projectors
- Backup PDF: Always have a compiled PDF as fallback
- Use descriptive commit messages: "Add development tracks slide to OSCL presentation"
- Create branches for major revisions:
git checkout -b oscl2025-revision - Review changes before presenting:
git diff HEAD~1 <file>.tex
Presentations and materials are released under TLP:CLEAR (Traffic Light Protocol: CLEAR) - Information may be shared freely without restriction.
Individual code examples or technical content may be subject to different licenses as noted in the Range42 project repositories.
Project Lead: [email protected]
GitHub: https://github.com/range42
Organization: National Cybersecurity Competence Center (NC3)