I'm making this because I need a simple and kind-of-minimal program to serve me as a static site generator with (limited) mixed-CMS+Wiki features. Just the ones I need, of which some are unique, however.
This won't replace any of the big projects out there that do the same thing but, as all of my projects, I'm releasing it as free libre software, in the hope that someone would find it useful.
Also, this software is needed for someone to edit and compile my personal website [sitoctt](https://gitlab.com/octtspacc/sitoctt) from its source. Being that site too released under a libre license that allows modifications, I have to also release the tools I use to build it, or really people will never be able to make the most out of it.
**Everything is still kind of a WIP**, and some bugs might appear across commits, but feel free to experiment with all of this stuff! If you really want to use this tool for your website, I suggest you don't do like I do in my build process, running always with the latest code commit; instead, either download a snapshot of the code and keep that, or always clone from a specific commit, until you have time when I do an update to check if your site actually builds correctly with the new version.
Obviously, it's built with staticoso itself 😁️. Its source repo can be found at [gitlab.com/octtspacc/staticoso-docs](https://gitlab.com/octtspacc/staticoso-docs).
Keep in mind that, currently, it's still very incomplete. **Any help**, from writing the documentation to creating a decent HTML+CSS template for its site, **is more than welcome**.
The recommended way to get staticoso is to choose a commit, (preferably the most recent as of you're reading this) and stick to that for workflows and automatic deployments. You can either fork the repository at a certain point and always clone from yours, clone from a specific commit of this repo, or download an archive of the commit in question (click the GitLab download icon after navigating to a commit, or try `https://gitlab.com/octtspacc/staticoso/-/archive/<FullCommitHash>/staticoso-<FullCommitHash>.tar.bz2`).
Once that's set-up, it will also be possible to download the latest version from the CI/CD, based on if that commit has or has not passed runtime tests.
All of this is because some crucial things might be changed from one commit to another, possibly causing your site build to fail. Always make sure you have some spare minutes at hand for checking that your site actually still builds, whenever you want to update your workflows to the bleeding edge.