From bde174b726abbc4bb9e52c7dd91cf3cae1c576e8 Mon Sep 17 00:00:00 2001 From: Hans-Nikolai Viessmann Date: Wed, 26 Nov 2025 17:28:07 +0100 Subject: [PATCH] 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 --- .gitea/workflows/deploy-pages.yml | 39 - .gitignore | 13 +- 404.md | 6 - Dockerfile | 26 +- Gemfile | 23 - Gemfile.lock | 292 -- LICENSE | 9 + README.md | 80 +- _config.yml | 128 - _data/alerts.yml | 15 - _data/definitions.yml | 9 - _data/glossary.yml | 11 - _data/samplelist.yml | 107 - _data/sidebars/CSCS_sidebar.yaml | 15 - _data/sidebars/meg_sidebar.yml | 17 - _data/strings.yml | 5 - _data/tags.yml | 15 - _data/terms.yml | 3 - _data/topnav.yml | 36 - _includes/archive.html | 15 - _includes/callout.html | 10 - _includes/custom/getting_started_series.html | 19 - .../custom/getting_started_series_next.html | 10 - _includes/custom/series_acme.html | 19 - _includes/custom/series_acme_next.html | 30 - _includes/custom/usermap.html | 14 - _includes/custom/usermapcomplex.html | 91 - _includes/disqus.html | 17 - _includes/feedback.html | 13 - _includes/footer.html | 9 - _includes/google_analytics.html | 6 - _includes/head.html | 43 - _includes/head_print.html | 28 - _includes/image.html | 1 - _includes/important.html | 1 - _includes/initialize_shuffle.html | 130 - _includes/inline_image.html | 1 - _includes/links.html | 44 - _includes/note.html | 8 - _includes/sidebar.html | 67 - _includes/taglogic.html | 32 - _includes/tip.html | 1 - _includes/toc.html | 21 - _includes/topnav.html | 81 - _includes/warning.html | 8 - _layouts/default.html | 106 - _layouts/default_print.html | 25 - _layouts/none.html | 3 - _layouts/page.html | 68 - _layouts/page_print.html | 15 - _layouts/post.html | 39 - _posts/2019-06-12-launching-merlin6-docs.md | 11 - _tooltips/baseball.html | 6 - _tooltips/basketball.html | 6 - _tooltips/football.html | 6 - _tooltips/soccer.html | 6 - apple-touch-icon.png | Bin 34370 -> 0 bytes compose.yml | 14 + createtag | 54 - css/bootstrap.min.css | 6 - css/boxshadowproperties.css | 24 - css/customstyles.css | 1217 -------- css/font-awesome.min.css | 4 - css/fonts/FontAwesome.otf | Bin 134808 -> 0 bytes css/fonts/fontawesome-webfont.eot | Bin 165742 -> 0 bytes css/fonts/fontawesome-webfont.svg | 2671 ----------------- css/fonts/fontawesome-webfont.ttf | Bin 165548 -> 0 bytes css/fonts/fontawesome-webfont.woff | Bin 98024 -> 0 bytes css/fonts/fontawesome-webfont.woff2 | Bin 77160 -> 0 bytes css/modern-business.css | 89 - css/printstyles.css | 159 - css/syntax.css | 60 - css/theme-blue.css | 121 - css/theme-green.css | 110 - docker-compose.yml | 10 - .../CSCS/PSI_CSCSAllocations2023.xltx | Bin {pages/CSCS => docs/cscs-userlab}/index.md | 36 +- .../cscs-userlab}/transfer-data.md | 13 +- .../gmerlin6/cluster-introduction.md | 4 +- .../hardware-and-software-description.md | 10 +- .../gmerlin6/slurm-configuration.md | 4 +- .../ANSYS/HFSS/01_Select_Scheduler_Menu.png | Bin .../HFSS/02_Select_Scheduler_RSM_Remote.png | Bin .../ANSYS/HFSS/03_Select_Scheduler_Slurm.png | Bin .../images}/ANSYS/HFSS/04_Submit_Job_Menu.png | Bin .../ANSYS/HFSS/05_Submit_Job_Product_Path.png | Bin .../images}/ANSYS/cfx5launcher.png | Bin .../merlin7/HFSS/01_Select_Scheduler_Menu.png | Bin .../HFSS/02_Select_Scheduler_RSM_Remote.png | Bin .../HFSS/03_Select_Scheduler_Slurm.png | Bin .../ANSYS/merlin7/HFSS/04_Submit_Job_Menu.png | Bin .../HFSS/05_Submit_Job_Product_Path.png | Bin .../images}/ANSYS/merlin7/cfx5launcher.png | Bin .../ANSYS/merlin7/merlin7/cfx5launcher.png | Bin .../ANSYS/merlin7/rsm-1-add_hpc_resource.png | Bin .../ANSYS/merlin7/rsm-2-add_cluster.png | Bin .../ANSYS/merlin7/rsm-3-add_scratch_info.png | Bin .../ANSYS/merlin7/rsm-4-get_slurm_queues.png | Bin .../ANSYS/merlin7/rsm-5-authenticating.png | Bin .../merlin7/rsm-6-selected-partitions.png | Bin .../images}/ANSYS/rsm-1-add_hpc_resource.png | Bin .../images}/ANSYS/rsm-2-add_cluster.png | Bin .../images}/ANSYS/rsm-3-add_scratch_info.png | Bin .../images}/ANSYS/rsm-4-get_slurm_queues.png | Bin .../images}/ANSYS/rsm-5-authenticating.png | Bin .../ANSYS/rsm-6-selected-partitions.png | Bin .../Access/01-request-merlin5-membership.png | Bin .../Access/01-request-merlin6-membership.png | Bin .../Access/01-request-merlin7-membership.png | Bin .../01-request-unx-group-membership.png | Bin .../PuTTY/Putty_Disable_Kerberos_GSSAPI.png | Bin .../images}/PuTTY/Putty_Mouse_XTerm.png | Bin .../images}/PuTTY/Putty_Session.png | Bin .../images}/PuTTY/Putty_X11_Forwarding.png | Bin {images => docs/images}/WIP/WIP1.jpeg | Bin {images => docs/images}/WIP/WIP1.webp | Bin favicon.ico => docs/images/favicon.ico | Bin docs/images/front_page.png | Bin 0 -> 3394214 bytes docs/images/hpce_logo.png | Bin 0 -> 284899 bytes .../images/hpce_logo_full.png | Bin .../jupyter}/jupyter-launch-classic.png | Bin .../images/jupyter}/jupyter-nbextensions.png | Bin .../images/jupyter}/jupytext_menu.png | Bin .../images}/merlin-slurm-architecture.png | Bin {images => docs/images}/merlinschema3.png | Bin .../images/nomachine}/screen_nx1.png | Bin .../images/nomachine}/screen_nx10.png | Bin docs/images/nomachine/screen_nx11.png | Bin 0 -> 44630 bytes .../images/nomachine}/screen_nx2.png | Bin .../images/nomachine}/screen_nx3.png | Bin .../images/nomachine}/screen_nx4.png | Bin .../images/nomachine}/screen_nx5.png | Bin .../images/nomachine}/screen_nx6.png | Bin .../images/nomachine}/screen_nx7.png | Bin .../images/nomachine}/screen_nx8.png | Bin .../images/nomachine}/screen_nx9.png | Bin .../images/nomachine}/screen_nx_address.png | Bin .../images/nomachine}/screen_nx_auth.png | Bin .../nomachine}/screen_nx_configuration.png | Bin docs/images/nomachine/screen_nx_connect.png | Bin 0 -> 62879 bytes .../nomachine/screen_nx_existingsession.png | Bin 0 -> 50230 bytes .../images/nomachine/screen_nx_newsession.png | Bin 0 -> 50172 bytes .../nomachine}/screen_nx_single_session.png | Bin {images => docs/images}/psi-logo.png | Bin {images => docs/images}/rmount/mount.png | Bin .../images}/rmount/select-mount.png | Bin .../images}/rmount/thunar_mount.png | Bin {images => docs/images}/scicat_token.png | Bin {images/Slurm => docs/images/slurm}/scom.gif | Bin {images/Slurm => docs/images/slurm}/sview.png | Bin docs/index.md | 26 + {pages/meg/99-support => docs/meg}/contact.md | 47 +- docs/meg/index.md | 13 + .../meg}/migration-to-merlin7.md | 67 +- .../merlin5/cluster-introduction.md | 6 +- .../hardware-and-software-description.md | 10 +- .../merlin5/slurm-configuration.md | 0 .../merlin6/98-announcements/downtimes.md | 2 +- .../98-announcements/past-downtimes.md | 0 {pages => docs}/merlin6/99-support/contact.md | 0 {pages => docs}/merlin6/99-support/faq.md | 14 +- .../merlin6/99-support/known-problems.md | 8 +- .../99-support/migration-from-merlin5.md | 8 +- .../merlin6/99-support/troubleshooting.md | 4 +- .../merlin6/cluster-introduction.md | 6 +- .../hardware-and-software-description.md | 0 .../merlin6/how-to-use-merlin}/archive.md | 139 +- .../how-to-use-merlin}/connect-from-linux.md | 24 +- .../how-to-use-merlin}/connect-from-macos.md | 6 +- .../connect-from-windows.md | 12 +- .../merlin6/how-to-use-merlin}/kerberos.md | 4 +- .../merlin6/how-to-use-merlin}/nomachine.md | 63 +- .../merlin6/how-to-use-merlin}/ssh-keys.md | 0 .../merlin6/how-to-use-merlin}/storage.md | 104 +- .../how-to-use-merlin}/transfer-data.md | 35 +- .../how-to-use-merlin}/using-modules.md | 3 +- .../merlin6/jupyterhub}/jupyter-examples.md | 25 +- docs/merlin6/jupyterhub/jupyter-extensions.md | 30 + docs/merlin6/jupyterhub/jupyterhub-trouble.md | 78 + .../merlin6/jupyterhub}/jupyterhub.md | 87 +- .../merlin6/jupyterhub}/jupyterlab.md | 26 +- docs/merlin6/jupyterhub/jupytext.md | 52 + .../accessing-interactive-nodes.md | 31 +- .../quick-start-guide}/accessing-slurm.md | 38 +- .../quick-start-guide/code-of-conduct.md | 48 + .../quick-start-guide}/introduction.md | 46 +- .../quick-start-guide}/requesting-accounts.md | 17 +- .../quick-start-guide}/requesting-projects.md | 37 +- .../merlin6/slurm-configuration.md | 22 +- .../slurm-general-docs/interactive-jobs.md | 217 ++ docs/merlin6/slurm-general-docs/monitoring.md | 278 ++ .../slurm-general-docs}/running-jobs.md | 87 +- .../slurm-basic-commands.md | 16 +- .../slurm-general-docs}/slurm-examples.md | 37 +- .../merlin6/software-support}/ansys-cfx.md | 47 +- .../merlin6/software-support}/ansys-fluent.md | 103 +- .../merlin6/software-support}/ansys-hfss.md | 96 +- .../merlin6/software-support}/ansys-mapdl.md | 56 +- docs/merlin6/software-support/ansys-rsm.md | 111 + docs/merlin6/software-support/ansys.md | 79 + docs/merlin6/software-support/gothic.md | 222 ++ docs/merlin6/software-support/impi.md | 40 + .../software-support}/merlin-rmount.md | 52 +- docs/merlin6/software-support/openmpi.md | 168 ++ docs/merlin6/software-support/paraview.md | 63 + .../merlin6/software-support}/python.md | 75 +- .../accessing-interactive-nodes.md | 18 +- .../01-Quick-Start-Guide/accessing-slurm.md | 10 +- .../01-Quick-Start-Guide/code-of-conduct.md | 10 +- .../01-Quick-Start-Guide/introduction.md | 2 +- .../requesting-accounts.md | 2 +- .../requesting-projects.md | 2 +- .../merlin7/02-How-To-Use-Merlin/archive.md | 25 +- .../connect-from-linux.md | 6 +- .../connect-from-macos.md | 6 +- .../connect-from-windows.md | 21 +- .../merlin7/02-How-To-Use-Merlin/kerberos.md | 2 +- .../02-How-To-Use-Merlin/merlin-rmount.md | 18 +- .../02-How-To-Use-Merlin/merlin_tools.md | 16 +- .../merlin7/02-How-To-Use-Merlin/nomachine.md | 8 +- .../software-repositories.md | 15 +- .../merlin7/02-How-To-Use-Merlin/ssh-keys.md | 0 .../merlin7/02-How-To-Use-Merlin/storage.md | 67 +- .../02-How-To-Use-Merlin/transfer-data.md | 35 +- .../interactive-jobs.md | 25 +- .../merlin7-configuration.md | 0 .../slurm-configuration.md | 77 +- .../slurm-examples.md | 0 .../merlin7/04-Jupyterhub/jupyterhub.md | 2 +- .../merlin7/05-Software-Support/ansys-rsm.md | 21 +- .../merlin7/05-Software-Support/ansys.md | 14 +- .../merlin7/05-Software-Support/cp2k.md | 0 .../05-Software-Support/cray-module.env.md | 0 .../merlin7/05-Software-Support/gromacs.md | 0 .../merlin7/05-Software-Support/ippl.md | 0 .../merlin7/05-Software-Support/lammps.md | 0 .../merlin7/05-Software-Support/opal-x.md | 0 .../merlin7/05-Software-Support/openmpi.md | 19 +- .../merlin7/05-Software-Support/pmodules.md | 2 +- .../05-Software-Support/quantum-espresso.md | 0 .../merlin7/05-Software-Support/spack.md | 0 {pages => docs}/merlin7/99-support/contact.md | 0 .../99-support/migration-from-merlin6.md | 10 +- docs/news/index.md | 2 + docs/news/posts/launching-merlin6-docs.md | 12 + .../news/posts/merlin7-preprod-docs.md | 13 +- favicon-16x16.png | Bin 1753 -> 0 bytes favicon-32x32.png | Bin 2993 -> 0 bytes feed.xml | 32 - fonts/glyphicons-halflings-regular.eot | Bin 20127 -> 0 bytes fonts/glyphicons-halflings-regular.svg | 288 -- fonts/glyphicons-halflings-regular.ttf | Bin 45404 -> 0 bytes fonts/glyphicons-halflings-regular.woff | Bin 23424 -> 0 bytes fonts/glyphicons-halflings-regular.woff2 | Bin 18028 -> 0 bytes images/favicon.ico | Bin 177352 -> 0 bytes index.md | 18 - js/anchor.min.js | 9 - js/bootstrap.min.js | 6 - js/customscripts.js | 54 - js/html5shiv.js | 8 - js/jekyll-search.js | 1 - js/jquery.ba-throttle-debounce.min.js | 9 - js/jquery.cookie.min.js | 2 - js/jquery.min.js | 2 - js/jquery.navgoco.min.js | 8 - js/jquery.shuffle.min.js | 1588 ---------- js/respond.min.js | 5 - js/toc.js | 82 - licenses/LICENSE | 21 - licenses/LICENSE-BSD-NAVGOCO.txt | 27 - mkdocs.yml | 188 ++ .../meg/01-Quick-Start-Guide/introduction.md | 18 - .../01-Quick-Start-Guide/code-of-conduct.md | 52 - .../interactive-jobs.md | 235 -- .../monitoring.md | 288 -- .../04-Jupyterhub/jupyter-extensions.md | 32 - .../04-Jupyterhub/jupyterhub-trouble.md | 63 - pages/merlin6/04-Jupyterhub/jupytext.md | 37 - .../merlin6/05-Software-Support/ansys-rsm.md | 108 - pages/merlin6/05-Software-Support/ansys.md | 89 - pages/merlin6/05-Software-Support/gothic.md | 216 -- pages/merlin6/05-Software-Support/impi.md | 45 - pages/merlin6/05-Software-Support/openmpi.md | 140 - pages/merlin6/05-Software-Support/paraview.md | 63 - pages/news/news.html | 32 - pages/news/news_archive.html | 35 - pages/tags/tag_collaboration.md | 11 - pages/tags/tag_content_types.md | 11 - pages/tags/tag_formatting.md | 11 - pages/tags/tag_getting_started.md | 11 - pages/tags/tag_mobile.md | 11 - pages/tags/tag_navigation.md | 11 - pages/tags/tag_news.md | 11 - pages/tags/tag_publishing.md | 11 - pages/tags/tag_single_sourcing.md | 11 - pages/tags/tag_special_layouts.md | 12 - pages/tags/tag_troubleshooting.md | 11 - pdf-all.sh | 1 - pdf-mydoc.sh | 14 - pdf-product1.sh | 11 - pdf-product2.sh | 11 - pdfconfigs/config_mydoc_pdf.yml | 20 - pdfconfigs/config_product1_pdf.yml | 20 - pdfconfigs/config_product2_pdf.yml | 20 - pdfconfigs/prince-list.txt | 82 - pdfconfigs/titlepage.html | 22 - pdfconfigs/tocpage.html | 44 - search.json | 33 - siteinfo.md | 58 - sitemap.xml | 24 - tooltips.html | 79 - tooltips.json | 19 - var/build.sh | 10 - 313 files changed, 2608 insertions(+), 11593 deletions(-) delete mode 100644 .gitea/workflows/deploy-pages.yml delete mode 100644 404.md delete mode 100644 Gemfile delete mode 100644 Gemfile.lock create mode 100644 LICENSE delete mode 100644 _config.yml delete mode 100644 _data/alerts.yml delete mode 100644 _data/definitions.yml delete mode 100644 _data/glossary.yml delete mode 100644 _data/samplelist.yml delete mode 100644 _data/sidebars/CSCS_sidebar.yaml delete mode 100644 _data/sidebars/meg_sidebar.yml delete mode 100644 _data/strings.yml delete mode 100644 _data/tags.yml delete mode 100644 _data/terms.yml delete mode 100644 _data/topnav.yml delete mode 100644 _includes/archive.html delete mode 100644 _includes/callout.html delete mode 100644 _includes/custom/getting_started_series.html delete mode 100644 _includes/custom/getting_started_series_next.html delete mode 100644 _includes/custom/series_acme.html delete mode 100644 _includes/custom/series_acme_next.html delete mode 100644 _includes/custom/usermap.html delete mode 100644 _includes/custom/usermapcomplex.html delete mode 100644 _includes/disqus.html delete mode 100644 _includes/feedback.html delete mode 100755 _includes/footer.html delete mode 100644 _includes/google_analytics.html delete mode 100644 _includes/head.html delete mode 100644 _includes/head_print.html delete mode 100644 _includes/image.html delete mode 100644 _includes/important.html delete mode 100644 _includes/initialize_shuffle.html delete mode 100644 _includes/inline_image.html delete mode 100644 _includes/links.html delete mode 100644 _includes/note.html delete mode 100644 _includes/sidebar.html delete mode 100644 _includes/taglogic.html delete mode 100644 _includes/tip.html delete mode 100644 _includes/toc.html delete mode 100644 _includes/topnav.html delete mode 100644 _includes/warning.html delete mode 100644 _layouts/default.html delete mode 100644 _layouts/default_print.html delete mode 100644 _layouts/none.html delete mode 100644 _layouts/page.html delete mode 100644 _layouts/page_print.html delete mode 100644 _layouts/post.html delete mode 100644 _posts/2019-06-12-launching-merlin6-docs.md delete mode 100644 _tooltips/baseball.html delete mode 100644 _tooltips/basketball.html delete mode 100644 _tooltips/football.html delete mode 100644 _tooltips/soccer.html delete mode 100644 apple-touch-icon.png create mode 100644 compose.yml delete mode 100644 createtag delete mode 100644 css/bootstrap.min.css delete mode 100644 css/boxshadowproperties.css delete mode 100644 css/customstyles.css delete mode 100644 css/font-awesome.min.css delete mode 100644 css/fonts/FontAwesome.otf delete mode 100644 css/fonts/fontawesome-webfont.eot delete mode 100644 css/fonts/fontawesome-webfont.svg delete mode 100644 css/fonts/fontawesome-webfont.ttf delete mode 100644 css/fonts/fontawesome-webfont.woff delete mode 100644 css/fonts/fontawesome-webfont.woff2 delete mode 100755 css/modern-business.css delete mode 100644 css/printstyles.css delete mode 100644 css/syntax.css delete mode 100644 css/theme-blue.css delete mode 100644 css/theme-green.css delete mode 100644 docker-compose.yml rename {pages/CSCS => docs/cscs-userlab}/downloads/CSCS/PSI_CSCSAllocations2023.xltx (100%) rename {pages/CSCS => docs/cscs-userlab}/index.md (70%) rename {pages/CSCS => docs/cscs-userlab}/transfer-data.md (78%) rename {pages => docs}/gmerlin6/cluster-introduction.md (90%) rename {pages => docs}/gmerlin6/hardware-and-software-description.md (95%) rename {pages => docs}/gmerlin6/slurm-configuration.md (98%) rename {images => docs/images}/ANSYS/HFSS/01_Select_Scheduler_Menu.png (100%) rename {images => docs/images}/ANSYS/HFSS/02_Select_Scheduler_RSM_Remote.png (100%) rename {images => docs/images}/ANSYS/HFSS/03_Select_Scheduler_Slurm.png (100%) rename {images => docs/images}/ANSYS/HFSS/04_Submit_Job_Menu.png (100%) rename {images => docs/images}/ANSYS/HFSS/05_Submit_Job_Product_Path.png (100%) rename {images => docs/images}/ANSYS/cfx5launcher.png (100%) rename {images => docs/images}/ANSYS/merlin7/HFSS/01_Select_Scheduler_Menu.png (100%) rename {images => docs/images}/ANSYS/merlin7/HFSS/02_Select_Scheduler_RSM_Remote.png (100%) rename {images => docs/images}/ANSYS/merlin7/HFSS/03_Select_Scheduler_Slurm.png (100%) rename {images => docs/images}/ANSYS/merlin7/HFSS/04_Submit_Job_Menu.png (100%) rename {images => docs/images}/ANSYS/merlin7/HFSS/05_Submit_Job_Product_Path.png (100%) rename {images => docs/images}/ANSYS/merlin7/cfx5launcher.png (100%) rename {images => docs/images}/ANSYS/merlin7/merlin7/cfx5launcher.png (100%) rename {images => docs/images}/ANSYS/merlin7/rsm-1-add_hpc_resource.png (100%) rename {images => docs/images}/ANSYS/merlin7/rsm-2-add_cluster.png (100%) rename {images => docs/images}/ANSYS/merlin7/rsm-3-add_scratch_info.png (100%) rename {images => docs/images}/ANSYS/merlin7/rsm-4-get_slurm_queues.png (100%) rename {images => docs/images}/ANSYS/merlin7/rsm-5-authenticating.png (100%) rename {images => docs/images}/ANSYS/merlin7/rsm-6-selected-partitions.png (100%) rename {images => docs/images}/ANSYS/rsm-1-add_hpc_resource.png (100%) rename {images => docs/images}/ANSYS/rsm-2-add_cluster.png (100%) rename {images => docs/images}/ANSYS/rsm-3-add_scratch_info.png (100%) rename {images => docs/images}/ANSYS/rsm-4-get_slurm_queues.png (100%) rename {images => docs/images}/ANSYS/rsm-5-authenticating.png (100%) rename {images => docs/images}/ANSYS/rsm-6-selected-partitions.png (100%) rename {images => docs/images}/Access/01-request-merlin5-membership.png (100%) rename {images => docs/images}/Access/01-request-merlin6-membership.png (100%) rename {images => docs/images}/Access/01-request-merlin7-membership.png (100%) rename {images => docs/images}/Access/01-request-unx-group-membership.png (100%) rename {images => docs/images}/PuTTY/Putty_Disable_Kerberos_GSSAPI.png (100%) rename {images => docs/images}/PuTTY/Putty_Mouse_XTerm.png (100%) rename {images => docs/images}/PuTTY/Putty_Session.png (100%) rename {images => docs/images}/PuTTY/Putty_X11_Forwarding.png (100%) rename {images => docs/images}/WIP/WIP1.jpeg (100%) rename {images => docs/images}/WIP/WIP1.webp (100%) rename favicon.ico => docs/images/favicon.ico (100%) create mode 100644 docs/images/front_page.png create mode 100644 docs/images/hpce_logo.png rename images/hpce_logo.png => docs/images/hpce_logo_full.png (100%) rename {images => docs/images/jupyter}/jupyter-launch-classic.png (100%) rename {images => docs/images/jupyter}/jupyter-nbextensions.png (100%) rename {images => docs/images/jupyter}/jupytext_menu.png (100%) rename {images => docs/images}/merlin-slurm-architecture.png (100%) rename {images => docs/images}/merlinschema3.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx1.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx10.png (100%) create mode 100644 docs/images/nomachine/screen_nx11.png rename {images/NoMachine => docs/images/nomachine}/screen_nx2.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx3.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx4.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx5.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx6.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx7.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx8.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx9.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx_address.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx_auth.png (100%) rename {images/NoMachine => docs/images/nomachine}/screen_nx_configuration.png (100%) create mode 100644 docs/images/nomachine/screen_nx_connect.png create mode 100644 docs/images/nomachine/screen_nx_existingsession.png create mode 100644 docs/images/nomachine/screen_nx_newsession.png rename {images/NoMachine => docs/images/nomachine}/screen_nx_single_session.png (100%) rename {images => docs/images}/psi-logo.png (100%) rename {images => docs/images}/rmount/mount.png (100%) rename {images => docs/images}/rmount/select-mount.png (100%) rename {images => docs/images}/rmount/thunar_mount.png (100%) rename {images => docs/images}/scicat_token.png (100%) rename {images/Slurm => docs/images/slurm}/scom.gif (100%) rename {images/Slurm => docs/images/slurm}/sview.png (100%) create mode 100644 docs/index.md rename {pages/meg/99-support => docs/meg}/contact.md (54%) create mode 100644 docs/meg/index.md rename {pages/meg/99-support => docs/meg}/migration-to-merlin7.md (83%) rename {pages => docs}/merlin5/cluster-introduction.md (89%) rename {pages => docs}/merlin5/hardware-and-software-description.md (92%) rename {pages => docs}/merlin5/slurm-configuration.md (100%) rename {pages => docs}/merlin6/98-announcements/downtimes.md (97%) rename {pages => docs}/merlin6/98-announcements/past-downtimes.md (100%) rename {pages => docs}/merlin6/99-support/contact.md (100%) rename {pages => docs}/merlin6/99-support/faq.md (75%) rename {pages => docs}/merlin6/99-support/known-problems.md (94%) rename {pages => docs}/merlin6/99-support/migration-from-merlin5.md (95%) rename {pages => docs}/merlin6/99-support/troubleshooting.md (91%) rename {pages => docs}/merlin6/cluster-introduction.md (78%) rename {pages => docs}/merlin6/hardware-and-software-description.md (100%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/archive.md (76%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/connect-from-linux.md (50%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/connect-from-macos.md (88%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/connect-from-windows.md (73%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/kerberos.md (97%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/nomachine.md (76%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/ssh-keys.md (100%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/storage.md (62%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/transfer-data.md (82%) rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/how-to-use-merlin}/using-modules.md (99%) rename {pages/merlin6/04-Jupyterhub => docs/merlin6/jupyterhub}/jupyter-examples.md (61%) create mode 100644 docs/merlin6/jupyterhub/jupyter-extensions.md create mode 100644 docs/merlin6/jupyterhub/jupyterhub-trouble.md rename {pages/merlin6/04-Jupyterhub => docs/merlin6/jupyterhub}/jupyterhub.md (55%) rename {pages/merlin6/04-Jupyterhub => docs/merlin6/jupyterhub}/jupyterlab.md (50%) create mode 100644 docs/merlin6/jupyterhub/jupytext.md rename {pages/merlin6/01-Quick-Start-Guide => docs/merlin6/quick-start-guide}/accessing-interactive-nodes.md (67%) rename {pages/merlin6/01-Quick-Start-Guide => docs/merlin6/quick-start-guide}/accessing-slurm.md (61%) create mode 100644 docs/merlin6/quick-start-guide/code-of-conduct.md rename {pages/merlin6/01-Quick-Start-Guide => docs/merlin6/quick-start-guide}/introduction.md (54%) rename {pages/merlin6/01-Quick-Start-Guide => docs/merlin6/quick-start-guide}/requesting-accounts.md (86%) rename {pages/merlin6/01-Quick-Start-Guide => docs/merlin6/quick-start-guide}/requesting-projects.md (86%) rename {pages => docs}/merlin6/slurm-configuration.md (92%) create mode 100644 docs/merlin6/slurm-general-docs/interactive-jobs.md create mode 100644 docs/merlin6/slurm-general-docs/monitoring.md rename {pages/merlin6/03-Slurm-General-Documentation => docs/merlin6/slurm-general-docs}/running-jobs.md (74%) rename {pages/merlin6/03-Slurm-General-Documentation => docs/merlin6/slurm-general-docs}/slurm-basic-commands.md (85%) rename {pages/merlin6/03-Slurm-General-Documentation => docs/merlin6/slurm-general-docs}/slurm-examples.md (89%) rename {pages/merlin6/05-Software-Support => docs/merlin6/software-support}/ansys-cfx.md (76%) rename {pages/merlin6/05-Software-Support => docs/merlin6/software-support}/ansys-fluent.md (54%) rename {pages/merlin6/05-Software-Support => docs/merlin6/software-support}/ansys-hfss.md (50%) rename {pages/merlin6/05-Software-Support => docs/merlin6/software-support}/ansys-mapdl.md (73%) create mode 100644 docs/merlin6/software-support/ansys-rsm.md create mode 100644 docs/merlin6/software-support/ansys.md create mode 100644 docs/merlin6/software-support/gothic.md create mode 100644 docs/merlin6/software-support/impi.md rename {pages/merlin6/02-How-To-Use-Merlin => docs/merlin6/software-support}/merlin-rmount.md (69%) create mode 100644 docs/merlin6/software-support/openmpi.md create mode 100644 docs/merlin6/software-support/paraview.md rename {pages/merlin6/05-Software-Support => docs/merlin6/software-support}/python.md (67%) rename {pages => docs}/merlin7/01-Quick-Start-Guide/accessing-interactive-nodes.md (75%) rename {pages => docs}/merlin7/01-Quick-Start-Guide/accessing-slurm.md (81%) rename {pages => docs}/merlin7/01-Quick-Start-Guide/code-of-conduct.md (86%) rename {pages => docs}/merlin7/01-Quick-Start-Guide/introduction.md (96%) rename {pages => docs}/merlin7/01-Quick-Start-Guide/requesting-accounts.md (92%) rename {pages => docs}/merlin7/01-Quick-Start-Guide/requesting-projects.md (98%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/archive.md (96%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/connect-from-linux.md (85%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/connect-from-macos.md (88%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/connect-from-windows.md (56%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/kerberos.md (98%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/merlin-rmount.md (86%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/merlin_tools.md (90%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/nomachine.md (94%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/software-repositories.md (78%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/ssh-keys.md (100%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/storage.md (74%) rename {pages => docs}/merlin7/02-How-To-Use-Merlin/transfer-data.md (90%) rename {pages => docs}/merlin7/03-Slurm-General-Documentation/interactive-jobs.md (89%) rename {pages => docs}/merlin7/03-Slurm-General-Documentation/merlin7-configuration.md (100%) rename {pages => docs}/merlin7/03-Slurm-General-Documentation/slurm-configuration.md (89%) rename {pages => docs}/merlin7/03-Slurm-General-Documentation/slurm-examples.md (100%) rename {pages => docs}/merlin7/04-Jupyterhub/jupyterhub.md (96%) rename {pages => docs}/merlin7/05-Software-Support/ansys-rsm.md (80%) rename {pages => docs}/merlin7/05-Software-Support/ansys.md (77%) rename {pages => docs}/merlin7/05-Software-Support/cp2k.md (100%) rename {pages => docs}/merlin7/05-Software-Support/cray-module.env.md (100%) rename {pages => docs}/merlin7/05-Software-Support/gromacs.md (100%) rename {pages => docs}/merlin7/05-Software-Support/ippl.md (100%) rename {pages => docs}/merlin7/05-Software-Support/lammps.md (100%) rename {pages => docs}/merlin7/05-Software-Support/opal-x.md (100%) rename {pages => docs}/merlin7/05-Software-Support/openmpi.md (78%) rename {pages => docs}/merlin7/05-Software-Support/pmodules.md (97%) rename {pages => docs}/merlin7/05-Software-Support/quantum-espresso.md (100%) rename {pages => docs}/merlin7/05-Software-Support/spack.md (100%) rename {pages => docs}/merlin7/99-support/contact.md (100%) rename {pages => docs}/merlin7/99-support/migration-from-merlin6.md (95%) create mode 100644 docs/news/index.md create mode 100644 docs/news/posts/launching-merlin6-docs.md rename _posts/2024-08-07-merlin7-preprod-docs.md => docs/news/posts/merlin7-preprod-docs.md (50%) delete mode 100644 favicon-16x16.png delete mode 100644 favicon-32x32.png delete mode 100644 feed.xml delete mode 100644 fonts/glyphicons-halflings-regular.eot delete mode 100644 fonts/glyphicons-halflings-regular.svg delete mode 100644 fonts/glyphicons-halflings-regular.ttf delete mode 100644 fonts/glyphicons-halflings-regular.woff delete mode 100644 fonts/glyphicons-halflings-regular.woff2 delete mode 100644 images/favicon.ico delete mode 100644 index.md delete mode 100644 js/anchor.min.js delete mode 100644 js/bootstrap.min.js delete mode 100644 js/customscripts.js delete mode 100644 js/html5shiv.js delete mode 100644 js/jekyll-search.js delete mode 100644 js/jquery.ba-throttle-debounce.min.js delete mode 100644 js/jquery.cookie.min.js delete mode 100644 js/jquery.min.js delete mode 100755 js/jquery.navgoco.min.js delete mode 100644 js/jquery.shuffle.min.js delete mode 100644 js/respond.min.js delete mode 100644 js/toc.js delete mode 100644 licenses/LICENSE delete mode 100644 licenses/LICENSE-BSD-NAVGOCO.txt create mode 100644 mkdocs.yml delete mode 100644 pages/meg/01-Quick-Start-Guide/introduction.md delete mode 100644 pages/merlin6/01-Quick-Start-Guide/code-of-conduct.md delete mode 100644 pages/merlin6/03-Slurm-General-Documentation/interactive-jobs.md delete mode 100644 pages/merlin6/03-Slurm-General-Documentation/monitoring.md delete mode 100644 pages/merlin6/04-Jupyterhub/jupyter-extensions.md delete mode 100644 pages/merlin6/04-Jupyterhub/jupyterhub-trouble.md delete mode 100644 pages/merlin6/04-Jupyterhub/jupytext.md delete mode 100644 pages/merlin6/05-Software-Support/ansys-rsm.md delete mode 100644 pages/merlin6/05-Software-Support/ansys.md delete mode 100644 pages/merlin6/05-Software-Support/gothic.md delete mode 100644 pages/merlin6/05-Software-Support/impi.md delete mode 100644 pages/merlin6/05-Software-Support/openmpi.md delete mode 100644 pages/merlin6/05-Software-Support/paraview.md delete mode 100644 pages/news/news.html delete mode 100644 pages/news/news_archive.html delete mode 100644 pages/tags/tag_collaboration.md delete mode 100644 pages/tags/tag_content_types.md delete mode 100644 pages/tags/tag_formatting.md delete mode 100644 pages/tags/tag_getting_started.md delete mode 100644 pages/tags/tag_mobile.md delete mode 100644 pages/tags/tag_navigation.md delete mode 100644 pages/tags/tag_news.md delete mode 100644 pages/tags/tag_publishing.md delete mode 100644 pages/tags/tag_single_sourcing.md delete mode 100644 pages/tags/tag_special_layouts.md delete mode 100644 pages/tags/tag_troubleshooting.md delete mode 100644 pdf-all.sh delete mode 100644 pdf-mydoc.sh delete mode 100644 pdf-product1.sh delete mode 100644 pdf-product2.sh delete mode 100644 pdfconfigs/config_mydoc_pdf.yml delete mode 100644 pdfconfigs/config_product1_pdf.yml delete mode 100644 pdfconfigs/config_product2_pdf.yml delete mode 100644 pdfconfigs/prince-list.txt delete mode 100644 pdfconfigs/titlepage.html delete mode 100644 pdfconfigs/tocpage.html delete mode 100644 search.json delete mode 100644 siteinfo.md delete mode 100644 sitemap.xml delete mode 100644 tooltips.html delete mode 100644 tooltips.json delete mode 100644 var/build.sh diff --git a/.gitea/workflows/deploy-pages.yml b/.gitea/workflows/deploy-pages.yml deleted file mode 100644 index 3588b20..0000000 --- a/.gitea/workflows/deploy-pages.yml +++ /dev/null @@ -1,39 +0,0 @@ ---- -name: Build and Deploy Documentation - -on: - push: - branches: - - master - workflow_dispatch: - -jobs: - build-and-deploy: - runs-on: ubuntu-latest - container: - image: gitea.psi.ch/hpce/gitea-pages - env: - JEKYLL_ENV: production - steps: - - name: Checkout repository - uses: actions/checkout@v3 - - - name: Build Jekyll website - run: | - bundle exec jekyll --version - bundle exec jekyll build -d public - - - name: Configure Git - run: | - git config --global user.name "Gitea Actions" - git config --global user.email "actions@gitea.local" - - - name: Push to gitea-pages branch - run: | - git checkout --orphan gitea-pages - git reset --hard - ls -la - cp -r ./public/* . - git add . - git commit -m "Deploy site" - git push -f https://${{secrets.GITHUB_TOKEN}}@gitea.psi.ch/${{ github.repository }}.git gitea-pages diff --git a/.gitignore b/.gitignore index e05415b..2e6d3cc 100644 --- a/.gitignore +++ b/.gitignore @@ -1,10 +1,3 @@ -_site/ -.sass-cache/ -.jekyll-metadata -_pdf -.DS_Store -.idea -vendor/ -.bundle/ -.ruby-gemset -.ruby-version +# mkdocs +.cache/ +site/ diff --git a/404.md b/404.md deleted file mode 100644 index fc5a54b..0000000 --- a/404.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: "Page Not Found" -search: exclude ---- - -Sorry, but the page you were trying to view does not exist. Try searching for it or looking at the URL to see if it looks correct. diff --git a/Dockerfile b/Dockerfile index 05da615..23e6f76 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,24 +1,4 @@ -FROM alpine:3.13 +FROM docker.io/squidfunk/mkdocs-material:9.7 -WORKDIR /tmp -COPY Gemfile /tmp/ -COPY Gemfile.lock /tmp/ - -RUN apk list -I && apk --no-cache add \ - libatomic readline readline-dev libxml2 libxml2-dev \ - ncurses-terminfo-base ncurses-terminfo \ - libxslt libxslt-dev zlib-dev zlib \ - ruby ruby-dev yaml yaml-dev \ - libffi-dev build-base git nodejs \ - && gem env \ - && gem install etc --no-document \ - && gem install bundler -v 2.4.22 --no-document \ - && pwd \ - && ls -l \ - && bundle install - -VOLUME /src -EXPOSE 4001 - -WORKDIR /src -CMD ["jekyll", "serve", "--livereload", "-H", "0.0.0.0"] +# add some plugins +RUN pip install mkdocs-glightbox=='0.5.*' diff --git a/Gemfile b/Gemfile deleted file mode 100644 index c4e9e6b..0000000 --- a/Gemfile +++ /dev/null @@ -1,23 +0,0 @@ -source "https://rubygems.org" - -# to publish on github page -# gem 'github-pages', group: :jekyll_plugins -gem 'github-pages', "~> 215" - -# to publish without github page -# gem "jekyll-redirect-from", group: :jekyll_plugins -gem "jekyll-redirect-from", "~> 0.16.0" -gem "json", "~> 2.2" -gem "webrick", "~> 1.7.0" -gem "etc", "~> 1.2.0" -gem "bigdecimal", "~> 1.4" -gem 'eventmachine', "~> 1.2.7" -gem 'faraday', "~> 1.4.3" -gem 'addressable', "~> 2.7.0" -gem 'faraday-net_http_persistent', "~> 1.1.0" -gem 'ruby2_keywords', "~> 0.0.4" -gem 'rubyzip', "~> 2.3.0" -# -gem 'ffi', "~> 1.15.3" -gem 'http_parser.rb', "~> 0.6.0" # requires mkdir in /usr/bin/mkdir -gem "jekyll", "~> 3.9.0" diff --git a/Gemfile.lock b/Gemfile.lock deleted file mode 100644 index 5e5a27a..0000000 --- a/Gemfile.lock +++ /dev/null @@ -1,292 +0,0 @@ -GEM - remote: https://rubygems.org/ - specs: - activesupport (6.0.6.1) - concurrent-ruby (~> 1.0, >= 1.0.2) - i18n (>= 0.7, < 2) - minitest (~> 5.1) - tzinfo (~> 1.1) - zeitwerk (~> 2.2, >= 2.2.2) - addressable (2.7.0) - public_suffix (>= 2.0.2, < 5.0) - bigdecimal (1.4.4) - coffee-script (2.4.1) - coffee-script-source - execjs - coffee-script-source (1.11.1) - colorator (1.1.0) - commonmarker (0.17.13) - ruby-enum (~> 0.5) - concurrent-ruby (1.2.3) - dnsruby (1.70.0) - simpleidn (~> 0.2.1) - em-websocket (0.5.3) - eventmachine (>= 0.12.9) - http_parser.rb (~> 0) - etc (1.2.0) - ethon (0.16.0) - ffi (>= 1.15.0) - eventmachine (1.2.7) - execjs (2.9.1) - faraday (1.4.3) - faraday-em_http (~> 1.0) - faraday-em_synchrony (~> 1.0) - faraday-excon (~> 1.1) - faraday-net_http (~> 1.0) - faraday-net_http_persistent (~> 1.1) - multipart-post (>= 1.2, < 3) - ruby2_keywords (>= 0.0.4) - faraday-em_http (1.0.0) - faraday-em_synchrony (1.0.0) - faraday-excon (1.1.0) - faraday-net_http (1.0.1) - faraday-net_http_persistent (1.1.0) - ffi (1.15.5) - forwardable-extended (2.6.0) - gemoji (3.0.1) - github-pages (215) - github-pages-health-check (= 1.17.2) - jekyll (= 3.9.0) - jekyll-avatar (= 0.7.0) - jekyll-coffeescript (= 1.1.1) - jekyll-commonmark-ghpages (= 0.1.6) - jekyll-default-layout (= 0.1.4) - jekyll-feed (= 0.15.1) - jekyll-gist (= 1.5.0) - jekyll-github-metadata (= 2.13.0) - jekyll-mentions (= 1.6.0) - jekyll-optional-front-matter (= 0.3.2) - jekyll-paginate (= 1.1.0) - jekyll-readme-index (= 0.3.0) - jekyll-redirect-from (= 0.16.0) - jekyll-relative-links (= 0.6.1) - jekyll-remote-theme (= 0.4.3) - jekyll-sass-converter (= 1.5.2) - jekyll-seo-tag (= 2.7.1) - jekyll-sitemap (= 1.4.0) - jekyll-swiss (= 1.0.0) - jekyll-theme-architect (= 0.1.1) - jekyll-theme-cayman (= 0.1.1) - jekyll-theme-dinky (= 0.1.1) - jekyll-theme-hacker (= 0.1.2) - jekyll-theme-leap-day (= 0.1.1) - jekyll-theme-merlot (= 0.1.1) - jekyll-theme-midnight (= 0.1.1) - jekyll-theme-minimal (= 0.1.1) - jekyll-theme-modernist (= 0.1.1) - jekyll-theme-primer (= 0.5.4) - jekyll-theme-slate (= 0.1.1) - jekyll-theme-tactile (= 0.1.1) - jekyll-theme-time-machine (= 0.1.1) - jekyll-titles-from-headings (= 0.5.3) - jemoji (= 0.12.0) - kramdown (= 2.3.1) - kramdown-parser-gfm (= 1.1.0) - liquid (= 4.0.3) - mercenary (~> 0.3) - minima (= 2.5.1) - nokogiri (>= 1.10.4, < 2.0) - rouge (= 3.26.0) - terminal-table (~> 1.4) - github-pages-health-check (1.17.2) - addressable (~> 2.3) - dnsruby (~> 1.60) - octokit (~> 4.0) - public_suffix (>= 2.0.2, < 5.0) - typhoeus (~> 1.3) - html-pipeline (2.14.3) - activesupport (>= 2) - nokogiri (>= 1.4) - http_parser.rb (0.6.0) - i18n (0.9.5) - concurrent-ruby (~> 1.0) - jekyll (3.9.0) - addressable (~> 2.4) - colorator (~> 1.0) - em-websocket (~> 0.5) - i18n (~> 0.7) - jekyll-sass-converter (~> 1.0) - jekyll-watch (~> 2.0) - kramdown (>= 1.17, < 3) - liquid (~> 4.0) - mercenary (~> 0.3.3) - pathutil (~> 0.9) - rouge (>= 1.7, < 4) - safe_yaml (~> 1.0) - jekyll-avatar (0.7.0) - jekyll (>= 3.0, < 5.0) - jekyll-coffeescript (1.1.1) - coffee-script (~> 2.2) - coffee-script-source (~> 1.11.1) - jekyll-commonmark (1.3.1) - commonmarker (~> 0.14) - jekyll (>= 3.7, < 5.0) - jekyll-commonmark-ghpages (0.1.6) - commonmarker (~> 0.17.6) - jekyll-commonmark (~> 1.2) - rouge (>= 2.0, < 4.0) - jekyll-default-layout (0.1.4) - jekyll (~> 3.0) - jekyll-feed (0.15.1) - jekyll (>= 3.7, < 5.0) - jekyll-gist (1.5.0) - octokit (~> 4.2) - jekyll-github-metadata (2.13.0) - jekyll (>= 3.4, < 5.0) - octokit (~> 4.0, != 4.4.0) - jekyll-mentions (1.6.0) - html-pipeline (~> 2.3) - jekyll (>= 3.7, < 5.0) - jekyll-optional-front-matter (0.3.2) - jekyll (>= 3.0, < 5.0) - jekyll-paginate (1.1.0) - jekyll-readme-index (0.3.0) - jekyll (>= 3.0, < 5.0) - jekyll-redirect-from (0.16.0) - jekyll (>= 3.3, < 5.0) - jekyll-relative-links (0.6.1) - jekyll (>= 3.3, < 5.0) - jekyll-remote-theme (0.4.3) - addressable (~> 2.0) - jekyll (>= 3.5, < 5.0) - jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0) - rubyzip (>= 1.3.0, < 3.0) - jekyll-sass-converter (1.5.2) - sass (~> 3.4) - jekyll-seo-tag (2.7.1) - jekyll (>= 3.8, < 5.0) - jekyll-sitemap (1.4.0) - jekyll (>= 3.7, < 5.0) - jekyll-swiss (1.0.0) - jekyll-theme-architect (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-cayman (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-dinky (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-hacker (0.1.2) - jekyll (> 3.5, < 5.0) - jekyll-seo-tag (~> 2.0) - jekyll-theme-leap-day (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-merlot (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-midnight (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-minimal (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-modernist (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-primer (0.5.4) - jekyll (> 3.5, < 5.0) - jekyll-github-metadata (~> 2.9) - jekyll-seo-tag (~> 2.0) - jekyll-theme-slate (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-tactile (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-theme-time-machine (0.1.1) - jekyll (~> 3.5) - jekyll-seo-tag (~> 2.0) - jekyll-titles-from-headings (0.5.3) - jekyll (>= 3.3, < 5.0) - jekyll-watch (2.2.1) - listen (~> 3.0) - jemoji (0.12.0) - gemoji (~> 3.0) - html-pipeline (~> 2.2) - jekyll (>= 3.0, < 5.0) - json (2.7.1) - kramdown (2.3.1) - rexml - kramdown-parser-gfm (1.1.0) - kramdown (~> 2.0) - liquid (4.0.3) - listen (3.8.0) - rb-fsevent (~> 0.10, >= 0.10.3) - rb-inotify (~> 0.9, >= 0.9.10) - mercenary (0.3.6) - mini_portile2 (2.8.5) - minima (2.5.1) - jekyll (>= 3.5, < 5.0) - jekyll-feed (~> 0.9) - jekyll-seo-tag (~> 2.1) - minitest (5.21.2) - multipart-post (2.3.0) - nokogiri (1.15.5) - mini_portile2 (~> 2.8.2) - racc (~> 1.4) - octokit (4.25.1) - faraday (>= 1, < 3) - sawyer (~> 0.9) - pathutil (0.16.2) - forwardable-extended (~> 2.6) - public_suffix (4.0.7) - racc (1.7.3) - rb-fsevent (0.11.2) - rb-inotify (0.10.1) - ffi (~> 1.0) - rexml (3.2.6) - rouge (3.26.0) - ruby-enum (0.9.0) - i18n - ruby2_keywords (0.0.5) - rubyzip (2.3.2) - safe_yaml (1.0.5) - sass (3.7.4) - sass-listen (~> 4.0.0) - sass-listen (4.0.0) - rb-fsevent (~> 0.9, >= 0.9.4) - rb-inotify (~> 0.9, >= 0.9.7) - sawyer (0.9.2) - addressable (>= 2.3.5) - faraday (>= 0.17.3, < 3) - simpleidn (0.2.1) - unf (~> 0.1.4) - terminal-table (1.8.0) - unicode-display_width (~> 1.1, >= 1.1.1) - thread_safe (0.3.6) - typhoeus (1.4.1) - ethon (>= 0.9.0) - tzinfo (1.2.11) - thread_safe (~> 0.1) - unf (0.1.4) - unf_ext - unf_ext (0.0.9.1) - unicode-display_width (1.8.0) - webrick (1.7.0) - zeitwerk (2.6.12) - -PLATFORMS - ruby - x86_64-linux - -DEPENDENCIES - addressable (~> 2.7.0) - bigdecimal (~> 1.4) - etc (~> 1.2.0) - eventmachine (~> 1.2.7) - faraday (~> 1.4.3) - faraday-net_http_persistent (~> 1.1.0) - ffi (~> 1.15.3) - github-pages (~> 215) - http_parser.rb (~> 0.6.0) - jekyll (~> 3.9.0) - jekyll-redirect-from (~> 0.16.0) - json (~> 2.2) - ruby2_keywords (~> 0.0.4) - rubyzip (~> 2.3.0) - webrick (~> 1.7.0) - -BUNDLED WITH - 2.3.26 diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..f251995 --- /dev/null +++ b/LICENSE @@ -0,0 +1,9 @@ +MIT License + +Copyright (c) 2025 PSI + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/README.md b/README.md index 310b5aa..212de32 100644 --- a/README.md +++ b/README.md @@ -1,74 +1,50 @@ # HPCE Documentation -This site contains internal documentation of HCPE services at Paul Scherrer Institute, particularly the *Merlin 6* and *Merlin 7* clusters. -Live pages are available at . +This site contains internal documentation of HCPE services at Paul Scherrer +Institute, particularly the *Merlin 6* and *Merlin 7* clusters. Live pages are +available at . -## Installation +## Development -### Docker +### Using Docker Compose (Recommended) -The easiest and most reproducable way to test changes is using docker. -From the top directory, run the following: +```bash +# Start the development server +docker compose up -```console -$ docker compose build -$ docker compose up +# Or run in background +docker compose up -d ``` -This will start a webserver on `http://0.0.0.0:4001/`. Changes to most pages -will be automatically reflected in the website (with the exception of changes -to `config.yml`, which requires restarting the webserver). +The documentation will be available at `http://localhost:8000`. -### Running locally +> [!NOTE] +> We use several MkDocs plugins, which need to be installed by hand. We do this by +> using a Dockerfile that pulls in the `squidfunk/mkdocs-material` image and runs +> some `pip install` commands. This means that on the first `compose up` call, a +> new docker image will be built locally on your machine. -Building locally requires ruby 2.5 and bundler. To install: +### Deployment -```console -$ gem install bundler jekyll -$ bundle -``` +The site is automatically deployed to `https://hpce.pages.psi.ch/` via Gitea Pages. -To run a local webserver: +## Contributing -```console -$ bundle exec jekyll serve -``` +Please follow established conventions when adding new documentation: -## Theme +1. Use clear, descriptive filenames +2. Follow the existing directory structure +3. Include appropriate metadata in frontmatter +4. Test locally before committing -The theme is derived from the -[Jekyll Doc Theme 6.0](https://github.com/tomjoht/documentation-theme-jekyll) -by Tom Johnson. +## Repository Structure -### Organization +TBD -- Documentation is organized within the `pages` directory -- Add the following frontmatter to each (Merlin6) page: +## Contact - ```md - --- - title: Introduction - sidebar: merlin6_sidebar - permalink: /merlin6/introduction.html - keywords: key1, key2 - --- - ``` - -- Sidebars are specified in data files, e.g. `_data/sidebars/merlin6_sidebar.yml`. -- The top menu is controlled by `_data/topnav.yml` -- News can be addin in `_posts`. Filenames must include the date. -- Lots of features still need to be configured (e.g. pdf output, tags, etc) -- The search bar uses finds substring of the title, tags, keywords, and summary frontmatter. - -## Deployment - -We use the Gitea workflow (see `.gitea/workflow/deploy-pages.yml` for details). The -pages are automatically re-generated on each push to `master` branch. The resulting website -is stored under the `gitea-pages` branch, and is automatically exposed. +For questions or issues with this documentation, contact the HPCE team. ## License Theme content is licensed under the MIT license. -The Navgoco jQuery component used in the sidebar is licensed under the BSD -license. -See licenses subdirectory for license terms. diff --git a/_config.yml b/_config.yml deleted file mode 100644 index c3bfeba..0000000 --- a/_config.yml +++ /dev/null @@ -1,128 +0,0 @@ -output: web -# this property is useful for conditional filtering of content that is separate from the PDF. - -topnav_title: HPCE@PSI -# this appears on the top navigation bar next to the home button - -site_title: HPC and Emerging Technologies Documentation -# this appears in the html browser tab for the site title (seen mostly by search engines, not users) - -company_name: Paul Scherrer Institute, CSD/HPC and Emerging Technologies Group -# this appears in the footer - -github_editme_path: -# github_editme_path: tomjoht/documentation-theme-jekyll/blob/gh-pages/ -# if you're using Github, provide the basepath to the branch you've created for reviews, following the sample here. if not, leave this value blank. - -# gitlab_editme_path: tomjoht/documentation-theme-jekyll/blob/gh-pages/ -# if you're using GitLab, provide the basepath to the branch you've created for reviews, following the sample here. if not, leave this value blank. - -google_analytics: -#google_analytics: UA-66296557-1 -# if you have google-analytics ID, put it in. if not, edit this value to blank. - -host: 127.0.0.1 -# the preview server used. Leave as is. - -port: 4001 -# the port where the preview is rendered. You can leave this as is unless you have other Jekyll builds using this same port that might cause conflicts. in that case, use another port such as 4006. - -exclude: - - README.md - - .idea/ - - .gitignore - - vendor - - .vscode -# these are the files and directories that jekyll will exclude from the build - -feedback_subject_line: HPCE Documentation feedback - -feedback_email: merlin-admins@lists.psi.ch -# feedback_email: tomjoht@gmail.com -# used as a contact email for the Feedback link in the top navigation bar - -# feedback_disable: true -# if you uncomment the previous line, the Feedback link gets removed - -# feedback_text: "Need help?" -# if you uncomment the previous line, it changes the Feedback text - -# feedback_link: "http://helpy.io/" -# if you uncomment the previous line, it changes where the feedback link points to - -plugins: - - jekyll-redirect-from - -whitelist: - - jekyll-redirect-from - -highlighter: rouge -# library used for syntax highlighting - -markdown: kramdown -kramdown: - input: GFM - auto_ids: true - hard_wrap: false - syntax_highlighter: rouge - -# filter used to process markdown. note that kramdown differs from github-flavored markdown in some subtle ways - -collections: - tooltips: - output: false -# collections are declared here. this renders the content in _tooltips and processes it, but doesn't output it as actual files in the output unless you change output to true - -defaults: - - - scope: - path: "" - type: "pages" - values: - layout: "page" - comments: true - # if you don't want to use Commento.io and just hide comments, change true to false wherever you see the comments property - search: true - sidebar: home_sidebar - topnav: topnav - - - scope: - path: "" - type: "tooltips" - values: - layout: "page" - comments: true - # if you don't want to use Commento.io and just hide comments, change true to false wherever you see the comments property - search: true - tooltip: true - - - - scope: - path: "" - type: "posts" - values: - layout: "post" - comments: true - # if you don't want to use Commento.io and just hide comments, change true to false wherever you see the comments property - search: true - sidebar: home_sidebar - topnav: topnav - -# these are defaults used for the frontmatter for these file types - -sidebars: -- home_sidebar -- mydoc_sidebar -- product1_sidebar -- product2_sidebar -- other - -description: "Merlin is the HPC cluster at Paul Scherrer Institute in Switzerland." -# the description is used in the feed.xml file - -# needed for sitemap.xml file only -url: "https://hpce.pages.psi.ch" -baseurl: / - - -github: [metadata] diff --git a/_data/alerts.yml b/_data/alerts.yml deleted file mode 100644 index 157e162..0000000 --- a/_data/alerts.yml +++ /dev/null @@ -1,15 +0,0 @@ -tip: '