No documentation for svg.html

[jtagcat]

The readme.md says to add any svg icons to svg.html. I couldn't find any documentation of the file's formatting nor an example.

There is the default file, but does the custom content override everything, append, prepend or cleverly insert in the middle, in the right spot?

Related: #23 @Track3

[jtagcat]

tested: it overrides

You may expect me to write the docs.

[Track3]

Hi @jtagcat Sorry for my late response. Because icons used in this theme has special visual styles, it's tricky to find other icons that fits, so usually many adjustments is needed. It's not beginner friendly at all, so I didn't write more details about it.

Basicly, in svg.html template there's just a huge set of if…else conditions, if .name matches, the svg icon get output. if no matches, a chain🔗 icon get output.

Those code in between are SVG itself, it's the code that will eventually go to the html after hugo build the page and be rendered to an icon.

[jtagcat]

I tinkered around with it and left to the opinion that indeed icons aren't really compatible. Icons I tried with.

I have low-medium skills for Illustrator, I didn't yet try modifying the icons there. Any pointers on how to make the icons compatible?

[Track3]

I didn't know much about these too. My suggestion is find another icon library that contains all icons you need, then edit svg.html put them in. Have you tried font awesome?

[jtagcat]

Next time I would've attempted to spend my time on this I would've tried fork awesome and nerdfonts. I also have my hackerspace logo in there, what's probably not gonna be in icon packs. Font awesome needs bunch of licences and stuff so I would bother with it the last.