The PaperMod theme for Cecil is a clean and minimalist blog theme with a paper texture, inspired by Hugo PaperMod and built with Tailwind CSS v4.
| Light | Dark |
|---|---|
![]() |
![]() |
- Homepage with an introduction, social links and the latest posts
- Posts archive grouped by year and month, with Atom feed
- Post page with date, reading time and tags
- About layout with a profile picture and links
- Tags (taxonomy) pages
- Light and dark color schemes, following the system preference
- Code syntax highlighting
- SEO and social metadata (built-in Cecil
metatagspartial) - Translatable (English and French included)
composer require cecil/theme-papermodOr download the latest archive and uncompress its content in
themes/papermod.
Add papermod in the theme section of your config.yml:
theme:
- papermodWrite your posts in pages/posts/, prefixed by their date (e.g. pages/posts/2026-10-12-my-first-post.md).
The archive and the homepage display all the posts on a single page, so disable pagination in their front matter:
# pages/index.md and pages/posts/index.md
---
pagination: false
---Use the about layout:
---
title: About
layout: about
page_title: About me # optional, title displayed in the page
image: images/about.jpg # optional, profile picture
---Social links (displayed on the homepage and the about page) are defined in data/links.yml:
- title: GitHub
href: https://github.com/<user>
picto: images/svg/github.svg # github, linkedin, feed and contact icons are includedOptions with their default values:
papermod:
posts:
section: posts # section containing the blog posts
home: 5 # number of posts displayed on the homepage
avatar: '' # avatar displayed next to the site title (e.g. images/avatar.jpg)
about:
image: '' # default profile picture of the about page
licence: by-nc-sa # Creative Commons licence of the content (empty to hide)
overlay: true # paper texture overlay
analytics: false # renders partials/analytics.html.twigThe footer displays author.name (or title).
If your posts are in another section than posts (e.g. blog), set papermod.posts.section: blog and map the section to the theme layouts:
layouts:
sections:
blog: posts
pages:
paths:
- section: blog
path: :section/:year/:month/:day-:slugSet papermod.analytics: true and create your own layouts/partials/analytics.html.twig with your tracking code.
Translations are provided in translations/ (English and French).
The CSS (assets/tailwind.css, configured CSS-first, without tailwind.config.js) is compiled with the Tailwind CSS v4 standalone binary through tailwind-builder (no Node.js required):
composer install
composer css:build # or composer css:watchRun the demo:
php demo/link.php
php cecil.phar serve demoPaperMod is a free software distributed under the terms of the MIT license.

