Adamantium is my personal blog built with Hanami 2.
It's based on the Micropub spec for publishing posts of varying types.
Adamantium takes advantage of Hanami slices to split out the various concerns that go in to managing a blog.
This is where the micropub spec is implemented, and is the main interface for managing the posts you see on the blog.
There are 3 endpoints:
/micropub
— responsible for describing the various micropub attributes supported by the site and for handling all of the CRUD requests that the micropub spec defines./micropub/media
— this is where media files are sent to be uploaded./micropub/webmentions
— handles webmention request.
This slice is a read-only slice* and serves to read and present the data created by interacting with the micropub slice.
The main reason for this being in its own slice is that I imagined wanting to write multiple frontends to the post data one day.
Today, the primary interface is a blog on the web, but I may want a CLI one day and being able to expose a new interface without needing to effect the old one was very appealing to me!
The other reason is that if someone wants to use this code for their own blog, they can throw away the main
slice and build their own on top of their own blog data.
* With the exception of saving the top track of the week on weekly posts. But that really should be moved in to the micropub slice and happen on post creation, rather than the first time a post is viewed.
This slice was largely added to have a GUI for managing some of the bits that a micropub-only interface makes tricky.
The admin
slice lets me:
- Manage tags (delete them, merge them)
- List and manage posts (edit content, edit tags and syndicate to other sources)
- View the media uploaded via the
/media
endpoint - Copy links to media uploaded via the
/media
endpoint - Manage auto-tagging of posts. When a post mentions a word, or has a word in its title, attach a given tag to it
- Manage webmentions on the site
- Manage the
/trips
section on the site. This isn't manageable by micropub just yet as it involves collating a list of existing photos, posts and checkins under the umbrella of a trip
One thing I would like to do is re-work some of the admin area to send requests to the micropub slice, instead of owning the logic of how posts can be managed.
- A boring old blog — write posts, tag posts, syndicate posts to social media
- Apple Music integration to list the last ~12 recently played albums or playlists
- Podcast scrobbling
- Movie tracking from Letterboxd
- Bookmark integration with Raindrop, as well as a weekly reminder of unread bookmarks
- An RSS feed
- Integration with Swarm via OwnYourSwarm
This project is under active development and is light on tests. It was also started when Hanami 2 was still in beta, so contains some code that may not be needed in the current version of Hanami 2 (particularly the persistence and asset management code). I do plan on bringing that in line with what is in the release version of Hanami 2, though.
- Provide a
.env
file that fills in all of the required settings inconfig/settings.rb
- Run
script/setup
- Run
script/server
- Visit
https://localhost:2300
The source code is available under the MIT licence. But you may not copy the design or content of this site.