Command line tool to author and manage a semi-ephemeral™ blog with a gemini archive.
-=> https://git.r.bdr.sh/rbdr/blog view source @ git.r.bdr.sh
-=> https://git.sr.ht/~rbdr/blog source mirror @ sourcehut
+=> https://git.r.bdr.sh/rbdr/blog ⧇ source
+=> https://git.sr.ht/~rbdr/blog ⧉ mirror
## Install
% brew install rbdr/apps/blog
```
+### Prebuilt Packages
+You can find pre-built packages for linux @ build.r.bdr.sh. There you can
+find a `.tar.gz` that includes only the binary, or `.rpm` and `.deb`
+distributions for fedora and debian that include a manpage.
+
+Binaries are provided for x86_64 and aarch64.
+
+Unstable releases are built directly from the main branch, while tagged
+versions have their own release and can be considered more stable.
+
+=> gemini://build.r.bdr.sh/blog blog pre-built releases @ gemini
+=> https://build.r.bdr.sh/blog blog pre-built releases @ https
+
### From Source
Make sure you have rust and Make installed. Clone the repository, and run:
blog generate
```
-## Usage II: Publishing
+## II: Publishing
Publishing the blog and archive requires `rsync`.
This will include *all the posts* in gemtext format.
-## Usage III: Source Control
+## III: Source Control
Blog supports saving snapshots of the blog in git, and you can add and remove remotes with the following commands:
**IF YOU CHANGE ANY FILES MANUALLY, REMEMBER TO SYNC UP, OTHERWISE YOUR CHANGES WILL BE LOST**
-## Usage IV: Customizing
+## IV: Customizing
The default templates included in blog are very generic and likely not helpful for your use case. However, you can customize this freely:
Any files inside the `static` directory of your blog data root (`$XDG_DATA_HOME/blog`) will be copied as is. This is useful for any images, javascript files or stylesheets that you use in your posts or templates.
-## Usage V: Where is Data Stored?
+## V: Where is Data Stored?
Blog uses three diretories to store data, all of them using the XDG User
Directories.
All of these can be overridden by environment variables.
-## Usage VI: Configuration
+## VI: Configuration
You can control the number of posts in the ephemeral blog, and the location of
all the data by using environment variables.
## Changelog
+* 7.0.0 Rewritten in rust, supports gopher (geomyidae format).
* 6.0.0 Use custom templates, use XDG directories.
=> ./blog_6.0.0.gmi Deprecated documentation for blog 6.0.0