2022-11-08 23:59:26 +01:00
|
|
|
# www : My personal website
|
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
My name is Julien Dessaux, also known by my pseudonym Adyxax: welcome to my
|
|
|
|
personal website!
|
2022-11-08 23:59:26 +01:00
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
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.
|
2022-11-08 23:59:26 +01:00
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
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 ;-)
|
2022-11-08 23:59:26 +01:00
|
|
|
|
|
|
|
Have a good time!
|
|
|
|
|
|
|
|
## Contents
|
|
|
|
|
|
|
|
- [Dependencies](#dependencies)
|
|
|
|
- [Quick Start](#Quick-Start)
|
|
|
|
- [Hugo](#Hugo)
|
|
|
|
- [Search](#Search)
|
|
|
|
- [Kubernetes](#Kubernetes)
|
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
go is required for the search feature. Only go version >= 1.22 on linux amd64
|
|
|
|
(Gentoo) is being regularly tested.
|
2022-11-09 00:09:34 +01:00
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
hugo is required in order to build the website html pages. Only hugo >= 0.111.3
|
|
|
|
is being regularly tested.
|
2022-11-08 23:59:26 +01:00
|
|
|
|
|
|
|
## Quick Start
|
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
There is a makefile with everything you need, just type `make help` (or `gmake
|
|
|
|
help` if running BSD).
|
2022-11-08 23:59:26 +01:00
|
|
|
|
|
|
|
## Hugo
|
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
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.
|
2022-11-08 23:59:26 +01:00
|
|
|
|
|
|
|
## Search
|
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
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.
|
2022-11-08 23:59:26 +01:00
|
|
|
|
2025-03-09 20:31:45 +01:00
|
|
|
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](https://www.adyxax.org/blog/2021/09/19/implementing-a-search-feature-for-my-hugo-static-website/).
|