first stab at mkdocs migration

refactor CSCS and Meg content

add merlin6 quick start

update merlin6 nomachine docs

give the userdoc its own color scheme

we use the Materials default one

refactored slurm general docs merlin6

add merlin6 JB docs

add software support m6 docs

add all files to nav

vibed changes #1

add missing pages

further vibing #2

vibe #3

further fixes
This commit is contained in:
2025-11-26 17:28:07 +01:00
parent 149de6fb18
commit bde174b726
313 changed files with 2608 additions and 11593 deletions

188
mkdocs.yml Normal file
View File

@@ -0,0 +1,188 @@
# Project information
site_name: HPCE User Documentation
site_url: https://hpce.pages.psi.ch
# Repository
repo_name: hpce/gitea-pages
repo_url: https://gitea.psi.ch/hpce/gitea-pages
# Copyright
copyright: Copyright © 2025 HPC and Emerging Technologies Group/CSD @ Paul Scherrer Institut
# Configuration
theme:
name: material
favicon: images/favicon.ico
logo: images/hpce_logo.png
features:
- navigation.tabs
- navigation.sections
- navigation.indexes
palette:
- media: "(prefers-color-scheme)"
toggle:
icon: material/link
name: Switch to light mode
- media: "(prefers-color-scheme: light)"
scheme: default
toggle:
icon: material/toggle-switch
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
toggle:
icon: material/toggle-switch-off
name: Switch to system preference
# plugins
plugins:
- search
- optimize
- blog:
blog_dir: news
- glightbox
# Extensions
markdown_extensions:
- admonition
- attr_list
- footnotes
- md_in_html
- tables
- pymdownx.caret
- pymdownx.critic
- pymdownx.blocks.caption
- pymdownx.details
- pymdownx.highlight:
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
auto_title: true
- pymdownx.inlinehilite
- pymdownx.keys
- pymdownx.mark
- pymdownx.snippets
- pymdownx.superfences
- pymdownx.tilde
# Page tree
nav:
- Home: index.md
- News:
- news/index.md
- Merlin 7:
- Quick Start Guide:
- merlin7/01-Quick-Start-Guide/introduction.md
- merlin7/01-Quick-Start-Guide/code-of-conduct.md
- merlin7/01-Quick-Start-Guide/requesting-accounts.md
- merlin7/01-Quick-Start-Guide/requesting-projects.md
- merlin7/01-Quick-Start-Guide/accessing-interactive-nodes.md
- merlin7/01-Quick-Start-Guide/accessing-slurm.md
- How To Use Merlin7:
- merlin7/02-How-To-Use-Merlin/connect-from-linux.md
- merlin7/02-How-To-Use-Merlin/connect-from-windows.md
- merlin7/02-How-To-Use-Merlin/connect-from-macos.md
- merlin7/02-How-To-Use-Merlin/storage.md
- merlin7/02-How-To-Use-Merlin/transfer-data.md
- merlin7/02-How-To-Use-Merlin/archive.md
- merlin7/02-How-To-Use-Merlin/nomachine.md
- merlin7/02-How-To-Use-Merlin/merlin-rmount.md
- merlin7/02-How-To-Use-Merlin/merlin_tools.md
- merlin7/02-How-To-Use-Merlin/ssh-keys.md
- merlin7/02-How-To-Use-Merlin/kerberos.md
- merlin7/02-How-To-Use-Merlin/software-repositories.md
- Slurm General Documentation:
- merlin7/03-Slurm-General-Documentation/merlin7-configuration.md
- merlin7/03-Slurm-General-Documentation/slurm-configuration.md
- merlin7/03-Slurm-General-Documentation/interactive-jobs.md
- merlin7/03-Slurm-General-Documentation/slurm-examples.md
- Jupyterhub:
- merlin7/04-Jupyterhub/jupyterhub.md
- Software Support:
- merlin7/05-Software-Support/pmodules.md
- merlin7/05-Software-Support/spack.md
- merlin7/05-Software-Support/openmpi.md
- merlin7/05-Software-Support/ansys.md
- merlin7/05-Software-Support/ansys-rsm.md
- merlin7/05-Software-Support/cp2k.md
- merlin7/05-Software-Support/quantum-espresso.md
- merlin7/05-Software-Support/lammps.md
- merlin7/05-Software-Support/gromacs.md
- merlin7/05-Software-Support/opal-x.md
- merlin7/05-Software-Support/ippl.md
- merlin7/05-Software-Support/cray-module.env.md
- Support:
- merlin7/99-support/migration-from-merlin6.md
- merlin7/99-support/contact.md
- Merlin 6:
- merlin6/cluster-introduction.md
- merlin6/hardware-and-software-description.md
- merlin6/slurm-configuration.md
- Quick Start Guide:
- merlin6/quick-start-guide/introduction.md
- merlin6/quick-start-guide/code-of-conduct.md
- merlin6/quick-start-guide/requesting-accounts.md
- merlin6/quick-start-guide/requesting-projects.md
- merlin6/quick-start-guide/accessing-interactive-nodes.md
- merlin6/quick-start-guide/accessing-slurm.md
- How To Use Merlin:
- merlin6/how-to-use-merlin/connect-from-linux.md
- merlin6/how-to-use-merlin/connect-from-windows.md
- merlin6/how-to-use-merlin/connect-from-macos.md
- merlin6/how-to-use-merlin/storage.md
- merlin6/how-to-use-merlin/transfer-data.md
- merlin6/how-to-use-merlin/archive.md
- merlin6/how-to-use-merlin/nomachine.md
- merlin6/how-to-use-merlin/ssh-keys.md
- merlin6/how-to-use-merlin/kerberos.md
- merlin6/how-to-use-merlin/using-modules.md
- Slurm General Documentation:
- merlin6/slurm-general-docs/slurm-basic-commands.md
- merlin6/slurm-general-docs/running-jobs.md
- merlin6/slurm-general-docs/interactive-jobs.md
- merlin6/slurm-general-docs/slurm-examples.md
- merlin6/slurm-general-docs/monitoring.md
- GPU Cluster:
- gmerlin6/cluster-introduction.md
- gmerlin6/hardware-and-software-description.md
- gmerlin6/slurm-configuration.md
- Merlin 5 CPU Cluster:
- merlin5/cluster-introduction.md
- merlin5/hardware-and-software-description.md
- merlin5/slurm-configuration.md
- Jupyterhub:
- merlin6/jupyterhub/jupyterhub.md
- merlin6/jupyterhub/jupyter-examples.md
- merlin6/jupyterhub/jupytext.md
- merlin6/jupyterhub/jupyter-extensions.md
- merlin6/jupyterhub/jupyterlab.md
- merlin6/jupyterhub/jupyterhub-trouble.md
- Software Support:
- merlin6/software-support/ansys.md
- merlin6/software-support/ansys-rsm.md
- merlin6/software-support/ansys-cfx.md
- merlin6/software-support/ansys-fluent.md
- merlin6/software-support/ansys-mapdl.md
- merlin6/software-support/ansys-hfss.md
- merlin6/software-support/gothic.md
- merlin6/software-support/merlin-rmount.md
- merlin6/software-support/impi.md
- merlin6/software-support/openmpi.md
- merlin6/software-support/paraview.md
- merlin6/software-support/python.md
- Announcements:
- merlin6/98-announcements/downtimes.md
- merlin6/98-announcements/past-downtimes.md
- Support:
- merlin6/99-support/contact.md
- merlin6/99-support/faq.md
- merlin6/99-support/known-problems.md
- merlin6/99-support/migration-from-merlin5.md
- merlin6/99-support/troubleshooting.md
- PSI@CSCS:
- cscs-userlab/index.md
- cscs-userlab/transfer-data.md
- MeG:
- meg/index.md
- meg/contact.md
- meg/migration-to-merlin7.md