Create a static website with Hugo, instead of README.md

glibg10b / ltt-linux-challenge-issues

A list of issues Linus and Luke experienced during the LTT Linux Daily Driver Challenge

https://arewelinusyet.com/

MIT License

237 stars 8 forks source link

Create a static website with Hugo, instead of README.md #31

Open gikari opened 2 years ago

gikari commented 2 years ago

u/Xornial created a website mirror of this repo on https://arewelinusyet.com/. As the person says, it's difficult to sync the changes from there to their website.

I suggest merging with the person's project and keeping the content using Hugo-based static website.

Advantages:

Advanced styling, like in e.g. https://arewewaylandyet.com/
Possibility to create labels for items, so that they can be filtered (advanced list)
Minimalistic "go-to" webpage with the quick summary
Meme (i.e. easy to remember and spread) web page address

Disadvantages:

Requires a bit of initial work, but the complexity of contributing is not increasing much, as the Hugo operates on Markdown files too.

glibg10b commented 2 years ago

I got in touch with Xornial, waiting for their response. I've added a link to the sidebar for now.

glibg10b commented 2 years ago

No response yet :(

SamGreenwood1 commented 2 years ago

How did you set up the site? I would like to do something similar for a repo of mine but the Hugo docs don't include anything on porting a GH site to Hugo.

gikari commented 2 years ago

To create Hugo website the following is needed:

Hugo repository with the content in form of markdown
Hugo html template to structure the content
CSS for the templates

We already have the content in the form of readme. The hardest part is creating/finding the template page and decent responsive CSS for it.

Usually, when you create a site in Hugo, you outsource the last two problems to the Hugo Themes creators (Theme = templates + CSS), but in our case there isn't any template I found fitting, so I believe it should be created from scratch.

SamGreenwood1 commented 2 years ago

Or not. I need something that would let me just streight up duplicate the GitHub page. I'm just trying to get around the limitation of not being able to redirect it a a mask. / page on my domain.