cecil / theme-links

3.1.1 2026-10-06 22:04 UTC

Requires

• aligny/tailwind-builder: ^1.2
• cecil/theme-fontawesome: ^1.5
• cecil/theme-installer: ^1.4|^2.0

MIT

• theme
• links
• cecil

Published on Packagist.org on 2026-10-06 22:05 UTC

README

Links is a minimalist theme for creating link-focused pages with Cecil, powered by Tailwind CSS and Font Awesome.

Features

• Template blocks
• Dark mode
• Etc.

Installation

composer require cecil/theme-links

Or download the latest archive and uncompress its content in themes/links.

Usage

Add links in the theme section of the configuration:

theme:
  - links

Blocks

The home page is built from the blocks array of its front matter, each block being rendered by the template layouts/blocks/<name>.html.twig:

• content: page content (Markdown body)
• links: list of links, defined in the block items
• social: social identities (from social configuration)

A block can be used several times, e.g. to display multiple lists of links:

---
blocks:
  - name: content
  - name: links
    items:
      - title: <title>
        url: <url>
        color: "<#hexa_code>" # optional
        icon: <style>:<name>  # Font Awesome icon, optional (e.g. "brands:github")
      - title: <title>
        url: <url>
        fallback: <path>      # optional, image used if no image is found on the website
  - name: links
    items:
      - title: <title>
        url: <url>
        image: <path or URL>  # optional, displays an image
      - title: <title>
        video: <path>         # optional, displays a video
  - name: social
---

If a link has no icon, the illustration image of the linked website (Open Graph, Twitter, etc.) is used instead. If no image is found, the fallback image (path to an asset) is displayed, if set.

Each links block is rendered as an <ol class="buttons"> with a unique id (buttons-<block index>), and each link has the id buttons-<block index>-<link index>.

If a links block has no items, the page links variable is used as a fallback (backward compatibility).

Configuration

links:
  buttons:
    color: page # use links colors (`page`, default) or CSS colors (`css`)

Customization

Templates only use semantic classes (.layout, .header, .avatar, .site-title, .site-baseline, .content, .footer, .buttons, .button, .button-link, .button-icon, .button-favicon, .button-title, .button-media, .social, .social-icon, .social-<name>, etc.): their appearance is defined in assets/tailwind.css and can be overridden in your own assets/tailwind.css.

Development

Install tailwind-builder

composer require aligny/tailwind-builder

Rebuild CSS

vendor/bin/tailwind-builder assets/tailwind.css --minify

License

Links theme is a free software distributed under the terms of the MIT license.

© Arnaud Ligny