# eScience * Wie wollen wir in Zukunft Informationen bereit stellen? * Folien: https://hackmd.io/@planetmija/H1jxMglF_ (/edit) --- # Derzeitige Lage * CMS seitens Uni gesetzt * Docx weiterhin für Dokumente mit Rektorat, etc. * Paper, bwHPC ist Latex derzeit gesetzt * Aber alle haben Nachteile bei der Webdarstellung und Konvertierung --- # Markdown * Inzwischen häufig eingesetzt für Dokumentationen im Web * Auch statische Webseiten werden damit generiert * Pro/Contra Markdown: https://hackmd.io/@planetmija/rkf0OoWIO (/edit) --- # Markdown als Ergänzung * Für Webseiten (statt Omnibus z.B.) * Jekyll, Hugo, Bootstrap, Bulma, kramdown, etc. * Für Dokumente * [MyST](https://myst-parser.readthedocs.io/en/latest/examples/wealth_dynamics_md.html) und [rST](https://myst-parser.readthedocs.io/en/latest/examples/wealth_dynamics_rst.html) --- # Hosting * Lokale Gitlab-Instanz * Jekyll, Hugo, etc. verfügbar? * Support benötigt? * Mehrere Instanzen, Backup, etc... * Github-Actions sind sehr mächtig, geht das auch bei Gitlab? --- # Workflows Webseite * Wie wollen wir neuen Inhalt auf Webseite generieren? * lokaler Test + Push? Forks, Pull-Request? * Merge, Rebase, etc. * Code für alle sichtbar? Public? * Wie testen? nur lokal, Branches, etc? --- # Workflows Dokumente * rST + MyST? * Gitlab CI? * Github hat dafür Actions * readthedocs.io --- # Versionierung von Dokumenten * Tags bei Git * Muss mit Sphinx und interner Versionshistorie abgeglichen werden * TLP für interne Dokumente? * DOIS und triviale Selbstpublikation? * Referenzierbarkeit einer Version ohne über UB zu gehen --- # Weitere Informationsquellen * Alerts zu Telegram * Telegram, Twitter, ATOM als News-Happen (ala RZ-Startseite) --- # Demos * [Github Pages und kramdown](https://nemo-cluster.github.io/betriebskonzept-nemo/) * [reStructuredText mit Github Actions und RTD Theme](https://nemo-cluster.github.io/nemo-docs/) * [gleicher reStructuredText Artikel über readthedocs.io](https://nemo-documentation.readthedocs.io/en/latest/) * Github unterstützt mehrere "Sprachen": - https://github.com/nemo-cluster/nemo-docs/blob/main/docs/betriebskonzept.rst --- # Lokale Demo * OSS- oder Atom-Editorn mit Preview * Sphinx oder Jekyll lokal installieren * Lokalen Server starten mit Autorefresh/-build --- ### DANKE! :sheep: https://cluster.nemo.uni-freiburg.de/