From 85159ebc3553dca05373313a5c52bde9baff8669 Mon Sep 17 00:00:00 2001 From: Elke Zimoch Date: Fri, 5 Jun 2026 14:01:46 +0200 Subject: [PATCH] closer to usable results --- docs/1._Home/UsefulLinks.md | 54 ------------------------------------- docs/1._Home/about.md | 14 ++++++++++ docs/1._Home/index.md | 52 +++++++++++++++++++++++++++++++++-- docs/index.md | 16 ++++++++++- 4 files changed, 79 insertions(+), 57 deletions(-) delete mode 100644 docs/1._Home/UsefulLinks.md create mode 100644 docs/1._Home/about.md diff --git a/docs/1._Home/UsefulLinks.md b/docs/1._Home/UsefulLinks.md deleted file mode 100644 index f7ff7ee2..00000000 --- a/docs/1._Home/UsefulLinks.md +++ /dev/null @@ -1,54 +0,0 @@ -# Useful Links - -This is a collection of useful Links. The date in brackets show when the link was last -veryfied to work. - -## caQtDM links - -- [Main documentaion](https://caqtdm.github.io/documentation.html) (05.05.2026) -- [Beamline Guidelines](https://intranet.psi.ch/en/controls/caqtdm-guidelines-beamlines-sls-2-0) (05.05.2026) -- [Control Room Styleguide](https://acceleratorwiki.psi.ch/wiki/Application_Development_Style_Guide_for_the_PSI_Main_Control_Room) (05.05.2026) - - - -## Naming conventions - -- [SLS 2.0 Naming Convention link list](https://indico.psi.ch/event/15589/) (5.5.2026) -- [SwissFEL](https://intranet.psi.ch/en/controls/swiss-feldevice-naming) (5.5.2026) -- [PROSCAN](https://intranet.psi.ch/de/controls/proscan-device-naming) (5.5.2026) -- [HIPA](https://intranet.psi.ch/de/controls/proton-accelerator-naming) (5.5.2026) - - -## Facility Operation schedule - -- [SLS](https://duo.psi.ch/duo/public_calendar.php) (5.5.2026) -- [HIPA and PROSCAN (pdf)](https://intranet.psi.ch/en/asa/betriebs-programme) (5.5.2026) -- [SwissFEL Overview](https://duo.psi.ch/duo/public_calendar.php?LAYOUT=&BEAMLINE=6&CBLIND=&POS=4052) (5.5.2026) -- [Elog (SLS preselected, select other logbooks on the upper left side)](https://elog-gfa.psi.ch/SLS/?rsort=Wann) (5.5.2026) - - -## SSH Links - -- [Presentation slides "SSH Deep Dive" by Konrad Bucheli](https://rse.psi.ch/events/2026-05-05/Bucheli/) (6.5.2026) -- [OpenSSH home page](https://www.openssh.org/) (6.5.2026) -- [SSH cheat sheet](https://computingforgeeks.com/ssh-commands-cheat-sheet-linux/) (6.5.2026) -- [Wikibooks: OpenSSH](https://en.wikibooks.org/wiki/OpenSSH) (6.5.2026) -- [SSH academy](https://www.ssh.com/academy/ssh) (6.5.2026) - - -## Driver Documentation links - -- [Stream Device](https://paulscherrerinstitute.github.io/StreamDevice/) -- [RegDev](https://github.com/paulscherrerinstitute/regdev) -- [OPC-UA](https://gitea.psi.ch/epics_driver_modules/opcua) - - -## General - -- [PSI Phoebook](https://intranet.psi.ch/de/suche/telefonbuch-und-e-mail) (5.5.2026) -- [Indico homepage of PSI](https://indico.psi.ch/) (5.5.2026) -- [Hardware Database Inventory](https://inventory.psi.ch/) (5.5.2026) -- [EPICS Homepage](https://epics-controls.org/) (5.5.2026) -- [PSP-Checker](https://psiexplorerhana.psi.ch/?nonav=true) (5.5.2026) -- [Accelerator Status (ext)](https://cas-status.psi.ch/) (6.5.2026) -- [Web caQtDM (int)](http://cas-novnc-srv-00/) (6.5.2026) diff --git a/docs/1._Home/about.md b/docs/1._Home/about.md new file mode 100644 index 00000000..3dae85e9 --- /dev/null +++ b/docs/1._Home/about.md @@ -0,0 +1,14 @@ +# About the Section Controls + +The section "Control Systems" is part of the department "Elektronics and +Control Systems" (AEK) in the PSI Center for "Accelerator Science and +Engineerin" (CAS). + +**Center Leader:** [Prof. Dr. Mike Seidel](https://intranet.psi.ch/en/people/mike-seidel) + +**Department Head:** [Dr. Thomas Schilcher](https://intranet.psi.ch/en/people/thomas-schilcher) + +**Section Head:** [Dr. Tine Celcer](https://intranet.psi.ch/en/people/tine-celcer) + +**Administration Office:** [Maria Guarino Tucci](https://intranet.psi.ch/en/people/maria-guarino-tucci) + diff --git a/docs/1._Home/index.md b/docs/1._Home/index.md index b6147b83..f9908261 100644 --- a/docs/1._Home/index.md +++ b/docs/1._Home/index.md @@ -1,5 +1,53 @@ -# Home +# Controls Documentation Home -Some useful stuff about and for Controls +This is a collection of useful Links. The date in brackets show when the +link was last veryfied to work. + +## Facility Operation schedule + +- [SLS](https://duo.psi.ch/duo/public_calendar.php) (5.5.2026) +- [HIPA and PROSCAN (pdf)](https://intranet.psi.ch/en/asa/betriebs-programme) (5.5.2026) +- [SwissFEL Overview](https://duo.psi.ch/duo/public_calendar.php?LAYOUT=&BEAMLINE=6&CBLIND=&POS=4052) (5.5.2026) +- [Elog (SLS preselected, select other logbooks on the upper left side)](https://elog-gfa.psi.ch/SLS/?rsort=Wann) (5.5.2026) + +## Naming conventions + +- [SLS 2.0 Naming Convention link list](https://indico.psi.ch/event/15589/) (5.5.2026) +- [SwissFEL](https://intranet.psi.ch/en/controls/swiss-feldevice-naming) (5.5.2026) +- [PROSCAN](https://intranet.psi.ch/de/controls/proscan-device-naming) (5.5.2026) +- [HIPA](https://intranet.psi.ch/de/controls/proton-accelerator-naming) (5.5.2026) + + +## SSH Links + +- [Presentation slides "SSH Deep Dive" by Konrad Bucheli](https://rse.psi.ch/events/2026-05-05/Bucheli/) (6.5.2026) +- [OpenSSH home page](https://www.openssh.org/) (6.5.2026) +- [SSH cheat sheet](https://computingforgeeks.com/ssh-commands-cheat-sheet-linux/) (6.5.2026) +- [Wikibooks: OpenSSH](https://en.wikibooks.org/wiki/OpenSSH) (6.5.2026) +- [SSH academy](https://www.ssh.com/academy/ssh) (6.5.2026) + + +## Driver Documentation links + +- [Stream Device](https://paulscherrerinstitute.github.io/StreamDevice/) +- [RegDev](https://github.com/paulscherrerinstitute/regdev) +- [OPC-UA](https://gitea.psi.ch/epics_driver_modules/opcua) + +## caQtDM links + +- [Main documentaion](https://caqtdm.github.io/documentation.html) (05.05.2026) +- [Beamline Guidelines](https://intranet.psi.ch/en/controls/caqtdm-guidelines-beamlines-sls-2-0) (05.05.2026) +- [Control Room Styleguide](https://acceleratorwiki.psi.ch/wiki/Application_Development_Style_Guide_for_the_PSI_Main_Control_Room) (05.05.2026) + + +## General + +- [PSI Phoebook](https://intranet.psi.ch/de/suche/telefonbuch-und-e-mail) (5.5.2026) +- [Indico homepage of PSI](https://indico.psi.ch/) (5.5.2026) +- [Hardware Database Inventory](https://inventory.psi.ch/) (5.5.2026) +- [EPICS Homepage](https://epics-controls.org/) (5.5.2026) +- [PSP-Checker](https://psiexplorerhana.psi.ch/?nonav=true) (5.5.2026) +- [Accelerator Status (ext)](https://cas-status.psi.ch/) (6.5.2026) +- [Web caQtDM (int)](http://cas-novnc-srv-00/) (6.5.2026) diff --git a/docs/index.md b/docs/index.md index fdc50e28..d032ea1f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -9,7 +9,7 @@ useful stuff as a kind of "quick link". ## What do we do? -This question is ansered in the tab *"2.Services Portfolio"* with a list of +This question is ansered in the tab *"2. Services Portfolio"* with a list of all services supported by the Controls section. In addition you can find here lists of supported hardware and epics drivers. @@ -22,3 +22,17 @@ Controls Contacts for various expert groups, beamlines, and topics as well as the service owners of Controls services. The *"5. Controls Internal"* tab contains internal procedures like onboarding, how to do travel requests and the Control system team charter. + +## How to change or contribute content + +This webpage is hosted in Gitea: +[](https://gitea.psi.ch/Controls/gitea-pages/actions) + +It uses the site generator [Zensical](https://zensical.org/docs/setup/basics/) +together with Gitea Actions to convert +[Markdown](https://www.markdownguide.org/cheat-sheet/) text files +into html webpages. To contribute, check out the gitea repository, update +the content and check in again +([a simple git help](https://rogerdudler.github.io/git-guide/index.html)). +A predefined workflow will publish the changes automatically after some +seconds - just reload the webpage in your browser.