Port website to Hugo?
Openopened 5 months ago by poVoq · 19 comments
Reference in New Issue
There is no content yet.
Delete Branch '%!s(<nil>)'
Deleting a branch is permanent. It CANNOT be undone. Continue?
There is some ongoing discussion to port the website over to Hugo as some current active contributors prefer that and it would make it a bit easier to maintain the site & translations.
Proposed ToDo (in the spirit of this):
My proposal for the theme would be: https://github.com/h-enk/doks
Update: This one seems better: https://github.com/onweru/compose
@msavoritias, I'd say it depends what we're trying to achieve.. if someday I get to doing something about #43, I don't see how this is possible without JS, and I firmly believe this will improve many users' experience.
For the most part though, the current website doesn't need JS indeed.
Hmm, so I started playing around with the Doks theme first mentioned above and while it is super easy to get up and running the main landing page is not i18n ready 😞 Thus the landing page can not be easily translated.
Edit: see newer images below.
Quick functional mockup with this theme:
Apart from the colors, it's nice.
I wanted to have a look at the themes gallery, but I opened a bunch of them, getting only connection timeouts, so I gave up.
The colors are super easy to change.
No this is another one where the landing page seems easily translatable.
Strange, the hugo theme gallery works fine for me here.
Mockup with adjusted colors and logo, with working dark-mode
I like it!
Got the general framework going including translations:
Also added a favicon already.
One problem is that I could not find a way yet to enable a language switcher in the menu and it also does not switch languages automatically it seems.
Once I finalized some stubs for the documentation and the tutorials I will probably upload it to a new repo in case people want to help out already with porting the content.
I would like to stick to the upstream theme as much as possible and not customize it over what is easily possible from within Hugo.
But it looks like the author is willing to add this feature: https://github.com/onweru/compose/issues/89
Aah that's better :)
What about automatically choosing the language, based either on the request header
Accept-Language, or JS
This has some pros and cons. I think I'd be fine with using the locale as the default language but allow switching nonetheless.
I've seen too many sites forcing a redirect to whatever lang they thought I wanted to read and it's really frustrating.
So basically the design is done, just needs porting over the content and the above mentioned fix to have the language switcher.
I hope the fix will be added soon, then I will rebase my local copy of the theme and upload it here in a seperate repo.
Yeah that's true, although I think those sites that actually "do it wrong" often use your location (IP) for this, instead of just
navigator.language. Those are user preferences.
Looks great, @poVoq, nicely done! Yesterday, I checked a demo of the theme to get an idea of what the FAQ/Tutorials would look like and it's nice.