Home on Devlix

Getting Started

Fri, 19 Jun 2026 00:00:00 +0000

Devlix is a small Hugo theme for a personal site with a blog. This page gets you from nothing to a running site.

Requirements

Hugo extended, v0.116.0 or newer.

Install

Add Devlix as a submodule of your Hugo site:

git submodule add https://github.com/mhd64real/hugo-theme-devlix themes/devlix

Then point your config at it:

theme = 'devlix'

Minimum config

A working hugo.toml needs very little:

baseURL = 'https://example.com/'
title = 'Your Name'
theme = 'devlix'
uglyURLs = true

[params.profile]
 name = 'Your Name'
 photo = '/img/me.jpg'
 roles = ['What you do']

 [[params.profile.links]]
 text = 'you@example.com'
 url = 'mailto:you@example.com'

Run it

hugo server -D

Open http://localhost:1313. That is the whole loop: edit, save, the browser reloads.

Configuration

Thu, 18 Jun 2026 00:00:00 +0000

Everything lives in your site config. Devlix ships sensible defaults, so you only set what you want to change.

The home and blog pages show a profile card built from [params.profile]:

[params.profile]
 name = 'Your Name'
 photo = '/img/me.jpg' # local path or a full https URL
 roles = ['Role one', 'Role two']

 [[params.profile.links]]
 text = 'you@example.com'
 url = 'mailto:you@example.com'
 [[params.profile.links]]
 text = 'github/you'
 url = 'https://github.com/you'

Add a [[params.profile.links]] block for each link, including email (write the mailto: yourself). Any field you leave out is simply not rendered.

Writing Content

Wed, 17 Jun 2026 00:00:00 +0000

How content maps to pages, and the few extras Devlix gives you.

Pages and posts

content/
 _index.md # the home page (your intro)
 blog/
 _index.md # the blog landing
 a-post.md # a post
 about.md # any standalone page

A post’s front matter:

title = "My Post"
date = 2026-06-19
draft = false
description = "Shown in search results and link previews."
image = "/img/cover.jpg" # optional card + cover image

Headings note: the largest heading is h2. Write # or ## and both render at the top size; deeper levels step down. The site never emits an h1.