www/README.md

70 lines
2.7 KiB
Markdown
Raw Permalink Normal View History

2022-11-08 23:59:26 +01:00
# www : My personal website
My name is Julien Dessaux, also known by my pseudonym Adyxax: welcome to my
personal website!
2022-11-08 23:59:26 +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
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
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.
2022-11-08 23:59:26 +01:00
## Quick Start
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
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
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
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/).