sinnbeck / librarian

A minimalist file-based CMS / markdown document indexer created on top of minicli/minicli. No databases, no sessions, no users.

Librarian

Librarian is a stateless CMS based on static files. It uses the same format as DEV.to for markdown files with a front matter and liquid tags for custom functionality. The front matter is fluid and doesn't have a fixed spec, meaning you can include any custom fields you want and fetch them from your templates.

Librarian doesn't use databases, sessions, or users. Administration is made from the command-line. For multiple authors, author information must be defined as metadata within the front matter.

This is an experimental project built to keep content decoupled from the application itself, while keeping a very low footprint and functioning as a middle ground between static sites and dynamic CMSs.

Liquid tags supported at the moment:

Tag	Example	Description
youtube	{% audio path_to_mp3.mp3 %}	embeds mp3 audio
video	{% video path_to_mp4.mp4 %}	embeds mp4 video
tweet_id	{% twitter tweet_id %}	embeds a Tweet
youtube	{% youtube video_ID %}	embeds a YouTube video
github	{% github file_url %}	embeds File from Github (Gists aren't supported at the moment)

Librarian is not a static site generator, and the idea is to provide a mix of static files and dynamic capabilities that don't require sessions or databases.

Documentation

The official documentation is available at https://librarianphp.dev. It is by no means complete, more content will be added as soon as possible. You can contribute to Librarian's documentation via GitHub.

Projects Using Librarian

• sponsoropensource.dev - A list of underrepresented open source creators that can be sponsored via GitHub Sponsors.
• Librarian Documentation - The official Librarian documentation, built with Librarian.