The website

Background

When I was trying to install linux on every single device with a CPU on my house I stared making tutorials in markdown.
I did those tutorials to make sure I could replicate my instalations and that I didn't make the same mistake twice.
It got to one point where the information I had in them was so detailed that it just wasn't anywhere else on the internet. On that moment I decided that I wanted to share my knolege with the world just like the world shared that knologe with me.
At first I was just thinking of a simple gitlab repo with the md files but on the day I was buying the Ampex the guy asked me if I had a website. And from that day on I started making some light reserch on how to make a website

Planing

I started on the most popular way Wordpress. But the development was slow at least for me, yes it was preety but I had to make so many choices and select so many text boxes and each time I needed an image I needed to import the thing, it was clunky.
It needed to be faster.

I already had a lot of md files and if they can be passed to PDF then there must be a way to parse them to a simple website right?

And the solution to that problem was mkdocs

But of course I didn't want a simple thing I wanted an entire pipeline. I wanted to write the md files in my computer/local repo and in the moment I pushed the code to the remote the website would automaticly update everything without intervention.
In the end this criterion was completly fufflied.

But first.

Getting a local version running

The first part was creating a Venv with mkdocs

python -m venv venv
pip install mkdocs

https://www.mkdocs.org/getting-started/
I also used mkdoc material so I needed to install that as well
https://squidfunk.github.io/mkdocs-material/getting-started/

I basicly followed the tutorial made a 'docs' directory with an index an about and some images. As I had all files in a 'projects' dir I made a symlink to the respective directory. Inside the 'projects' dir I organized it as I wanted the website map to be. For the projects I have 'project.md' and 'project/'. So for each project I have the md file and a directory with the same name. This directory is for the images.

Images

Oh imsges were a whole can of worms. I was first going the lazy way: Take photo, put on website, done. But I forgot about about multiple details.

Image size. If all images are 16Mp the website takes a fuckton of time to load and it eats all the space on my free gitlab repo. I am a hell of a cheapstake so I don't want to pay more than I need and I do not want people to remember the old days of the internet where you need to wait 10min to a picutre of... what your heart desierd. So I made a script that goes to every image, decreased the resolution, and removes all metadata.