Hey, I wrote that guide! I'll try to help simplify it a bit.
tl;dr of creating a basic theme is that all your css changes live in a styles.css file inside your theme's folder.
Here is what you actually need to do to create a theme:
First, you will need some way to experiment with css yourself to create your theme. That can either be running a development instance where you do your work (relevant guide), or it can be something like running a browser extension that lets you define a custom css to a web page (like stylus that was mentioned in the theming guide).
The actual process of defining what your css should be is kind of tedious. If there is an element on the web page you want to apply styling to, you can right click -> inspect on that element to see the page source for it. That can help inform you about any css classes or an id that might be present on that element to help you write your css selectors. If there is an element where a custom css class would be really helpful, you can either add it yourself if you are going the full local development route by editing the relevant jinja template, or you can ask in the PieFed matrix room for it to get added to the source by somebody else to make your life easier.
I am not really a css expert by any means, but you can reference the css changes that other themes make by browsing the different themes and looking at their styles.css files (link to themes folder).
Once you have a file with all the css changes you want for your theme, the next step would be to get your theme added to the source code. That is where you would reach out to rimu and pass your css to him. He would likely do a QC pass on it before adding it to the main project.
Then, when the next version of PieFed is released and is live, your theme is now part of the project and should be select-able as a community theme! Well done!
all 2 comments