MkDocs migration #17

Merged
viessm_h merged 12 commits from mkdocs into master 2026-01-12 17:51:34 +01:00
Owner

We are migrating away from Jekyll, and will use MkDocs to generate our user documentation. Main advantages:

  • a lot less tinkering (Materials for MkDocs provides almost everything we could want)
  • Materials UI is fresh, responsive, and actively developed, unlike the Jekyll Docu theme
  • and more reasons..
We are migrating away from Jekyll, and will use MkDocs to generate our user documentation. Main advantages: - a lot less tinkering (Materials for MkDocs provides almost everything we could want) - Materials UI is fresh, responsive, and actively developed, unlike the Jekyll Docu theme - and more reasons..
viessm_h self-assigned this 2025-11-26 17:33:01 +01:00
viessm_h added 1 commit 2025-11-26 17:33:01 +01:00
viessm_h added 1 commit 2025-11-27 09:40:48 +01:00
viessm_h added 1 commit 2025-11-27 10:14:18 +01:00
viessm_h added 1 commit 2025-12-01 09:03:47 +01:00
viessm_h added 1 commit 2025-12-01 12:23:35 +01:00
we use the Materials default one
viessm_h added 1 commit 2025-12-01 13:40:59 +01:00
viessm_h added 1 commit 2025-12-03 15:27:06 +01:00
viessm_h added 1 commit 2025-12-04 14:46:09 +01:00
viessm_h added 5 commits 2025-12-11 14:21:56 +01:00
viessm_h added 2 commits 2025-12-16 11:32:35 +01:00
viessm_h added 1 commit 2025-12-16 13:55:27 +01:00
viessm_h added 1 commit 2026-01-06 16:40:28 +01:00
Owner

Hi Hans... thanks for the work!

Question: Should we not keep the old HPCE logo? The wizard looks cool, but maybe rather for the Merlin page?
I think our group logo (originally made by Spencer) looks more professional and has a context with our organizational group

Hi Hans... thanks for the work! Question: Should we not keep the old HPCE logo? The wizard looks cool, but maybe rather for the Merlin page? I think our group logo (originally made by Spencer) looks more professional and has a context with our organizational group
feichtinger added 1 commit 2026-01-07 11:35:51 +01:00
Author
Owner

Hi Hans... thanks for the work!

Question: Should we not keep the old HPCE logo? The wizard looks cool, but maybe rather for the Merlin page?
I think our group logo (originally made by Spencer) looks more professional and has a context with our organizational group

Yup, I've changed it back and have moved the merlin image to the merlin7 pages

> Hi Hans... thanks for the work! > > Question: Should we not keep the old HPCE logo? The wizard looks cool, but maybe rather for the Merlin page? > I think our group logo (originally made by Spencer) looks more professional and has a context with our organizational group Yup, I've changed it back and have moved the merlin image to the merlin7 pages
viessm_h added 1 commit 2026-01-07 15:45:10 +01:00
* added back the HPCE logo to landing page
* activated the sticky tabs navigation feature (so navigation bar stays
  visible)
* added edit buttons to content (so users can _maybe_ help us in keeping
  our docs up to date)
viessm_h added 2 commits 2026-01-07 17:16:27 +01:00
this are now under the /support path, meaning that this is unified for
all clusters.
viessm_h added 1 commit 2026-01-09 10:58:54 +01:00
We use a custom override template (jinja) to generate a suitable list of
new items.

Also added first text for announcing our new user docs
viessm_h force-pushed mkdocs from 1882fbf76b to 57fc2d9271 2026-01-09 11:20:11 +01:00 Compare
viessm_h added 1 commit 2026-01-12 16:24:10 +01:00
Owner

@viessm_h are the folders _data and pdf still needed?

@viessm_h are the folders `_data` and `pdf` still needed?
Author
Owner

no I will clean these out. I also need to update the .gitea workflow stuff.

no I will clean these out. I also need to update the .gitea workflow stuff.
viessm_h added 1 commit 2026-01-12 17:26:40 +01:00
viessm_h changed title from WIP: MkDocs migration to MkDocs migration 2026-01-12 17:26:49 +01:00
viessm_h force-pushed mkdocs from e7f05af86f to b7107b9210 2026-01-12 17:47:35 +01:00 Compare
viessm_h force-pushed mkdocs from b7107b9210 to 85afff725a 2026-01-12 17:50:06 +01:00 Compare
viessm_h force-pushed mkdocs from 85afff725a to 3d3eb50d10 2026-01-12 17:51:23 +01:00 Compare
viessm_h merged commit 7aba2e0851 into master 2026-01-12 17:51:34 +01:00
viessm_h deleted branch mkdocs 2026-01-12 17:51:35 +01:00
Sign in to join this conversation.
No Reviewers
No Label
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: HPCE/gitea-pages#17