LANDSLIDE(1)

🎀 LANDSLIDE(1) 🎀

okay bestie, welcome to the darkslide manual page — it's a User Commands situation, section 1, and honestly? she's iconic. let's get into it 💅

✨ NAME ✨

darkslide — html5 slideshow generator 🦋

like, she makes slideshows. html5 ones. that's the whole vibe.

🌸 SYNOPSIS 🌸

darkslide [options] input.md ...

you just hand her some input files and some options and she goes off. that's it, that's the whole thing ✨

💖 DESCRIPTION 💖

So Darkslide is a tool that generates an HTML5 slideshow using lightweight markup as input. no cap. you write in plain-ish text, she serves you a whole presentation. it's giving main character energy.

you can write your slide contents easily using these syntaxes:

• Markdown
• ReStructuredText
• Textile

and like, that's not even all of it — this tool supports CSS/JS theming, can embed images with Base64 (for a standalone document, iykyk), and has fancy transitions. obsessed honestly.

a sample presentation is available here: http://ionelmc.github.io/python-darkslide/ — go look, it's cute 🎀

✨ OPTIONS ✨

every single flag, bestie. no skipping. periodt.

• -h, --help — show the help message and exit. your girl is helpful like that 🫶
• -b, --debug — print exception traces to stderr. for when things are lowkey going wrong and you need the receipts 💀
• -d FILE, --destination=FILE — the path to the to the destination file: .html or .pdf extensions allowed (default: presentation.html). yes the original says "the to the" twice, we're preserving the lore 🙈
• -e ENCODING, --encoding=ENCODING — encoding of the input files (defaults to UTF-8). keep it UTF-8 unless you have a reason, bestie 💜
• -i, --embed — embed stylesheet and javascript contents, plus base64-encoded images, in the presentation to make a standalone document. one file, all vibes, zero missing assets ✨
• -l LINENOS, --linenos=LINENOS — how to output linenos in source code. three options are available: no (no line numbers); inline (inside <pre> tag); table (lines numbers in another cell, copy-paste friendly). choose your fighter 👑
• -m LEVEL, --max-toc-level=LEVEL — limit the TOC level generation to a specific level. keep that table of contents from doing the absolute most 🌸
• -M MOD, --mod=MOD — specify a theme modifier by name. available: wide16x9. widescreen girlies rise 🌈
• -o, --direct-output — print the generated HTML code to stdout. pipe it wherever your heart desires 💅
• -P, --no-presenter-notes — don't include presenter notes in the output. the notes stay between you and your source file 🤫
• -q, --quiet — don't write anything to stdout (silent mode). not a single peep 🤐
• -r, --relative — make your presentation asset links relative to current pwd; this may be useful if you intend to publish your html presentation online. so useful fr fr 🦋
• -t THEME, --theme=THEME — a theme name, or path to a darkslide theme directory. dress her up, she deserves it 🎀
• -v, --verbose — write informational messages to stdout (enabled by default). she's chatty by default and honestly? love that for her 💖
• -w, --watch — watch the source directory for changes and auto-regenerate the presentation. live reload energy, chef's kiss 🔥
• -x EXTENSIONS, --extensions=EXTENSIONS — comma-separated list of extensions for Markdown. stack 'em up ⭐

💜 AUTHOR 💜

Damien Raude-Morvan <drazzib@debian.org> — the icon, the legend, the author 👑

okay so real talk: this is Darkslide, dated March 2011, and you just read the LANDSLIDE(1) page. slay, go make a slideshow, bestie 💅✨🌸