adyxax/www
1
0
Fork 0
Code Issues Pull requests Activity Actions
My personal website https://www.adyxax.org/
504 commits 1 branch 0 tags 1.2 MiB
  • CSS 35.1%
  • HTML 29.4%
  • Go 22%
  • Shell 13.5%
Find a file
Exact
Julien Dessaux 9e60be7d96
All checks were successful
/ all (push) Successful in 19s
Details
chore(search): update dependencies
2026-01-26 10:53:00 +01:00
.forgejo/workflows chore(tooling): simplify a few things 2026-01-15 00:25:09 +01:00
assets chore(css): update typography and spacing 2025-03-23 16:14:07 +01:00
content feat(blog): add using forgejo actions without nodejs 2026-01-15 00:28:54 +01:00
layouts Various small fixes 2024-03-01 00:01:43 +01:00
search chore(search): update dependencies 2026-01-26 10:53:00 +01:00
static/static Added my public gpg key 2023-09-20 22:14:55 +02:00
.gitignore Updated gitignore for latest hugo versions 2022-05-23 18:13:22 +02:00
config.toml chore(tooling): fix configuration for newer versions of hugo 2026-01-23 22:21:43 +01:00
LICENSE Updated License 2021-03-31 09:38:18 +02:00
make.sh chore(search): update dependencies 2026-01-26 10:53:00 +01:00
README.md chore(tooling): rework the build script and CI from scratch 2026-01-11 00:48:24 +01:00

README.md

www : My personal website

My name is Julien Dessaux, also known by my pseudonym Adyxax: welcome to my personal website!

These pages are an aggregation of various thoughts and tutorials I accumulated over my years of service as a system and network administrator and architect. Topics covered are open source, BSD and GNU/Linux system administration, and networking. It is a personal space that I try to fill up with my experience and knowledge of computer systems and network administration in the hope it serves others. You can learn more about me on this page.

I hope you feel welcome here, do not hesitate to leave a message at julien -DOT- dessaux -AT- adyxax -DOT- org. You can ask for a translation, some more details on a topic covered here, or just say hi or whatever ;-)

Have a good time!

Contents

Dependencies

go is required for the search feature. Only go version >= 1.22 on linux amd64 (Gentoo) is being regularly tested.

hugo is required in order to build the website html pages. Only hugo >= 0.111.3 is being regularly tested.

Quick Start

There is a script with everything you need, just type ./make.sh and follow the usage message.

Hugo

Contrary to popular usage, I do not use a theme with hugo. I decided to write my own in order to keep it light and simple. Here is a breakdown of each folder's contents:

  • assets/: css files, which will be compiled into a single minified file.
  • content/: markdown files
    • blog/: blog section of this website.
    • books/: a log of simple reviews of books I read.
    • docs/: wiki like section, where information is not sorted just chronologically like in the blog section.
    • search/: dummy section I need for the search feature.
  • deploy/: container images building script.
  • layouts/: html, json and rss templates. Also some useful hugo shortcodes.
  • search/: the go program that powers the search feature.
  • static/: favicon, blog images and schematics.

Search

Hugo can easily generate a json index of the website, and according to my google-fu hugo users use javascript solutions to implement search on top of this. I was not satisfied by the idea of having javascript download the whole website index and running searches locally, but I found no alternative. I therefore designed an alternative.

The search folder contains code for a go webservice that can handle search queries and serve results. It is fully integrated to maintain a coherent look with the website. For more details, see the related blog article.