On the forum, I have posted a couple of times in different places how I have found these markdown ways of making websites with hugo and presentations with slidev to be difficult. This is strange because I use markdown all the time and I thought it would be easy but the problem is not really the use of markdown but how developers often think about problems. I think I have cracked a few problems I was having though and I am putting them here because maybe it will help someone else. Some of this understanding (which may seem/be obvious to many of you) helped me get past a barrier to developing a hugo website:
-
Developers often try to separate content from styling. This is counter to the whole gui way of doing things that microsoft and apple have pounded into our heads since the 80s (apple) and 90s (microsoft). So take for instance powerpoint, every slide is one-off. One does the formatting with the content. Tools like slidev and beamer separate the content from the styling far more. It is the same with websites on hugo where you write the content and apply a theme later where as wordpress site styling and themes are chosen up front.
-
Because of point 1 above, it is best to concentrate on content at the beginning when using hugo or slidev. Apply a theme later.
-
Do not get into micro-managing themes. They are not that easy to change. Hugo also has multiple places to change things and it is difficult to keep track and also to overwrite your custom styling with an update of a theme. Choose a theme and if you don’t like it, you will probably find another that you do like.
-
Not all hugo themes are equally easy to modify. If you do get into modifying a .css for a hugo theme, not all themes are the same. I made the mistake of starting with the casper theme and I am only realising now that this was 80% of my problem. Most other themes seem easier to use.
-
greping can lead you astray when making a hugo website. Many people’s approach is to find something they like and change the content find with grep. There is a lot of repeated content and changes you make often seem not to appear on website. You need to know exactly where styles are being applied.
-
_index in hugo is important.
-
hexadecimal colour specifications in .css are a pain when you are trying to change a colour via searching.