From 338839bcca9a35f87ba893eccf06f5095178c3e4 Mon Sep 17 00:00:00 2001 From: bratpeki Date: Sat, 27 Jul 2024 16:58:23 +0200 Subject: [PATCH] Changed "midi" to "MIDI", "...SubFx" to "...SubFX" and started testing formats for the glossary --- ADDsynth.adoc | 2 +- FilterModule.adoc | 2 +- Glossary.adoc | 5 ++--- IntroTutorial-HiHatSynthesis.adoc | 2 +- IntroTutorial-KickDrumSynthesis.adoc | 12 ++++++------ IntroTutorial-SnareDrumSynthesis.adoc | 2 +- Introduction.adoc | 4 +++- QuickStart.adoc | 5 +++-- 8 files changed, 18 insertions(+), 16 deletions(-) diff --git a/ADDsynth.adoc b/ADDsynth.adoc index 5698d6f..9849194 100644 --- a/ADDsynth.adoc +++ b/ADDsynth.adoc @@ -160,7 +160,7 @@ image::imgs/add-synth-voice-amplitude-general.png[] - *Pan:* Panning. (100% to the left is random). - *Delay:* delay before the voice starts. - *Bypass GL Filter:* If the voice signal bypasses the global filter. -- *F. Ctl Bypass:* If the voices filter is not affected by cutoff midi CC +- *F. Ctl Bypass:* If the voices filter is not affected by cutoff MIDI CC - *RESON:* Enable/Disable the resonance of the voice. ===== Frequency diff --git a/FilterModule.adoc b/FilterModule.adoc index 0ae6262..0ec9962 100644 --- a/FilterModule.adoc +++ b/FilterModule.adoc @@ -86,6 +86,6 @@ To accomplish that apply it as voice filter to a burst of noise. But make sure the amplitude envelope doesn't go too fast to zero as that would turn off the voice. If F.Track is 100% it's frequencies are proportional to the pitch. To keep in tune you may set Scale to 0 (no velocity impact) -and enable "F. Ctl Bypass" in the voices Amplitude General Settings (no midi cc impact) +and enable "F. Ctl Bypass" in the voices Amplitude General Settings (no MIDI CC impact) ====== diff --git a/Glossary.adoc b/Glossary.adoc index 3b5ca99..1848168 100644 --- a/Glossary.adoc +++ b/Glossary.adoc @@ -1,5 +1,4 @@ // Here goes all the term definitions the user might need to reference while reading the manual. -// We need to figure out a way to sort the items here alphabetically -// https://github.com/zynaddsubfx/user-manual/issues/6 -NOTE: Here by glossary! +[glossary] +Term:: Definition diff --git a/IntroTutorial-HiHatSynthesis.adoc b/IntroTutorial-HiHatSynthesis.adoc index d4204b2..947bd06 100644 --- a/IntroTutorial-HiHatSynthesis.adoc +++ b/IntroTutorial-HiHatSynthesis.adoc @@ -18,7 +18,7 @@ Launch the Ardour session you used for <>. ==== Add a new MIDI track * Create a new Zyn-Fusion MIDI track for our synthesizer, using `Shift + Ctrl + N` ** *Name:* HiHat -** *Instrument:* ZynAddSubFx +** *Instrument:* ZynAddSubFX ** Click `Add and Close` ==== Open the piano roll diff --git a/IntroTutorial-KickDrumSynthesis.adoc b/IntroTutorial-KickDrumSynthesis.adoc index c9767c6..251853a 100644 --- a/IntroTutorial-KickDrumSynthesis.adoc +++ b/IntroTutorial-KickDrumSynthesis.adoc @@ -2,8 +2,8 @@ In the previous section you learned how to load and use existing patches, but th When you're finished with this project you'll know to: -- use the Ardour piano roll to write a basic midi pattern -- use Ardour to loop a basic midi pattern +- use the Ardour piano roll to write a basic MIDI pattern +- use Ardour to loop a basic MIDI pattern - synthesize a custom kick drum using ADDsynth and *envelopes*, *filters*, *and LFOs* .Prerequisites @@ -14,9 +14,9 @@ WARNING: This tutorial assumes that you have completed the Quick Start guide _or Launch the Ardour session you created for the <>. ==== Add a new MIDI track -* Create a new Zyn-Fusion midi track for our synthesizer, using `Shift + Ctrl + N` +* Create a new Zyn-Fusion MIDI track for our synthesizer, using `Shift + Ctrl + N` ** *Name:* Kick -** *Instrument:* ZynAddSubFx +** *Instrument:* ZynAddSubFX ** Click `Add and Close` image::screenshots/ardour-new-track.png[] @@ -31,11 +31,11 @@ image::screenshots/ardour-open-piano-roll.png[] image::screenshots/ardour-enable-draw-mode.png[] -- Draw a midi area that is 1 *beat* / 4 *measures* long. Don't worry if you don't know what that means, you can just draw from the `1` to the `2` following the `Bars:Beats` bar. See the image below. +- Draw a MIDI area that is 1 *beat* / 4 *measures* long. Don't worry if you don't know what that means, you can just draw from the `1` to the `2` following the `Bars:Beats` bar. See the image below. image::screenshots/ardour-draw-midi-area.png[] -==== Draw your midi pattern +==== Draw your MIDI pattern I'm just going to place a simple 4/4 pattern. You can do anything you like, but don't get too crazy yet, it's going to be repeating behind you while you sculpt the sound. image::screenshots/ardour-midi-4-4-pattern.png[] diff --git a/IntroTutorial-SnareDrumSynthesis.adoc b/IntroTutorial-SnareDrumSynthesis.adoc index b95bc8a..c563a4a 100644 --- a/IntroTutorial-SnareDrumSynthesis.adoc +++ b/IntroTutorial-SnareDrumSynthesis.adoc @@ -17,7 +17,7 @@ Launch the Ardour session you used for the <>. ==== Add a new MIDI track * Create a new Zyn-Fusion MIDI track for our synthesizer, using `Shift + Ctrl + N` ** *Name:* Snare -** *Instrument:* ZynAddSubFx +** *Instrument:* ZynAddSubFX ** Click `Add and Close` ==== Open the piano roll diff --git a/Introduction.adoc b/Introduction.adoc index 6a715c3..4fb7775 100644 --- a/Introduction.adoc +++ b/Introduction.adoc @@ -12,10 +12,12 @@ within your favorite DAW. === About the User Manual +// TODO: This manual aims to teach the user... + The Manual was divided into several sections: Introduction:: We're starting with a few simple tutorials to get the user hands-on with the synthesizer as fast as possible. -Basic:: We start to cover everything from top to bottom. If you're fairly new to Zyn-Fusion ,this part should provide you with a comprehensive, yet not overwhelming instruction. +Basic:: We start to cover everything from top to bottom. If you're fairly new to Zyn-Fusion, this part should provide you with a comprehensive, yet not overwhelming instruction. Advanced:: We go into more detail and cover things that were skipped in the previous part. More advanced users should benefit from this part, adding depth to their understanding of the synthesizer. For newcomers, this part might be too confusing. Glossary:: A glossary appendix with various terms indexed alphabetically Routing Diagrams:: Signal routing diagrams that should let you gain a deep understanding of the inner workings of the synthesizer. diff --git a/QuickStart.adoc b/QuickStart.adoc index 001c63e..8a05a34 100644 --- a/QuickStart.adoc +++ b/QuickStart.adoc @@ -1,5 +1,6 @@ *This quick-start will guide you through the process of using Ardour to launch Zyn-Fusion and then using Zyn-Fusion to open an existing patch and modify it.* +// TODO: Were the unfamiliar terms covered? Maybe just get rid of this sentence and update the glossary. Don't worry if some or most of these terms are unfamiliar, we'll cover them soon but for now we want to get you having fun making sounds! When you're finished with this project you'll learn some fundamentals such as: @@ -21,9 +22,9 @@ WARNING: This guide expects that you are starting with a working installation of ** I named mine *QuickStart* but you can choose any name you'd like ==== Add your first track -* Create a new Zyn-Fusion midi track for our synthesizer, using `Shift + Ctrl + N` +* Create a new Zyn-Fusion MIDI track for our synthesizer, using `Shift + Ctrl + N` ** *Name:* Synth -** *Instrument:* ZynAddSubFx +** *Instrument:* ZynAddSubFX ** Click `Add and Close` image::screenshots/ardour-new-track.png[]