Swiftpack.co - jsorge/maverick as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
jsorge/maverick
Textbundle powered blog engine.
.package(url: "https://github.com/jsorge/maverick.git", from: "call-ping-method")

Maverick

Welcome to Maverick, a blog engine built to work with textbundles. It's kind of a cross between static sites (in that files are stored on and read from disk), and dynamic sites that have more complicated server logic and need some database running to contain everything.

Why Textbundle?

Typically you'll have your pages landing on your disk separate from the posts that contain them. I wanted to build a system where posts could be truly portable, and allowed maximum flexibility when adding new content to the site. Textbundles are themselves a folder structure that contain an assets folder for images, linked to by the enclosed markdown file inside the bundle. It's really nice.

How Does it Work?

Maverick is built on top of the Vapor framework. Inside of the Public folder are subfolders called _pages and _posts. The pages folder is for static pages (such as https://example.com/about), and the posts folder is for blog posts (such as https://example.com/2018/05/28/introducing-maverick/).

The presentation is done via the Leaf templating syntax. There are 2 templates: index.leaf and post.leaf. The site can be customized by changing those templates, and the styles, scripts, and fonts folders inside of Public.

Future plans include full API support for micropub and XML-RPC. I want Maverick to work exceptionally well with microblogs, and it will support title-less posts. I hope to also make things like publishing from clients such as the Micro.blog app or Ulysses work seamlessly.

Feeds will be generated with full text and truncated variants, in both RSS and JSONFeed. These can be used to send your content anywhere you want on the web.

Should I Use It?

Probably not yet. It's at a very early stage of development, and built to scratch my own itch and migrate from my current Ghost blog. But if it's up your alley feel free to check it out.

The Roadmap

There's a taskpaper file of all the things that need to get done. Check it out here.

GitHub

link
Stars: 11
Last commit: 3 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics