update systems overview/software

geritwagner · geritwagner · commit 65ed56c539ae · 2026-02-26T09:04:02.000+01:00
diff --git a/_quarto.yml b/_quarto.yml
@@ -191,9 +191,10 @@ website:
 
         - section: "Infrastructure"
           contents:
+            - management/systems_overview.qmd
             - management/handbook.qmd
             - management/repositories.qmd
-            - management/systems_overview.qmd
+            - management/software.qmd
             - management/controlling.qmd
             - management/systems_administration.qmd
             - management/resources.qmd
diff --git a/academy/development.qmd b/academy/development.qmd
@@ -19,7 +19,7 @@ title: "Development"
 
 - [TypingClub](https://www.typingclub.com/){target=_blank}
 - [Using keyboard instead of mouse](https://blog.superhuman.com/keyboard-vs-mouse/){target=_blank} (see [keyboard combiner](https://keycombiner.com/){target=_blank} and shortcuts for [windows](https://www.buero-kaizen.de/windows-shortcuts/){target=_blank})
-  - ctrl+k in the handbook
+  - Press `s` in the handbook
   - shortcuts to edit markdown files in github
 - Getting-Things-Done
 - Deep links
diff --git a/management/nextcloud.qmd b/management/nextcloud.qmd
@@ -0,0 +1,4 @@
+create a page for nextcloud?
+nextcloud: regularly export
+tree -d -L 3
+to handbook?
diff --git a/management/software.qmd b/management/software.qmd
@@ -0,0 +1,41 @@
+---
+title: "Software overview"
+transition_status: "toupdate"
+transition_comment: "update"
+---
+
+::: callout-note
+
+TODO: highlight what is (not) installed with ansible (workstation-setup)
+
+:::
+
+
+
+## Machine setup
+
+- [Eduroam](https://www.uni-bamberg.de/its/dienstleistungen/netz/wlan/eduroam/){target=_blank}: Log-in with university credentials
+- [VPN](https://www.uni-bamberg.de/its/dienstleistungen/netz/vpn/einrichten/){target=_blank}: Some Services are only available via VPN or within the university network
+- [Proxy servers](https://dataimpulse.com/#pricing){target=_blank}: Residential proxy server service
+- [LanguageTools](https://languagetool.org/de){target=_blank}: Free Online Spellchecker (local setup: see academy)
+
+
+- [Systems for teaching](/teaching/systems.html)
+- [Systems for research](/research/systems.html)
+
+System | Description |
+---|---|
+[Mail](https://www.uni-bamberg.de/its/dienstleistungen/mail/zugriff/){target=_blank}| - Every member of the university gets a mail assigned<br>- [Personnel](https://www.uni-bamberg.de/its/dienstleistungen/mail/wlv/){target=_blank} has the format `firstname.surname@uni-bamberg.de` while [student](https://www.uni-bamberg.de/its/dienstleistungen/mail/studium/){target=_blank} mail addresses have the format `firstname1-firstname2-firstname3-(...).surname@stud.uni-bamberg.de`<br>- The messages are accessible via [Outlook](https://www.uni-bamberg.de/its/dienstleistungen/mail/zugriff/outlook/){target=_blank} or any other e-mail client |
+Teams | - Platform for collaboration and organization, allowing users to create different areas called "Teams" to work together or manage part of their online teaching<br>- Shared chat and separate chats in different channels<br>- Lectures and seminars can be held as phone or video meetings with up to 250 participants<br>- Recording functionality<br>- Collaborate on files within a team |
+[Zoom](https://www.uni-bamberg.de/its/dienstleistungen/tele/video/zoom/){target=_blank}| - Single-Sign-On-Url: ``uni-bamberg``<br>- Online service for web conferencing<br>- Teaching as Meetings or Webinars<br>- Recording functionality<br>- For events that exclusively involve members students of our university, please use [Teams](#teams) because of data security and privacy concerns |
+[Calendly](https://calendly.com/event_types/user/me){target=_blank}| - Allow students to book appointments, which are automatically added to the Outlook calendar<br>- Example: [30-minute meeting](https://calendly.com/gerit-wagner/30min?month=2023-07){target=_blank} |
+[Nuudel](https://nuudel.digitalcourage.de/){target=_blank}| - Doodle replacement |
+
+## Outlook: Calendar permissions
+
+Sharing calendars -> You decide what the other person can see<br>
+Permission settings -> In your own calendar, click on "Eigenschaften" -> "Berechtigungen"<br>
+
+## Resources
+
+- [Youtube procedure](https://intranet.neuro.polymtl.ca/computing-resources/youtube.html){target=_blank}
diff --git a/management/systems_overview.qmd b/management/systems_overview.qmd
@@ -1,5 +1,5 @@
 ---
-title: "Systems"
+title: "System overview"
 transition_status: "toupdate"
 transition_comment: "update"
 ---
@@ -9,15 +9,18 @@ This section is marked as "toupdate": completely update
 
 TODO:
 
+- Include the system overview from https://chatgpt.com/c/699da1a7-6648-8387-b9b8-ea1dc8c16ef5
+
+- TBD: include machine setup? https://github.com/fs-ise/workstation-setup
+
 - Content production systems (internal, but also pulic and collaborative): Quarto (website, paper, presentation, thesis) - with overview of templates (highlighting git/pandoc/markdown choice)
 - Administration systems (grades, nextcloud, ...)
 - Collaboration systems (meetings, ...)
 - Explicitly discuss tradeoff: git means no Zotero, no Word... But: it also means immediate involvement of new team members, algorithms (LLMs), and external contributors
-
 :::
 
 Welcome to the chapter on IT systems.
-<!-- 
+<!--
 This guide is intended to offer you with a useful overview on the many IT technologies and tools that support the administrative processes and lead you to the right places to learn more about them.
 This manual will serve as resource for navigating the digital environment, from learning platforms to communication tools, data analysis software to writing tools.
 -->
@@ -37,42 +40,8 @@ graph LR
 ```
 :::
 
-- [Systems for teaching](/teaching/systems.html)
-- [Systems for research](/research/systems.html)
-
-## General systems
-
-<!--
-::: {.callout-note}
-Zoom will be replaced by [jitsi](https://jitsi.org/){target=_blank} as a default (see [nextcloud-jitsi](https://github.com/nextcloud/jitsi?tab=readme-ov-file){target=_blank}).
-:::
--->
-
 System | Description |
 ---|---|
 [handbook](https://fs-ise.github.io/handbook/){target=_blank}| - Hosted on GitHub<br>- [Editing guidelines](/management/handbook.html)<br>- Distributed version control system to collaborate in software development projects, and for collaborating in writing and teaching<br>- Our preferred choice for manuscripts, and lecture material |
 [Nextcloud](https://nc-2272638881871040784.nextcloud-ionos.com/){target=_blank}| - [Clients](https://nextcloud.com/de/install/#install-clients){target=_blank} (use *Nextcloud Files*)<br>- Contains all **confidential** materials for lab management, teaching, research, funding, and service (following the same structure as the handbook).<br>- "Anmelden", URL: ``https://nc-2272638881871040784.nextcloud-ionos.com/``, give access in Browser (pop-up), accept default settings<br>- Our preferred choice for confidential data, and binary/large files<br>- **Collaborative editing of a shared document (without login)**: create md-file and public link (can edit) |
 
-System | Description |
----|---|
-[Mail](https://www.uni-bamberg.de/its/dienstleistungen/mail/zugriff/){target=_blank}| - Every member of the university gets a mail assigned<br>- [Personnel](https://www.uni-bamberg.de/its/dienstleistungen/mail/wlv/){target=_blank} has the format `firstname.surname@uni-bamberg.de` while [student](https://www.uni-bamberg.de/its/dienstleistungen/mail/studium/){target=_blank} mail addresses have the format `firstname1-firstname2-firstname3-(...).surname@stud.uni-bamberg.de`<br>- The messages are accessible via [Outlook](https://www.uni-bamberg.de/its/dienstleistungen/mail/zugriff/outlook/){target=_blank} or any other e-mail client |
-Teams | - Platform for collaboration and organization, allowing users to create different areas called "Teams" to work together or manage part of their online teaching<br>- Shared chat and separate chats in different channels<br>- Lectures and seminars can be held as phone or video meetings with up to 250 participants<br>- Recording functionality<br>- Collaborate on files within a team |
-[Zoom](https://www.uni-bamberg.de/its/dienstleistungen/tele/video/zoom/){target=_blank}| - Single-Sign-On-Url: ``uni-bamberg``<br>- Online service for web conferencing<br>- Teaching as Meetings or Webinars<br>- Recording functionality<br>- For events that exclusively involve members students of our university, please use [Teams](#teams) because of data security and privacy concerns |
-[Calendly](https://calendly.com/event_types/user/me){target=_blank}| - Allow students to book appointments, which are automatically added to the Outlook calendar<br>- Example: [30-minute meeting](https://calendly.com/gerit-wagner/30min?month=2023-07){target=_blank} |
-[Nuudel](https://nuudel.digitalcourage.de/){target=_blank}| - Doodle replacement |
-
-## Machine setup
-
-- [Eduroam](https://www.uni-bamberg.de/its/dienstleistungen/netz/wlan/eduroam/){target=_blank}: Log-in with university credentials 
-- [VPN](https://www.uni-bamberg.de/its/dienstleistungen/netz/vpn/einrichten/){target=_blank}: Some Services are only available via VPN or within the university network
-- [Proxy servers](https://dataimpulse.com/#pricing){target=_blank}: Residential proxy server service
-- [LanguageTools](https://languagetool.org/de){target=_blank}: Free Online Spellchecker (local setup: see academy)
-
-## Outlook: Calendar permissions
-
-Sharing calendars -> You decide what the other person can see<br>
-Permission settings -> In your own calendar, click on "Eigenschaften" -> "Berechtigungen"<br>
-
-## Resources
-
-- [Youtube procedure](https://intranet.neuro.polymtl.ca/computing-resources/youtube.html){target=_blank}
diff --git a/teaching/materials.qmd b/teaching/materials.qmd
@@ -55,13 +55,6 @@ A teaching repository contains
 
 For `quarto publish gh-pages` : install quarto locally (otherwise, the ssh and git setup in the docker container requires detailed configuration).
 
-### Adding extensions
-
-```sh
-docker compose run --rm quarto quarto add gadenbuie/countdown/quarto
-docker compose run --rm quarto quarto add martinomagnifico/quarto-simplemenu
-```
-
 ## Slides
 
 Template is available [here](https://github.com/fs-ise/fs-ise-presentation){target=_blank} (see [tutorial](https://www.jtrive.com/posts/creating-gh-pages-blog-with-quarto/creating-gh-pages-blog-with-quarto.html){target=_blank})
@@ -219,12 +212,56 @@ Shortcuts:
 - b
 - d
 
+::: {.callout-note title="Slide preparation" collapse=true}
+
 Convert PowerPoint to quarto:
 
 ```sh
 pptx2md "slides.pptx" --output "slides_with_notes.qmd" --enable-slides --qmd --image-dir "images"
 ```
 
+Prompt
+
+```Markdown
+Create Reveal.js slides with a title page, simple menu navigation, and support for sections, columns, asides, and centered images. Use this slide formatting structure:
+
+---
+title: "<TITLE>"
+author: "Prof. Dr. Gerit Wagner"
+format:
+  revealjs:
+    section-divs: true
+    center: false
+    title-slide-attributes:
+      data-state: "hide-menubar"
+    simplemenu:
+      barhtml:
+        header: ""
+        footer: "<div class='menubar'><ul class='menu'></ul><div class='slide-number'></div></div>"
+      scale: 0.67
+revealjs-plugins:
+  - simplemenu
+---
+
+Use:
+
+# for main sections (stack navigation, with {data-stack-name="..."} where needed)
+
+## for slides within a section
+
+::: columns / ::: column for side-by-side layouts
+
+::: aside for sources or small side notes
+
+![](path){fig-align="center" width="X%"} for centered visuals
+
+Fenced code blocks (e.g., Python) for figures generated with code
+
+Keep the style clean, structured, and concise, similar to academic lecture slides on analytics and big data.
+```
+
+:::
+
 ## Notebooks
 
 We use Jupyter notebooks for exercises.
