Links theme

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

• Template blocks
• Dark mode
• Etc.

composer require cecil/theme-links

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

Add links in the theme section of the configuration:

theme:
  - links

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).

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

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.

composer require aligny/tailwind-builder

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

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

© Arnaud Ligny