initialized hugo

.gitignore

@@ -1,16 +1,2 @@
-*.acn
-*.acr
-*.alg
-*.aux
-*.glg
-*.glo
-*.gls
-*.glsdefs
-*.ist
-*.log
-*.out
-*.pdf
-*.gz
-*.toc
-*.ver
-*.hst
+/public/
+.hugo_build.lock

.vscode/settings.json

@@ -1,2 +0,0 @@
-{
-}

Atem Mini.tex

@@ -1 +0,0 @@
-\chapter{Atem Mini}

Glossar.tex

@@ -1,84 +0,0 @@
-\newglossaryentry{Lautheit}{
-	name={Lautheit},
-	description={Lautheit ist eine Größe welche die von Menschen empfundene Lautstärke eines Signals abbilden soll. Damit unterscheidet sie sich vom Peak-Wert, welcher den Maximalwert eines Signals angibt. Pegelanzeigen zeigen in der Regeln den \Gls{Peak}-Wert an und eignen sich damit nur bedingt für eine Aussage über die Lautheit.\\Die Lautheit wird meistens in \textit{LU} (\textit{\textbf{L}oudness \textbf{U}nits}) angegeben, häufig auch in Bezug auf den maximal möglichen Wert (\textit{\textbf{F}ull \textbf{S}cale}-Wert): \textit{LUFS}},
-	see={Peak}
-}
-
-\newglossaryentry{Peak}{
-	name={Peak},
-	description={Der Peak-Wert bezeichnet den Spitzenwert eines (Audio)-Signals. Mit dem Peak-Wert lassen sich nur bedingt Aussagen über die Lautheit machen}
-	,see={TruePeak,Lautheit}
-}
-
-\newglossaryentry{TruePeak}{
-	name={True-Peak},
-	description={},
-	see={Peak}
-}
-
-\newglossaryentry{VST-Plugin}{
-	name={VST-Plugin},
-	description={VST steht für Virtual Studio Technology und ist eine Programmierschnittstelle für Audio-Plugins}
-}
-
-\newglossaryentry{SDI}{
-	name={SDI},
-	description={SDI, kurz für Serial Digital Interface, ist eine serielle Übertragungsschnittstelle für digitale Videosignale über Koaxialkabel oder Lichtwellenleiter. Es ermöglicht im Gegensatz zu HDMI Kabellängen von bis zu 100 Metern (über Koaxialkabel)}
-}
-
-\newglossaryentry{NDI}{
-	name={NDI},
-	description={NDI, kurz für Network Device Interface, ist eine Spezifikationen zur Übertragung digitaler Videosignale über ein Computernetzwerk}
-}
-
-\newglossaryentry{PTZ-Kamera}{
-	name={PTZ-Kamera},
-	description={Eine PTZ-Kamera ist eine Kamera, deren \textbf{P}an, \textbf{T}ilt und \textbf{Z}oom ferngesteuert werden kann}
-}
-
-\newglossaryentry{FoH_full}{
-	name={Front of House},
-	description={\textit{Front of House} bezeichnet den Ort, an dem sich bei einer Veranstaltung die Ton-, Video- und Lichttechnik befindet}
-}
-
-\newglossaryentry{FoH}{
-	name={FoH},
-	description={Abkürzung für \Gls{FoH_full}},
-	see={FoH_full}
-}
-
-\newglossaryentry{PoE_full}{
-	name={Power over Ethernet},
-	description={
-		Power over Ethernet bezeichnet das Verfahren, elektronische Geräte über das Ethernet-Kabel mit Strom zu versorgen.
-		Dies ermöglicht den Anschluss eines Gerätes ohne zusätzliche Stromversorgung und wird zum Beispiel häufig für WLAN-Access-Points verwendet
-	}
-}
-
-\newglossaryentry{PoE}{
-	name={PoE},
-	description={Abkürzung für \Gls{PoE_full}},
-	see={PoE_full}
-}
-
-\newglossaryentry{OBS} {
-	name={OBS},
-	description={Open Broadcaster Software ist eine Videomischsoftware, mit welcher Bild-, Video- und Audiosignale live zusammengesetzt und gemischt werden können}
-}
-
-\newglossaryentry{Visca} {
-	name={Visca},
-	description={
-		Das Visca-Protokoll ist ein von Sony entwickeltets Protokoll, zur Kommunikation mit Videokameras und ermöglicht die Steuerung fast aller Kamera-Parameter.
-		Es kann sowohl über eine serielle Schnittstelle als auch über das Netzwerk übertragen werden
-	}
-}
-
-\newglossaryentry{stinger} {
-	name={Stinger-Transition},
-	description={Stinger-Transitions sind eine Möglichkeit in \Gls{OBS}, einen Übergang zwischen zwei Szenen zu gestalten. Hierbei wird eine Videodatei über das eigentliche Bild gelegt und nach einer vorher definierten Zeit zur neuen Szene gewechselt. Durch transparente Anteile in der Videodatei sind weiche Übergänge möglich},
-	see={OBS}
-}
-
-\setglossarystyle{altlist}
-\printglossary

Kabel.tex

@@ -1,33 +0,0 @@
-\chapter{Verkabelung}
-	\section{SDI}
-		Alle Videostrecken wurden mit \Gls{SDI}-Koaxial-Kabeln durchgeführt, da die einige der Strecken zu lang für eine zuverlässige HDMI-Verbindung sind. Im Computer ist hierfür eine \textit{Blackmagic Design DeckLink Duo 2} verbaut. Diese bietet 4 Bidirektionale 3G-\Gls{SDI}-Anschlüsse und einen Sync-Eingang; dieser wird allerdings nicht benutzt.
-
-		Es sind folgende Kabelstrecken installiert:
-		\begin{table}[h]
-			\caption{Belegung der \Gls{SDI}-Capture-Karte \textit{Blackmagic Design DeckLink Duo 2}}
-			\centering
-			
-			\begin{tabular}{ccl}
-				\toprule
-				Anschluss & Konfiguration & Bezeichnung \\
-				\midrule
-				Sync & - & nicht verwendet \\
-				1 & Eingang & \Gls{PTZ-Kamera} \\
-				2 & Eingang & Leitung Altarraum \\
-				3 & Eingang & Patchfeld \Gls{FoH} \\
-				4 & Ausgang & Beamer Gemeindesaal \\
-				\bottomrule
-			\end{tabular}
-		\end{table}
-
-		Die PTZ-Kamera ist fest angeschlossen, ebenso der Beamer. Die Leitung in den Altarraum endet hinter dem Leimbinder am Flügel wo noch einige restliche Meter Kabel aufgewickelt sind. Der dritte Anschluss ist an das Patchfeld im Rack angeschlossen. Diese beiden freien Leitungen sind für weitere Videoquellen gedacht, die bedarfsorientiert genutzt werden können. Hierzu gibt es auch noch ein weiteres, loses \Gls{SDI}-Kabel und Verbinder umd bestehende Kabel zu verlängern.
-
-	\section{Netzwerk}
-		Das \Gls{FoH} ist über einen einzelne Gigabit Leitung an das Netzwerk und somit auch an das Internet angeschlossen. Der Haupt-Switch befindet sich unter der Treppe im Kindergarten. Von hieraus liegen 4 Leitungen auf die Bühne in die Theke des Jugendcafes. An einen dieser Ports ist ein weiteres Kabel angeschlossen, welches auf den Speicher und dann entlang der wandseitigen Lampen im Gemeindesaal führt bis in das Rack. Dort befindet sich ein 8-Fach Switch, welcher die verschiedenen Geräten verbindet.
-
-		Da der Haupt-Switch \Gls{PoE} zur Verfügung stellt, ist keine zusätzliche Stromversorgung des Technik-Switches notwendig. Ebenfalls wird innerhalb der beiden vierer Gruppen \Gls{PoE} weitergeleitet. Ebenfalls wird die \Gls{PTZ-Kamera} über \Gls{PoE} mit Strom versorgt.
-
-		Desweiteren ist der Streamingrechner an den Switch angeschlossen.
-
-	\section{Tontechnik}
-		

Kameras.tex

@@ -1,19 +0,0 @@
-\chapter{Kameras}
-	\section{PTZ}
-		\subsection{Steuerung}
-			Die \Gls{PTZ-Kamera} wird über eine Netzwerkanbindung ferngesteuert.
-			Es wäre auch eine Steuerung über RS-232 oder RS-485 möglich, was beispielsweise von dedizierten Controlpanels genutzt wird.
-			Die installierte \Gls{PTZ-Kamera} wird allerdings von \refname{companion} angesteuert, welches über das Netzwerk kommuniziert.
-
-			Die Kamera unterstützt mehrere Steuerprotokolle, wobei hier das \Gls{Visca}-Protokoll eingesetzt wird.
-		\subsection{Videosignal}
-		\subsection{Stromversorgung}
-			Die \Gls{PTZ-Kamera} wird über \Gls{PoE} mit Strom versorgt.
-			Da die Kamera für die Steuerung sowieso an das Netzwerk angeschlossen ist, kann somit ein Kabel eingespart werden.
-		\subsection{Parkposition}
-			Damit sich während der Nichtbenutzung der Kamera möglichst wenig Staub auf der Linse ablagert, fährt die Kamera beim Schließen von OBS eine Parkposition an, in welcher sie senkrecht nach unten schaut.
-
-			Hierzu ist im \Gls{OBS}-Plugin \textit{Advanced Scene Switcher} ein Makro hinterlegt, welches beim Schließen von OBS ausgeführt wird. Es wird eine Exe ausgeführt, welche einen \Gls{Visca}-Befehl an die \Gls{PTZ-Kamera} sendet.
-
-			Das Programm ist ein Python-Skript, welches als Standalone-Exe kompiliert wurde. Über das Modul \textit{visca-over-ip} kann mit \Glsplural{PTZ-Kamera} kommuniziert werden. Vor dem erstellen der Exe-Datei muss die IP-Adresse angepasst werden.
-	\section{Sony A6000}

Software.tex

@@ -1,59 +0,0 @@
-\chapter{Software}
-	\section{OBS}
-		Über \Gls{OBS} werden die verschiedenen Videosignale gemischt, aufgenommen und an YouTube geschickt.
-
-		\subsection{Grundfunktionen}
-			In \Gls{OBS} werden verschiedene Bild-Kompositionen in sogenannten Szenen gespeichert.
-			In einer Szene kann eine vielzahl von verschiedenen Quellen (Sources) verwendet werden, unter anderem:
-			\begin{itemize}
-				\item reine Audioeingänge
-				\item Bildschirmaufnahmen
-				\item Fensteraufnahmen
-				\item Bilder
-				\item Medienquellen (Video- oder Musikdateien)
-				\item NDI (durch \nameref{ndi})
-				\item andere Szenen
-				\item Text
-				\item Webcams
-				\item Blackmagic Decklink Videoeingänge
-			\end{itemize}
-			Indem man sich in \Gls{OBS} mit den YouTube-Zugangsdaten anmeldet, kann man in \Gls{OBS} entweder Livestreams erstellen oder einen bereits geplanten Livestream auswählen und diesen streamen.
-		\subsection{Plugins}
-			\Gls{OBS} kann durch verschiedene Plugins in seiner Funktion erweitert werden.
-			Installiert sind:
-			\begin{itemize}
-				\item obs-websocket
-				\item Advanced Scene Switcher
-				\item obs-ndi
-				\item Audio-Monitor
-			\end{itemize}
-
-			\subsubsection{obs-websocket}
-				\textit{obs-websocket} ermöglicht die Fernsteuerung von OBS durch einen Websocket.
-				Dieser wird zum Beispiel von Companion genutzt, um Szenen zu wechseln oder Informationen über den aktuellen Zustand von OBS zu erlangen.
-			\subsubsection{Advanced Scene Switcher}
-				Mit \textit{Advanced Scene Switcher} können Abläufe in \Gls{OBS} automatisiert werden.
-				Beispielsweise kann am Ende einer Medienquelle automatisch die Szene gewechselt werden oder Programme beim Schließen von \Gls{OBS} ausgeführt werden.
-			\subsubsection{obs-ndi}\label{ndi}
-				\textit{obs-ndi} ermöglicht die Nutzung von \Gls{NDI}-Signalen in \Gls{OBS}.
-				Es fügt eine \Gls{NDI}-Source hinzu und ermöglicht eine \Gls{NDI}-Ausgabe einzelner Szenen oder des Programms.
-			\subsubsection{Audio-Monitor}
-				\textit{Audio-Monitor} fügt genau steuerbare Audioabhörmöglichkeiten hinzu.
-				Die Standardmöglichkeiten von OBS sind in einem Untermenü versteckt und müssen erneut aktiviert werden, wenn der Kopfhörer neu eingesteckt wurde.
-
-		\subsection{Konfiguration}
-			
-	\section{PPT NDI}
-		Alle Text-Einblendungen werden mit PowerPoint erstellt.
-		Eine Vorlage befindet sich im Google-Drive Verzeichnis.
-
-		PPT NDI läd eine PowerPoint-Präsentation und spielt diese über \Gls{NDI} aus
-		Dieses \Gls{NDI}-Signal lässt sich wiederrum in \Gls{OBS} einbinden.
-		Dies hat den Vorteil, dass kein Extra-Bildschirm freigehalten werden muss, auf dem PowerPoint läuft und abgefilmt wird.
-
-		Die Shortcuts, um die Folien zu wechseln, sind auf dem Streamdeck programmiert.
-	\section{Youlean-Loudness-Meter}
-		\textit{Youlean-Loudness-Meter} ist ein \Gls{VST-Plugin}, welches die \Gls{Lautheit} eines Audiosignals plottet
-	\section{PTZOptics-Control Pane}
-		\textit{PTZOptics-Control Pane} ist die hauseigene Software von PTZOptics, um deren \Glsplural{PTZ-Kamera} zu steuern.
-		Es können sowohl Pan, Tilt und Zoom, als auch tiefergehende Funktionen wie Weißabgleich, Belichtung oder das Menü gesteuert werden.

Streamdeck.tex

@@ -1,31 +0,0 @@
-\chapter{Streamdeck}
-	Das \textit{Elgato Streamdeck} ist eine programmierbare Makrotastatur mit 15 Displaytasten. Mithilfe der zugehörige Software von Elgato kann man eine maßgeschneiderte Makrotastatur erstellen, welche mit vielen Programmen direkt kommunizieren kann.
-
-	Das verbaute Streamdeck wird allerdings mit der drittanbieter Software \textit{Bitfocus Companion} betrieben. Diese bietet ähnliche Funktionen, ist aber eher für Rundfunkanwendungen konzipiert. Es lassen sich ebenfalls viele Programme durch Netzwerkprotokolle direkt einbinden.
-
-	Das Interface bildet 100 aufeinanderfolgende Seiten ab, zwischen denen auf- und abgeblättert oder umhergesprungen werden kann.
-
-	Programmiert sind unter anderem Seiten, um:
-	\begin{itemize}
-		\item Programme zu starten
-		\item Stream und Aufnahme zu starten und beenden
-		\item Szenen in \Gls{OBS} zu wechseln
-		\item PTZ-Presets abzurufen
-		\item Einblendungen zu steuern
-		\item die \Gls{PTZ-Kamera} fernzusteuern
-		\item PTZ-Preset abzuspeichern
-		\item Atem-Mischer fern zu steuern
-	\end{itemize}
-
-	\section{Einrichtung}
-		Die komplette Einrichtung der Companion-Software erfolgt im Browser. Durch einen Klick auf das Symbol im Benachrichtigungsfelder der Taskleiste öffnet sich ein Fenster, mit welchem die Konfigurationsseite im Browser öffnen lässt (\textit{Launch GUI}).
-
-		Dort kann nun sowohl die Belegung der einzelnen Buttons, als auch die Konfiguration der geladenen Modulen angepasst werden.
-
-	\section{Konfiguration}
-		\subsection{PTZ}
-			Companion ermöglicht eine direkte Steuerung der \Gls{PTZ-Kamera} über das \textit{\Gls{Visca}-Protokoll}. Die Buttons, welche die verschiedenen PTZ-Presets abrufen, haben zwei Befehle hinterlegt:
-			\begin{enumerate}
-				\item PTZ-Preset abrufen: Dies sendet einen \Gls{Visca}-Befehl an die Kamera, um das entsprechende Preset anzufahren.
-				\item Szenen-Wechsel in \Gls{OBS}: In \Gls{OBS} zu der Szene wechseln, welche dem Preset entspricht. Hierdurch wird die \Gls{stinger} ausgelöst.
-			\end{enumerate}

YouTube.tex

@@ -1 +0,0 @@
-\chapter{YouTube}

archetypes/default.md

@@ -0,0 +1,5 @@
+---
+title: '{{ replace .File.ContentBaseName "-" " " | title }}'
+date: "{{ .Date }}"
+draft: true
+---

content/_index.md

@@ -0,0 +1,7 @@
+---
+date: "2025-06-19T23:51:17+02:00"
+draft: true
+title: ""
+---
+
+startpage

content/docs/Audio/_index.md

@@ -0,0 +1,7 @@
+---
+date: "2025-06-20T00:04:55+02:00"
+draft: true
+title: "Audio"
+---
+
+some audio stuff

content/docs/Video/_index.md

@@ -0,0 +1,5 @@
+---
+date: '2025-06-20T00:04:45+02:00'
+draft: true
+title: 'Video'
+---

content/docs/_index.md

@@ -0,0 +1,7 @@
+---
+date: "2025-06-19T23:51:17+02:00"
+draft: true
+title: "Dokumentation"
+---
+
+docs main site

go.mod

@@ -0,0 +1,5 @@
+module github.com/johannesbuehl/dokumentation
+
+go 1.24.4
+
+require github.com/imfing/hextra v0.9.7 // indirect

go.sum

@@ -0,0 +1,2 @@
+github.com/imfing/hextra v0.9.7 h1:Zg5n24us36Bn/S/5mEUPkRW6uwE6vHHEqWSgN0bPXaM=
+github.com/imfing/hextra v0.9.7/go.mod h1:cEfel3lU/bSx7lTE/+uuR4GJaphyOyiwNR3PTqFTXpI=

hugo.yaml

@@ -0,0 +1,44 @@
+baseURL: https://example.org/
+title: Johanneskirche Bühl - Technik
+defaultContentLanguage: de
+
+module:
+  imports:
+    - path: github.com/imfing/hextra
+
+menu:
+  # navbar:
+  # displayTitle: true
+  # displayLogo: true
+  # logo:
+  #   path: images/logo.svg
+  #   dark: images/logo-dark.svg
+  #   link: /
+  main:
+    - name: Dokumentation
+      pageRef: /docs
+      weight: 10
+    - name: Blog
+      pageRef: /blog
+      weight: 11
+    - name: Suche
+      weight: 20
+      params:
+        type: search
+    - name: GitHub
+      url: "https://github.com/johannesbuehl"
+      weight: 30
+      params:
+        icon: github
+    - name: YouTube
+      url: "https://www.youtube.com/@evangelischekirchengemeind7171"
+      weight: 31
+      params:
+        icon: youtube
+
+params:
+  editURL:
+    enable: true
+    base: "https://github.com/johannesbuehl/dokumentation/edit/main"
+  footer:
+    displayCopyRight: true

i18n/de.yaml

@@ -0,0 +1,2 @@
+poweredBy: Hugo mit Hextra
+copyright: © 2025 Evangelische Kirche Bühl

johannes-streaming-dokumentation.tex

@@ -1,100 +0,0 @@
-\documentclass[11pt, fleqn]{scrreprt}
-
-\usepackage[utf8]{inputenc} %support for german chars
-\usepackage[ngerman]{babel} %support for german chars
-\usepackage{icomma} %for german comma at decimal number
-\usepackage{multicol} %enables text in multiple columns
-% \usepackage{titling} %enables subtitle
-\usepackage{microtype} %final document is better to read
-%\usepackage[onehalfspacing]{setspace} %one-half line spacing
-\usepackage{booktabs} %tools for better tables
-\usepackage[thinlines]{easytable}
-\usepackage[paper=a4paper,top=2cm, bottom=2.5cm, left=2cm, right=2cm]{geometry} %dimensions like word
-\setlength{\parindent}{0pt}
-
-\usepackage{pdflscape}
-
-\usepackage{pgfplots} %plot functions etc
-\usepackage{graphicx} %insert graphics
-\usepackage{url} %make URLs more fancy
-
-\usepackage[hidelinks]{hyperref}
-
-\usepackage{pdfpages} % include pdf pages by \includepdf{}
-
-\usepackage{amsmath} % better math-stuff
-\usepackage{amssymb} % more math symbols
-\usepackage{float}
-
-\usepackage{vhistory}
-
-\usepackage{csvsimple}
-
-\usepackage{ulem}
-\usepackage{cleveref}
-
-\usepackage{csquotes}
-
-\usepackage{pgfplotstable}
-
-\usepackage[acronym,toc]{glossaries}
-\makeglossaries
-
-\usepackage[justification=justified]{caption}
-\usepackage[justification=centering,singlelinecheck=false,labelsep=period]{caption}
-\addto\captionsngerman{\renewcommand{\figurename}{Bild}}
-
-\usepackage{siunitx}
-\sisetup{
-	locale = DE,
-	inter-unit-product = \text{}
-}
-\DeclareSIUnit\bar{bar}
-
-\pgfplotsset{compat=newest}
-
-% \newcommand{\subtitle}[1]{\posttitle{\par\end{center}\begin{center}\large#1\end{center}\vskip0.5em}} %enables subtitle
-
-\widowpenalty
-\clubpenalty
-
-% \titlehead{titlehead}
-\subject{Dokumentation}
-\title{Streaming-Setup in der Johanneskirche Bühl}
-\subtitle{Version \vhCurrentVersion}
-\author{\vhListAllAuthors}
-\date{Stand \vhCurrentDate}
-\publishers{installiert von Jonas Borho \& Simon Ziegler}
-
-\newcommand{\rarrow}{$\rightarrow$ }
-\newcommand{\larrow}{$\leftarrow$ }
-\newcommand{\Rarrow}{$\Rightarrow$ }
-\newcommand{\Larrow}{$\Leftarrow$ }
-
-% \let\origGls\Gls
-% \renewcommand{\Gls}[1]{\rarrow\origGls{#1}}
-
-\KOMAoptions{numbers=noendperiod}
-
-
-\begin{document}
-	\maketitle
-
-	\newpage
-
-	\begin{versionhistory}
-		\vhEntry{0.1}{2022-03-24}{Simon Ziegler}{erster Entwurf}
-		\vhEntry{0.2}{2022-04-01}{Simon Ziegler}{Kapitel: Kabel, Abschnitt: Tontechnik}
-	\end{versionhistory}
-
-	\tableofcontents
-	\newpage
-
-	\input{Kabel}
-	\input{Streamdeck}
-	\input{Software}
-	\input{YouTube}
-	\input{Atem Mini}
-	\input{Kameras}
-	\input{Glossar}
-\end{document}