graph LR
A[Edit Markdown Handbook pages on GitHub] -->|triggers:GitHub Actions| B[Live Website]
C[Edit Markdown Slides on GitHub] -->|triggers:GitHub Actions| D[HTML slides]
E[Edit Markdown Paper on GitHub] -->|triggers:GitHub Actions| F[Paper PDF/DOX]
Systems
Note
This section is marked as “toupdate”: completely update
TODO:
- 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. We prefer open-source tools and open-data formats:
- Markdown, a markup language, which allows us to creating formatted documents, papers, websites, presentations using plain text (formatting such as headings, lists, bold, italics, and links). It is platform-independent, integrates well with git, and can easily be converted to other formats (e.g., PDF, HTML, DOCX) using Pandoc. Citations can be included via the CSL project.
- Git, a distributed version control system to collaborate on software development projects, data analyses, paper writing, and teaching materials. It allows users to work on the same file, to track changes, to merge different versions or branches, and revert to any previous state.
NoteMarkdown
Markdown is our preferred open-data format for the documentation (website), for writing papers and theses, managing knowledge, and creating slides. It is platform-independent, integrates well with git, and can easily be converted to other formats (e.g., PDF, HTML, DOCX) using Pandoc.
General systems
| System | Description |
|---|---|
| handbook | - Hosted on GitHub - Editing guidelines - Distributed version control system to collaborate in software development projects, and for collaborating in writing and teaching - Our preferred choice for manuscripts, and lecture material |
| Nextcloud | - Clients (use Nextcloud Files) - Contains all confidential materials for lab management, teaching, research, funding, and service (following the same structure as the handbook). - “Anmelden”, URL: https://nc-2272638881871040784.nextcloud-ionos.com/, give access in Browser (pop-up), accept default settings- Our preferred choice for confidential data, and binary/large files - Collaborative editing of a shared document (without login): create md-file and public link (can edit) |
| System | Description |
|---|---|
| - Every member of the university gets a mail assigned - Personnel has the format firstname.surname@uni-bamberg.de while student mail addresses have the format firstname1-firstname2-firstname3-(...).surname@stud.uni-bamberg.de- The messages are accessible via Outlook 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 - Shared chat and separate chats in different channels - Lectures and seminars can be held as phone or video meetings with up to 250 participants - Recording functionality - Collaborate on files within a team |
| Zoom | - Single-Sign-On-Url: uni-bamberg- Online service for web conferencing - Teaching as Meetings or Webinars - Recording functionality - For events that exclusively involve members students of our university, please use Teams because of data security and privacy concerns |
| Calendly | - Allow students to book appointments, which are automatically added to the Outlook calendar - Example: 30-minute meeting |
| Nuudel | - Doodle replacement |
Machine setup
- Eduroam: Log-in with university credentials
- VPN: Some Services are only available via VPN or within the university network
- Proxy servers: Residential proxy server service
- LanguageTools: Free Online Spellchecker (local setup: see academy)
Outlook: Calendar permissions
Sharing calendars -> You decide what the other person can see
Permission settings -> In your own calendar, click on “Eigenschaften” -> “Berechtigungen”