Valetudo icon indicating copy to clipboard operation
Valetudo copied to clipboard

New Valetudo.cloud Template/Theme

Open Hypfer opened this issue 3 years ago • 4 comments

Currently, https://valetudo.cloud uses the most basic theme that was available at the time. While it more or less works, it's also a low hanging fruit providing much potential for perceived improvement with relatively little required effort.

Requirements:

  • Should work well on both mobile as well as desktops
  • Should look sorta modern
  • No externally hosted resources
  • No carousels or any other annoying animations

and that's pretty much it.

The site uses github pages and therefore jekyll. It can be found here: https://github.com/Hypfer/Valetudo/tree/master/docs

Local testing can be done by running bundle exec jekyll serve.

Hypfer avatar Oct 06 '21 07:10 Hypfer

Quick POC, only for inspiration: https://www.ccoors.de/valetudo-docs/

Basically copied the files into a Hugo project with the Learn theme. Only minor adjustments are required for the Markdown files.

Downsides:

  • URLs break :/ Could probably be fixed
  • GitHub pages is geared towards Jekyll. It is however possible to use Hugo.

ccoors avatar Oct 06 '21 19:10 ccoors

Fancy!

We definitely need stable URLs though as I'm pretty sure that they're used in multiple places where we can't change them

Hypfer avatar Oct 06 '21 19:10 Hypfer

I moved my blog from Ghost to Hugo hosted on GH pages and you can pretty much fix the urls by setting it up in frontmatter. If it helps, you can see one old post in my blog that I had to maintain the url https://raw.githubusercontent.com/joaopgrassi/blog/main/src/content/posts/2019/typed-httpclient-identityserver/index.md

You just need to set baseurl and all will work https://github.com/joaopgrassi/blog/blob/a2231c5e90437470fdac6a4b622fbe96a1999ed0/src/config.yml#L1

joaopgrassi avatar Dec 09 '21 19:12 joaopgrassi

hey @Hypfer ! I would like to contribute however I have quite basic knowledge of Js

Mayank1728 avatar Feb 15 '22 09:02 Mayank1728