Merge pull request #41 from Ultraschall/prepare-5.1

Prepare 5.1

README.md

@@ -9,3 +9,12 @@ The manual is currently in a beta status.
 **English version:**
 
 ➡️ To the [manual](https://ultraschall.github.io/ultraschall-manual/en/)
+
+---
+
+#### Dependencies
+- Read the official installation manual of docusaurus [here](https://docusaurus.io/docs/installation)
+#### Build
+- Clone the repository
+- Change to the directory and run `npm install`.
+- To start the local test server, run `npm run start`.

docs/Anpassungen-und-Shortcuts.md

@@ -80,40 +80,43 @@ Du erkennst, dass dein Shortcut richtig gesetzt ist, wenn in der Shortcut-Liste
 
 ### General Settings
 
-![general-settings](https://raw.githubusercontent.com/Ultraschall/ultraschall-manual/main/assets/images/Anpassungen-und-Shortcuts/settings_general.png))
+![general-settings](https://raw.githubusercontent.com/Ultraschall/ultraschall-manual/main/assets/images/Anpassungen-und-Shortcuts/settings_general.png)
 
 Folgende Einstellungen können vorgenommen werden:
 
 * Show the start screen
- * Show Ultraschall start screen on launch
+ * Ultraschall-Startbildschirm beim Start anzeigen
 * Check for updates
- * Check for Ultraschall updates on launch. Only a message is displayed. No further data is transferred.
+ *  Beim Start auf Ultraschall-Updates prüfen. Only a message is displayed. No further data is transferred.
 * Preroll time preview
- * Set the time in seconds by which the program jumps back when the <kbd>p</kbd> key is used to preview cuts.
+ * Legen Sie die Zeit in Sekunden fest, um die das Programm zurückspringt, wenn die <kbd>p</kbd>-Taste zur Schnittvorschau verwendet wird.
 * Preroll time recording
- * Set the time in seconds by which the program jumps back for a preroll recording.
+ * Legen Sie die Zeit in Sekunden fest, um die das Programm bei einer Preroll-Aufnahme zurückspringt.
 * Preshow music mix
- * Play some music from the Ultraschall-Soundboard in your preshow to entertain the livestream. If you choose the preshow routing preset, you can mix none (0) some or all (1) of the music to your headphones mix.
+ * Spielen Sie zur Unterhaltung des Livestreams Musik aus dem Ultraschall-Soundboard in Ihrer Preshow ab. Wenn Sie die Preshow-Routing-Voreinstellung wählen, können Sie keine (0), einige oder alle (1) Musikstücke in Ihren Kopfhörermix mischen.
 * Soundboard ducking during recording
- * Activate ducking of the soundboard during recording. If anyone starts to talk to a microphone, the Soundboard track will be gently reduced in volume.
+ * Aktivieren Sie das Ducking des Soundboards während der Aufnahme. Wenn jemand beginnt, in ein Mikrofon zu sprechen, wird die Lautstärke der Soundboard-Spur sanft reduziert.
 * Soundboard ducking during editing
- * Activate ducking of the soundboard during editing. If anyone starts to talk to a microphone, the Soundboard track will be gently reduced in volume.
+ * Aktivieren Sie das Ducking des Soundboards während der Bearbeitung. Wenn jemand beginnt, in ein Mikrofon zu sprechen, wird die Lautstärke der Soundboard-Spur sanft reduziert.
 * Marker ping sound during playback
- * Play a sound if a chapter- oder edit-marker is passed during playback
+ * Einen Ton abspielen, wenn während der Wiedergabe eine Kapitel- oder Bearbeitungsmarkierung passiert wird
 * Volume of Ping-Sound
- * Set volume of the ping sound
+ * Lautstärke des Pingtons einstellen
 * Followmode auto detection
- * Turns off Follow Mode when clicking into Arrange View. Disable this if you encounter problems with the Followmode.
+  * Schaltet den Verfolgungsmodus aus, wenn Sie in die Anordnungsansicht klicken. Deaktivieren Sie dies, wenn Sie Probleme mit dem Folgemodus haben.
 * Graceful Soundcheck
- * Set all open soundcheck warnings to the _ignore_ state by closing the soundcheck window.
+ * Setzen Sie alle offenen Soundcheck-Warnungen in den Status _ignore_, indem Sie das Soundcheck-Fenster schließen.
 * Recording safemode
- * Warn about an unwanted stop of the recording after hitting <kbd>SPACE</kbd> or <kbd>RETURN</kbd>.
+ * Warnung vor einem ungewollten Stopp der Aufnahme nach dem Drücken. <kbd>SPACE</kbd> oder <kbd>RETURN</kbd>.
 * Autocolor tracks - Sonic Rainboom
- * New tracks get a unique color. Local tracks start with blue, remote tracks (StudioLink) will be orange and the Soundboard grey.
+ * Neue Spuren erhalten eine eigene Farbe. Lokale Spuren beginnen mit blau, entfernte Spuren (StudioLink) sind orange und das Soundboard grau.
 * Autoarrange track height
- * Zoom or shrink tracks to fit the arrangeview|if new tracks or envelopes are added. 
+ * Vergrößern oder Verkleinern von Spuren zur Anpassung an die Anordnung, wenn neue Spuren oder Hüllkurven hinzugefügt werden.
 * Large marker manager
- * Give way more space to the marker manager on the right. 
+ * Geben Sie dem Marker-Manager auf der rechten Seite mehr Platz.
+* Ping sound when render is finished/aborted
+ * Spielt einen Sound ab, wenn das Rendering fertig ist oder abgebrochen wurde. Die Lautstärke stellst du mit dem Regler für Ping Sounds ein. 
+
 
 ### Soundcheck Settings
 

docs/Export.md

@@ -80,9 +80,13 @@ Nicht alle Podcatcher gehen gleich (gut) mit Kapitelmarken um. Für maximale Kom
 
 ### 2. Render-Assistent
 
-Einmal kurz durchatmen, bevor du den Render-Assistenten[[20]](GUI-overview) öffnest, denn der gibt dir *sehr* viele Einstellmöglichkeiten, von denen wir dir hier nur die wichtigsten erklären. Die meisten anderen sind entweder für die Musikproduktion mit REAPER gedacht und/oder haben einen sinnvollen Default-Wert, den du nur ändern solltest, wenn du ganz genau weißt, was du tust.
+Einmal kurz durchatmen, bevor du den Render-Assistenten[[20]](GUI-overview) öffnest, denn der gibt dir *sehr* viele Einstellmöglichkeiten, daher sind die häufigsten Formate (MP3, M4A, Auphonic Multichannel) als Voreinstellungen verfügbar. Wenn du eigene Voreinstellungen bereits erstellt und gespeichert hast, sind diese ebenfalls unter `Render using preset` erreichbar.
 
-Drückst du links unten in Ultraschall auf das Render-Icon[[20]](GUI-overview) (oder wählst den Punkt `Start Export Assistant` über das Menü `Podcast`>`Export`), prüft Ultraschall, ob alle vorhandenen Spuren auch hörbar sein werden. Hast du einzelne Spuren absichtlich oder unabsichtlich stummgeschaltet, erhältst du auf dem Weg zum Render-Assistenten folgende Warnung:
+![Reder preset Auswahl](https://raw.githubusercontent.com/Ultraschall/ultraschall-manual/main/assets/images/Export/render-preset.png) **Warning muted tracks:** *Ultraschall hat einige nütziche Voreinstellungen für den Export zur Auswahl: MP3, M4A, Auphonic Multichannel .*
+
+ von denen wir dir hier nur die wichtigsten erklären. Die meisten anderen sind entweder für die Musikproduktion mit REAPER gedacht und/oder haben einen sinnvollen Default-Wert, den du nur ändern solltest, wenn du ganz genau weißt, was du tust.
+
+Drückst du links unten in Ultraschall auf das Render-Icon[[20]](GUI-overview) (oder wählst den Punkt `Start Export Assistant` über das Menü `Podcast`>`Export`), prüft Ultraschall, ob alle vorhandenen Spuren auch hörbar sein werden. Hast du den Mastertrack oder einzelne Spuren absichtlich oder unabsichtlich stummgeschaltet, erhältst du auf dem Weg zum Render-Assistenten folgende Warnung:
 
 ![Warning-muted-tracks](https://raw.githubusercontent.com/Ultraschall/ultraschall-manual/main/assets/images/Export/2-warning.png) **Warning muted tracks:** *Ultraschall warnt dich, wenn du ein Projekt exportieren willst, in dem eine oder mehrere Spuren stumm sind.*
 
@@ -114,7 +118,7 @@ Klickst du stattdessen auf `Yes`, öffnet sich der Assistent – in diesem Fall
 
 Der Export-Assistent[[21]](GUI-overview) hilft dir dabei, dein Projekt nun fertigzustellen. Ein Ampelsystem zeigt dir an, was deinem Projekt noch fehlt. Sollten Metadaten gänzlich fehlen, zeigt die Ampel rot und rechts daneben steht `Missing`; falls Metadaten vorliegen, diese aber unvollständig sind, zeigt die Ampel gelb und `Incomplete` oder `Unknown` an. Wenn alle Ampeln auf grün stehen, hast du alles richtig gemacht.
 
-![export-icons](https://raw.githubusercontent.com/Ultraschall/ultraschall-manual/main/assets/images/Export/3-export-assistant.png) **Export-Assistent**: _Der Assistent hilft dir dabei, dein Projekt fertigzustellen._
+![export-icons](../assets/images/Export/3-export-assistent.png) **Export-Assistent**: _Der Assistent hilft dir dabei, dein Projekt fertigzustellen._
 
 #### 1. Export MP3
 
@@ -133,16 +137,20 @@ Metadaten sind zwar optional, aber trotzdem wichtig für die Weiterverarbeitung
 
 #### 4. Podcast Episode Image
 
-Das hier hinterlegte Bild wird später in den meisten Podcatchern als Bild zur Episode angezeigt. Zieh per Drag-and-Drop dein Episoden-Cover einfach in den Export-Dialog. Das Bild landet dann automatisch mit im Projektordner. Unterstützte Formate sind `.JPG`, `.JPEG` und `.PNG`. Ultraschall merkt sich die vier zuletzt benutzten Episoden-Bilder und bietet sie dir zur schnellen Auswahl hier an. Das jeweils ausgewählte Bild wird links davon groß angezeigt.
+Das hier hinterlegte Bild wird später in den meisten Podcatchern als Bild zur Episode angezeigt. Zieh per Drag-and-Drop dein Episoden-Cover einfach in den Export-Dialog. Das Bild landet dann automatisch mit im Projektordner. Unterstützte Formate sind `.jpg`, `.jpeg` und `.png`. Ultraschall merkt sich die vier zuletzt benutzten Episoden-Bilder und bietet sie dir zur schnellen Auswahl hier an. Das jeweils ausgewählte Bild wird links davon groß angezeigt.
 
 :::info Info
-Für Linux-Nutzende: Aktuell muss die Dateiendung tatsächlich groß geschrieben werden. `.png` funktioniert also nicht. Das wird in der Zukunft korrigiert und dieser Hinweis dann verschwinden.
+Für Linux-Nutzende: Aktuell muss die Dateiendung tatsächlich klein geschrieben werden. `.PNG` funktioniert also nicht. Das wird in der Zukunft korrigiert und dieser Hinweis dann verschwinden. In einer früheren Version war das genau anders herum. Jetzt gehen nur noch kleingeschriebene Dateiendungen. 
 :::
 
 #### 5. Finalize MP3
 
 Für den letzten Schritt klickst du einmal auf die Schaltfläche `Finalize MP3!`. Falls noch Probleme vorliegen, zeigt dir der Assistent einen Dialog mit einer entsprechenden Warnung an. Falls der Assistent deine MP3-Datei nicht automatisch gefunden hat, musst du diese jetzt noch einmal manuell angeben. Hat alles geklappt, erscheint eine Erfolgsmeldung – deine Podcast-Episode wurde erfolgreich exportiert!
 
+#### 6. Export Video Audiogram
+
+Diese Option ist rein optional. Ultraschall bietet dir hier die Möglichkeit, ein kurzes Video zu rendern, mit dem du deinen Podcast z.B. auf Social Media bewerben kannst. Wähle dafür zunächst in deiner Audiospur ein Segment aus, das du gerne in dem Video haben möchtest. Vervollständige jetzt noch deine Metadaten und füge ein Episoden Bild ein. Sind alle Voraussetzungen erfüllt, erscheint rechts der Button: `Export MP4 Audiogram` mit dem du das Video exportieren kannst. Das fertige Video findest du dann im Projektordner als `Audiogram.mp4`.
+
 <!--
 @todo: immer noch notwendig oder schon beantwortet
 ### Metadaten bearbeiten und exportieren

docs/Glossar.md

@@ -13,20 +13,21 @@ Dieses Kapitel wird erst mit der V2 bearbeitet
 
 ### Clipping
 
-xxx
+Unter Audio-Clipping oder übersetzt "Übersteuern" versteht den Prozess wenn man die Lautstärke des Audios die erlaubte Lautstärke übersteigt. Die Folge ist, dass Teile des Signal angeschnitten werden. Deutlich hörbar durch eine Audio Affekte. 
 
 ### DAW: Digital Audio Workstation
 
-xxx
+Eine Digital Audio Workstation ist eine Software in der man Audio Aufnehmen und bearbeiten kann.
 
 ### Mute
 
-xxx
+`Mute`= Stummschalten
 
 ## Spezifisches für REAPER/Ultraschall
 
 ### Edit-Cursor
 
+Der Edit-Curser ist 
 xxxx; siehe auch #play-cursor
 
 ### Envelope
@@ -35,19 +36,19 @@ Bei Audio beschreibt ein Envelope wie sich der Sound mit der Zeit verändert.
 
 ### FX
 
-xxx
+FX beschreibt hier einen Sound Effect. Effekte können dazu dienen, den Klang zu verändern, zu verbessern oder zu verfremden. Es gibt verschiedene Arten von Audioeffekten, darunter Hall, Echo, Verzerrung, Equalizer und viele andere.
 
 ### Play-Cursor
 
 xxxx; siehe auch #edit-cursor
 
 ### Routing Matrix
 
-xxx
+Die Routing Matrix ist in Reaper die genaue Einstellung, welches Audiogerät auf welche Spur abgebildet wird. 
 
 ### Spur
 
-xxx
+Eine Spur ist ein Teil eines Audio-Projekts, die bei Bedarf wiedergegeben wird. Audiospuren können getrennt voneinander bearbeitet werden und dienen dazu, akustische Signale wiederzugeben.
 
 ### Track
 

docs/Mithelfen-und-comunity.md

@@ -0,0 +1,46 @@
+---
+id: mithelfen-und-community
+title: Mithelfen und Community
+lektorat:
+ - Lektorat: todo
+ - Schlusskorrektur: todo
+tags:
+ - mithelfen
+ - community
+---
+
+Ultraschall ist ein Projekt von Leuten in ihrer Freizeit. Das aktive Team beteht aktuell nur aus einer Handvoll an Leuten. Daher sind wir immer auch der Suche nach neuen Leuten, die Lust haben, in das Projekt einzusteigen und neue Ideen mitbringen. Wir wollen hier einen Einblick darüber geben, wie man am besten loslegt mit Ultraschall.
+
+Ultraschall besteht aus mehreren Komponenten, die unterschiedliche Techniken und daher auch unterschiedliche Kenntnisse brauchen. Grob gesagt gibt es die folgenden Bereiche: 
+- Ultraschall Plugin
+ - beinhaltet die ganze Entwicklung des Plugins für Reaper. Hier wird sogut wie alles in der Skriptsprache Lua geschrieben. Lua ist eine recht gut erlernbare Programmiersprache. 
+ - aktuell arbeiten hauptsächlich [Ralf](https://github.com/rstockm) und [Mesopotine](https://github.com/mespotine) daran
+ - [Link zum Github Repository](https://github.com/Ultraschall/ultraschall-portable)
+- Ultraschall Installer
+ - Das Plugin muss irgendwie auf den Rechner kommen. Dafür gibt es seit einiger Zeit einen eigenen Installer. Der Installert ist für jedes Betriebssystem anders und braucht daher unterschiedliche Techniken größtenteils Shell-Skripte, aber auch anderes. 
+ - aktuell arbeitet hier hauptsächlich [Heiko](https://github.com/heikopanjas) dran
+ - [Link zum Github Repository](https://github.com/Ultraschall/ultraschall-installer)
+- Ultraschall Soundboard
+ - Das Soundboard ist ein eigenes Plugin. Mit dem Soundboard können Sounds auf Knopfdruck während des Podcasts abgespielt werden. Das Soundboard ist in C++ entwickelt
+ - Das Soundboard wurde von [Daniel](https://github.com/danlin) entwickelt. 
+ [Link zum Github Repository](https://github.com/Ultraschall/ultraschall-soundboard)
+- Ultraschall Handbuch
+ - Wie lernt man, eine neue Software zu bedienen? Wir versuchen es dir beizubringen. Wenn du das hier liest, hast du vermutlich auch schon etwas in unser Handbuch reingelesen. Das Handbuch haben wir mit Docusaurus umgesetzt. Die Texte sind dabei jeweils in Markdown formatiert und Docusaurus macht den Rest. 
+ - Die Liste an Mitwirkenden findest du [hier](partcipants) 
+ - [Link zum Github Repository](https://github.com/Ultraschall/ultraschall-manual)
+
+
+### Ultraschall Handbuch
+Um beim Handbuch mitzuwirken, hast du verschiedene Möglichkeiten: 
+- **ganz einfach**: Du schreibst Texte und schickst sie einem von uns, wir schauen uns das an und fügen die Texte ein
+- **Mittel** Du forkst das Repository und editiert in einem Texteditor deiner Wahl Texte und erstellst einen Pull-Request
+- **Forgeschritten**: Du forkst das Repository und installierst Dokusaurus und startest die Entwicklerumgebung
+- **Community**: Du wirst Teil des Teams und kannst Branches in dem Repository erstellen
+
+Um damit loszulegen braucht es im Grunde genommen nicht viel. Ein einfacher Texteditor reicht Um Markdown-Dokumente zu bearbeiten. Wenn du noch nicht Teil des Teams bist, kannst du einfach das Handbuch forken und dann klonen. Danach kannst mit deiner Bearbeitung beginnen. 
+
+Docusaurus bietet allerdings auch noch mehr Komfort in dem es einen Entwicklerserver anbietet. Um den zu nutzen, musst du ein paar Sachen installieren. Du musst `Node` und `npm` installieren. Wie das funktioniert hängt von deinem Betriebssystem ab. Wenn das installiert ist, kannst du im Handbuch Ordner, `npm install` alle weiteren Abhängigkeiten installieren. Danach kannst du mit `npm run start` den Entwicklerserver starten. Sobald du eine Datei speichert, wird diese dann neu geladen und man sieht im Browser direkt die Änderungen. 
+
+Wenn du mit der Bearbeitung fertig ist, kannst du einen Pull-Request erstellen und wir schauen uns dann an, was du gemacht hast und ob wir deine Bearbeitung so übernehmen können. Wenn alles passt, mergen wir deinen Pull-Request und deine Änderungen tauchen im Handbuch auf. 
+
+Unser online einsehbares Handbuch wird immer automatisch von einem Github-Workflow gebaut und veröffentlicht. Sobald dein Beitrag als im Main-Branch ist, taucht er wenige Minuten später auch online auf. 

docs/Post-Produktion.md

@@ -201,6 +201,9 @@ Dabei gehst du wie folgt vor: Du suchst dir in der betreffenden Spur eine Passag
 
 Das klappt aber nur, wenn du während der Aufnahme nicht am Gain-Regler gedreht hast. Hast du während der Aufnahme den Eingangspegel verändert – und hast beispielsweise zu Beginn sehr leise, später dann eher laut aufgenommen – , wird das Abmischen etwas komplizierter. Entweder teilst du die Spur an der entsprechenden Stelle auf zwei Spuren mit jeweils individuellen Effekteinstellungen auf oder du greifst zu einem automatischen Klangverbesserungsdienst wie [Auphonic](https://auphonic.com/).
 
+### Manuelles Ducking
+Es gibt eine Action, die manuelles Ducking von Tracks in der Post-Produktion erlaubt. Die Action hat in der Standardeinstellung keinen Shortcut, aber wie du einen eigenen shortcut hinzufügst, haben wir [hier](#adaption) erklärt. Um die Action zu verwenden, wählt man die Tracks aus, die geduckt werden sollen, wählt eine Time-Selection und dann führt man die Action `Manual ducking of selected tracks within time-selection(Volume pre fx-envelope` aus. In die Volume-Automationsspuren der gewählten Tracks werden nun Lautstärkepunkte eingezeichnet und der ausgewählte Zeitbereich herabgesenkt um 8dB. 
+
 **Hier auch ein Video dazu:** <!-- @todo gif mit US 3.1 das müssen wir neu machen -->
 ![Noisegate anpassen](https://raw.githubusercontent.com/Ultraschall/ultraschall-manual/main/assets/images/Post-Produktion/LUFS_004.gif) **Ultraschall Dynamics:** _So veränderst du die Schwelle für die Rauschunterdrückung)._