BLOGC(1)

💖 NAME 💖

blogc — literally a blog compiler, bestie. that's the whole vibe. 🫶

---

✨ SYNOPSIS ✨

blogc [-d] [-D KEY=VALUE ...] -t TEMPLATE [-o OUTPUT] SOURCE
blogc -l [-e SOURCE] [-d] [-D KEY=VALUE ...] -t TEMPLATE [-o OUTPUT]
[SOURCE ...]
blogc -l [-e SOURCE] [-d] [-D KEY=VALUE ...] -t TEMPLATE [-o OUTPUT]
[SOURCE ...]
blogc -l [-e SOURCE] -p KEY [-d] [-D KEY=VALUE ...] [SOURCE ...]
blogc -i [-d] [-D KEY=VALUE ...] -t TEMPLATE [-o OUTPUT] < FILE_LIST
blogc -i -l [-e SOURCE] [-d] [-D KEY=VALUE ...] -t TEMPLATE [-o OUTPUT]
< FILE_LIST
blogc -i -l [-e SOURCE] -p KEY [-d] [-D KEY=VALUE ...] < FILE_LIST
echo -e "SOURCE\n..." | blogc -i [-d] [-D KEY=VALUE ...] -t TEMPLATE [-o
OUTPUT]
echo -e "SOURCE\n..." | blogc -i -l [-e SOURCE] [-d] [-D KEY=VALUE ...]
-t TEMPLATE [-o OUTPUT]
echo -e "SOURCE\n..." | blogc -i -l [-e SOURCE] -p KEY [-d] [-D
KEY=VALUE ...]
blogc [-h|-v]

okay so that's a LOT of shapes this command can take, and honestly? iconic of it. 😌

---

🌸 DESCRIPTION 🌸

So blogc compiles source files and templates into blog/website resources. It grabs one (or more) source files plus a template, and generates an output file, based on the template and the content read from the source file(s). It was designed to be used with make(1). ✨

blogc works on two modes:

• entry — the default mode, first example in SYNOPSIS. Accepts only one source file, and processes it as a single entry of the blog/website, like a static page or a post. 💅
• listing — listing mode, second example in SYNOPSIS, activated when calling blogc with the -l option. Accepts multiple source files, and allows users to iterate over the content of all the source files to produce listing pages, like indexes and feeds. By providing another source file to blogc with the -e option — third example in SYNOPSIS — its content will be available for usage during listing, similar to the default entry mode. This is useful for users that want to have an index page with content and posts listing together. See blogc-template(7) for details. 🦋

---

🎀 OPTIONS 🎀

• -d — Activates debug. 🐛 (not me debugging, never me debugging, okay maybe sometimes me debugging)
• -i — Reads list of source files from standard input. Content of standard input is parsed as a file where each line is a file path. Empty lines and lines starting with # are ignored. If some source files are provided to command line while using this option, they will be parsed before the files read from standard input. 💌
• -l — Activates listing mode, allowing user to provide multiple source files. See blogc-source(7) for details. 📚
• -e SOURCE — When used together with -l the source file will be parsed and its content will be made available for usage in the templates in listing mode via listing_entry blocks. This option can be used more than once, so users can have more than one listing_entry block in the same template. Passing an empty string will skip the listing_entry block. See blogc-template(7) for details. 🔁
• -D KEY=VALUE — Set global configuration parameter. KEY must be an ascii uppercase string, with only letters, numbers (after the first letter) and underscores (after the first letter). These parameters are available anywhere in templates, but may be overridden by local configuration parameters set in source files. See blogc-template(7) for details. 🗝️
• -p KEY — Show the value of a variable right after the source parsing and exits. This is useful to get parameters for your Makefile, like the last page when implementing pagination, see blogc-pagination(7) for details. This option can also dump variables defined in a source file, if called without -l. 👀
• -t TEMPLATE — Template file. It is a required option, if blogc needs to render something. See blogc-template(7) for details. 📄
• -o OUTPUT — Output file. If provided this option, save the compiled output to the given file. Otherwise, the compiled output is sent to stdout. 📤
• -v — Show program name, version and exit. 🏷️
• -h — Show help message and exit. 🆘

---

🌈 FILES 🌈

The blogc command expects a template file blogc-template(7), one (or more) source files blogc-source(7) and an output file, if wanted. Templates and source files must have valid UTF-8 content. no exceptions bestie, UTF-8 or nothing 💜

---

🧚 ENVIRONMENT 🧚

No environment variables are required by blogc, but global timezone will be used by locale-dependant datetime input field descriptors (like %c), and can be overridden using environment variables. See strftime(3). 🌍

---

🔥 EXAMPLES 🔥

Build index from source files:

$ blogc -l -t template.tmpl -o index.html source1.txt source2.txt source3.txt

Build index from source files, with additional content from index.txt:

$ blogc -l -e index.txt -t template.tmpl -o index.html source1.txt source2.txt source3.txt

Build entry page from source file:

$ blogc -t template.tmpl -o entry.html entry.txt

ate. no crumbs. 🍓

---

💀 BUGS 💀

blogc is based in handwritten parsers, that even being well tested, may be subject of parsing bugs. Please report any issues to: https://github.com/blogc/blogc

not me personally attacking the parsers, i would never, they're doing their best, but fr fr if something breaks, tell the devs 🙈

---

👑 AUTHOR 👑

Rafael G. Martins <rafael@rafaelmartins.eng.br> — the main character, honestly 💅

---

🌟 SEE ALSO 🌟

blogc-source(7), blogc-template(7), blogc-pagination(7) make(1), strftime(3)

---

and that's the whole page, bestie!! this one's from the blogc Manual, written by Rafael G. Martins, dated January 2025. go build something gorgeous with it, you got this 💖✨🎀