JEKYLL_BUILD(1)

💖 JEKYLL_BUILD — bestie, we're building a website 💖

okay so real talk: this is the JEKYLL_BUILD(1) manual page, and it's about jekyll_build, aka the lil command that takes your raw sources and ✨ assembles them into an actual website ✨. Group chat, let's go.

🌸 NAME 🌸

jekyll_build — build a website from its sources. that's it, that's the whole vibe. your sources go in, a website comes out. slay.

🎀 USAGE 🎀

here's how you call her:

jekyll build [options...]

literally just jekyll build and then whatever options your heart desires. periodt.

✨ OPTIONS ✨

these are the options that control the build command, bestie. read them all, no skimming, i'll know.

• --config CONFIG_FILE[,CONFIG_FILE2,...] — use one or more (custom) configuration files instead of _config.yml, or alongside it, your call. and listen: settings in later files override the earlier definitions, so order matters, iykyk.
• -b, --baseurl URL — serve the website from the base URL you give it. simple as that.
• -I, --incremental — enable incremental rebuilds 🏃♀️ only documents and pages that changed since the last build get generated. and the file .jekyll-metadata is the one keeping receipts — it tracks both file modification times AND inter-document dependencies. she's organized like that.
• -w, --[no-]watch — watch for changes and rebuild the changed sites from source. yes, --watch and --no-watch, both exist, the brackets mean optional. (that's the whole entry, don't @ me.)
• --limit_posts MAX_POSTS — cap the number of posts that get parsed and published. put a whole number where MAX_POSTS goes.
• --future — publish posts or collection documents that have a date in the future. manifesting, but for your blog 🦋
• -D, --drafts — process and render posts sitting in the _drafts folder (defaults to no).
• --unpublished — render posts that are marked as unpublished (defaults to no).
• --force_polling — force watch to use polling. that's the whole description, no notes.
• --lsi — use a Latent Semantic Indexer (LSI) like classifier-reborn for an improved related posts feature. fancy.
• --strict_front_matter — fail the build if there are errors in the front matter. no vibes tolerated, only correctness 💅
• -q, --quiet — silence output. shhh 🤫
• -V, --verbose — print verbose output. the opposite energy, she's chatty.

heads up bestie: for a list of general options, go read the jekyll(1) manual page. this one's only about the build command specifically.

👀 SEE ALSO 👀

go read these too, they're iconic:

• jekyll-serve(1)
• jekyll(1)

💜 AUTHOR 💜

this manual page was written by Daniel Leidert <dleidert@debian.org>, for the Debian GNU/Linux system (but may be used by others). respect the author, always 🫶

and that's a wrap, my love 💖 this page is from Jekyll 3.9, dated 2020-10-30, and it lives in the JEKYLL_BUILD(1) manual. go build something gorgeous, you've got this. mwah 🎀✨