PHPackages librarianphp/librarian - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. librarianphp/librarian ActiveLibrary[CLI & Console](/categories/cli) librarianphp/librarian ====================== Librarian CMS 5.2.1(1y ago)1448212[9 issues](https://github.com/librarianphp/librarian/issues)[3 PRs](https://github.com/librarianphp/librarian/pulls)MITCSSPHP >=8.2CI failing Since Feb 28Pushed 6mo ago6 watchersCompare [ Source](https://github.com/librarianphp/librarian)[ Packagist](https://packagist.org/packages/librarianphp/librarian)[ Docs](https://github.com/minicli/librarian)[ GitHub Sponsors](https://github.com/erikaheidi)[ RSS](/packages/librarianphp-librarian/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)Dependencies (10)Versions (37)Used By (0) [![Librarian](https://github.com/librarianphp/librarian/raw/main/art/logo.png)](https://github.com/librarianphp/librarian/raw/main/art/logo.png)Librarian ========= [](#librarian) #### Static site builder and Markdown document indexer inspired by Hugo but written in PHP. [](#static-site-builder-and-markdown-document-indexer-inspired-by-hugo-but-written-in-php) [![Packagist](https://camo.githubusercontent.com/06a2d7d952569009b0d8dacf4a176bf69fe394a9a02b80fb0501aa8411c4ea47/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c696272617269616e7068702f6c696272617269616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/librarianphp/librarian) [![PHP from Packagist](https://camo.githubusercontent.com/5af846cc1418df72548dda7f444653b3d07088a1d346195794c2d681d7b16f13/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6c696272617269616e7068702f6c696272617269616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/librarianphp/librarian) [![GitHub Workflow Status (main)](https://camo.githubusercontent.com/f7c545ca735d0c26dbf7dcc2e70af1280efb710f5ae0d61ed04e7b4bbfd8894f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6c696272617269616e7068702f6c696272617269616e2f7068702e796d6c3f6272616e63683d6d61696e266c6162656c3d5465737473) ](https://github.com/librarianphp/librarian/actions) About ----- [](#about) Librarian is a static site builder and Markdown document indexer inspired by Hugo but written in PHP. 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. ``` --- title: This Is My About Page published: true created_at: 2023-04-01 description: Hey there! I'm Librarian, a small file-based CMS and static site generator created in PHP, on top of Minicli. cover_image: https://picsum.photos/780/300?r=8 --- Hey there! I'm Librarian, a small file-based CMS and static site generator created in PHP, on top of Minicli. I don't use a database, I don't have a control panel, or users. Everything is pulled from static content in my content dir. ... ``` [![Librarian default index page screenshot](https://camo.githubusercontent.com/f40c120fbab183361ccc552c214f11bfb662e8ed2678770665f9a7f74cb4973a/68747470733a2f2f6c696272617269616e7068702e6465762f696d672f6c696272617269616e5f64656661756c745f706167652e706e67)](https://camo.githubusercontent.com/f40c120fbab183361ccc552c214f11bfb662e8ed2678770665f9a7f74cb4973a/68747470733a2f2f6c696272617269616e7068702e6465762f696d672f6c696272617269616e5f64656661756c745f706167652e706e67) 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. Liquid tags supported at the moment: TagExampleDescription`audio``{% audio path_to_mp3.mp3 %}`embeds mp3 audio`video``{% video path_to_mp4.mp4 %}`embeds mp4 video`youtube``{% youtube video_ID %}`embeds a YouTube video`github``{% github file_url %}`embeds File from Github (Gists aren't supported at the moment)Check the [doc page on how to create your own custom liquid tags](https://librarianphp.dev/customizing-librarian/custom-liquid-tags/). Documentation ------------- [](#documentation) The official documentation is available at . You can [contribute to Librarian's documentation via GitHub](https://github.com/librarianphp/docs). Projects Using Librarian ------------------------ [](#projects-using-librarian) - [OnLinux Systems](https://onlinux.systems) - A blog about Linux, with tutorials and hardware reviews. - [sponsoropensource.dev](https://sponsoropensource.dev) - A list of underrepresented open source creators that can be sponsored via GitHub Sponsors. - [Librarian Documentation](https://librarianphp.dev) - The official Librarian documentation, built with Librarian. - Your project! Send a PR :) Contributing ------------ [](#contributing) Check the **[Contributing Guide](CONTRIBUTING.md)**. ### Health Score 49 — FairBetter than 95% of packages Maintenance53 Moderate activity, may be stable Popularity27 Limited adoption so far Community19 Small or concentrated contributor base Maturity81 Battle-tested with a long release history Bus Factor1 Top contributor holds 80.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~83 days Recently: every ~121 days Total 21 Last Release 597d ago Major Versions 0.2.0 → 1.02021-01-08 1.0 → 2.02021-04-20 2.0.6 → v3.0.x-dev2022-03-16 3.0.1 → 4.0.0-rc2023-04-23 4.1.0 → 5.0.02023-06-23 PHP version history (4 changes)1.0PHP >=7.3 v3.0.x-devPHP >=8.0 4.0.0PHP >=8.1 5.2.0PHP >=8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/efad91e92c56f2a771b7dbabb064d25d65392a60751a19666626672bdca575a6?d=identicon)[erikaheidi](/maintainers/erikaheidi) --- Top Contributors [![erikaheidi](https://avatars.githubusercontent.com/u/293241?v=4)](https://github.com/erikaheidi "erikaheidi (113 commits)")[![WendellAdriel](https://avatars.githubusercontent.com/u/11641518?v=4)](https://github.com/WendellAdriel "WendellAdriel (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (10 commits)")[![ramsey](https://avatars.githubusercontent.com/u/42941?v=4)](https://github.com/ramsey "ramsey (3 commits)")[![sinnbeck](https://avatars.githubusercontent.com/u/13980140?v=4)](https://github.com/sinnbeck "sinnbeck (1 commits)")[![tomasnorre](https://avatars.githubusercontent.com/u/1212481?v=4)](https://github.com/tomasnorre "tomasnorre (1 commits)") --- Tags blogbuilderclicmscommand-linedevtomarkdownphpstaticmarkdowncmsblog ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/librarianphp-librarian/health.svg) ``` [![Health](https://phpackages.com/badges/librarianphp-librarian/health.svg)](https://phpackages.com/packages/librarianphp-librarian) ``` ### Alternatives [spress/spress Static site generator with blogs support 37436.2k](/packages/spress-spress)[kzykhys/ciconia The Markdown parser for PHP5.4 35366.7k13](/packages/kzykhys-ciconia)[ostark/craft-plugin-commands Manage Craft plugins from the cli 1951.1k1](/packages/ostark-craft-plugin-commands) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)