Erick Ruiz de Chavez

New Capsule Generator: 💎 Stargem

Published: 2025-01-12

For the last couple of days, I've been working on polishing and improving a collection of Python 🐍 scripts I've been using to publish my site. After getting all the basics working as I wanted, it was time to refactor them into a proper command-line tool with subcommands, flags, and more. The result is 💎 Stargem, a “Static Capsule Generator.” While I still need to polish a few details and document it properly, it's more than ready for personal use. I am planning on publishing to PyPi once I get it properly documented and the code is in a better shape.

Stargem borrows some ideas from tools like Jekyll and Hugo (I think). It supports a handful of commands for tasks I frequently perform: new, draft, publish, unpublish, and build.

new: Generates a new Capsule with all the expected folders, files, and a few examples.
draft: Creates a new draft in the drafts folder. I can set the title as a command-line argument or, if missing, as an interactive prompt.
publish: Publishes a draft into the posts folder. This uses the current date and time to rename the file and includes it in the front matter.
unpublish: Moves a post back to the drafts folder and removes the published date from both the file name and the front matter.
build: Generates the site into a dist folder.

If you're curious about the site structure, you can check out this site's repo at:

=> https://code.palmiers.xyz/erick/erick.is

If you'd like to follow my progress on Stargem (still under development), you can visit:

=> https://code.palmiers.xyz/erick/stargem

As usual, feel free to reach out using any of my contact links. 😉

Erick Ruiz de Chavez

New Capsule Generator: 💎 Stargem

Links