mkdocs.yml

site_name: Csound 7 Manual
site_url: https://csound7_manual
theme:
  name: material
  palette:
    # Light Mode
    - scheme: default
      toggle:
        icon: material/weather-night
        name: Light mode
      primary: blue
      accent: deep orange
    # Dark Mode
    - scheme: slate
      toggle:
        icon: material/weather-sunny
        name: Dark mode
      primary: green
      accent: deep purple
  features:
    - navigation.footer

extra_css:
  - stylesheets/extra.css

markdown_extensions:
  - md_in_html
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets:
      base_path: 'docs/'
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - attr_list:
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.arithmatex:
      generic: true

extra_javascript:
  - javascripts/mathjax.js
  - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js

plugins:
  - offline:
      enabled: !ENV [OFFLINE, false]
  - search

nav:
- Home: 'index.md'
- Introduction:
  - What's New in Csound 7: 'intro/whats-new-in-csound-7.md'
  - Historical:
    - Historical Preface: 'intro/historic-preface.md'
    - History of the Manual: 'intro/history-of-the-manual.md'
  - Nomenclature: 'overview/nomenclature.md'
  - Copyright Notice: 'intro/copyright-notice.md'
  - Links and Front Ends: 'overview/links.md'
- Csound System:
  - How Csound Works: 'invoke/how-csound-works.md'
  - Configuring: 'overview/configuring.md'
  - Real-Time Audio:
    - 'overview/rt-audio.md'
    - Real-Time I/O on Linux: 'overview/rt-io-on-linux.md'
    - Mac OSX: 'overview/rt-io-on-mac-osx.md'
    - Windows: 'overview/rt-io-on-windows.md'
    - Realtime I/O with JACK Connection Kit: 'overview/rt-io-with-jack.md'
  - The `csound` Command: 'invoke/the-csound-command.md'
  - The `.csd` File Format: 'invoke/the-csd-file-format.md'
  - Csound Options:
    - 'invoke/cs-options.md'
    - Alphabetically: 'invoke/cs-options-alphabetically.md'
    - By Category: 'invoke/cs-options-by-category.md'
  - Order of Precedence: 'invoke/order-of-precedence.md'
  - Environment Variables: 'invoke/environment-variables.md'
  - Tables and Guard Points: 'invoke/guard-point.md'
  - UDP Server: 'overview/udp-server.md'
  - Syntax of the Orchestra:
    - Header Statements and Global Space: 'orch/header.md'
    - Instruments: 'orch/instruments.md'
    - Data Types and Variables: 'orch/data-types.md'
    - Macros: 'orch/macros.md'
    - User Defined Opcodes (UDO): 'orch/user-defined-opcodes.md'
    - Traditional and Functional Code: 'orch/traditional-functional-code.md'
    - Amplitudes Values: 'orch/amplitudes.md'
  - Syntax of the Score:
    - Parameter Fields: 'score/parameter-fields.md'
    - Preprocessing: 'score/preproc.md'
    - Durations in Instrument Events: 'score/note-durations.md'
    - Score Statements: 'score/statements.md'
    - Macros: 'score/macros.md'
    - Included Files: 'score/mult.md'
    - Expressions: 'score/eval.md'
    - Scripts: 'score/scripts.md'
    - CsBeats: csbeats.md
- Overview:
  - Opcodes Categories:
    - Signal Generators:
      - Additive Synthesis/Resynthesis: 'siggen/additive.md'
      - Basic Oscillators: 'siggen/basic.md'
      - Dynamic Spectrum Oscillators: 'siggen/dynamic.md'
      - FM Synthesis: 'siggen/fmsynth.md'
      - Granular Synthesis: 'siggen/granular.md'
      - Hyper Vectorial Synthesis: 'siggen/hvs.md'
      - Linear and Exponential Generators: 'siggen/lineexp.md'
      - Envelope Generators: 'siggen/envelope.md'
      - Models and Emulations: 'siggen/models.md'
      - Phasors: 'siggen/phasors.md'
      - Random (Noise) Generators: 'siggen/random.md'
      - Sample Playback and Soundfonts: 'siggen/sample.md'
      - Scanned Synthesis: 'siggen/scantop.md'
      - Table Access: 'siggen/tableacc.md'
      - Wave Terrain Synthesis: 'siggen/waveterr.md'
      - Waveguide Physical Modeling: 'siggen/wavguide.md'
    - Signal Modifiers:
      - Amplitude Modifiers and Dynamic processing: 'sigmod/ampmod.md'
      - Convolution and Morphing: 'sigmod/conmorph.md'
      - Delay: 'sigmod/delayops.md'
      - Panning and Spatialization: 'sigmod/panspatl.md'
      - Reverberation: 'sigmod/reverbtn.md'
      - Sample Level Operators: 'sigmod/sample.md'
      - Signal Limiters: 'sigmod/siglimit.md'
      - Special Effects: 'sigmod/speciale.md'
      - Standard Filers: 'sigmod/standard.md'
      - Specialized Filters: 'sigmod/speciali.md'
      - Waveguides: 'sigmod/wavguide.md'
      - Waveshaping and Phase Distortion: 'sigmod/wavshape.md'
    - Array Opcodes: 'math/array.md'
    - Signal Input and Output:
      - File Input and Output: 'sigio/fileio.md'
      - Signal Input: 'sigio/input.md'
      - Signal Output: 'sigio/output.md'
      - Printing and Display: 'sigio/pdisplay.md'
      - Sound Files Queries: 'sigio/queries.md'
    - Signal Routing:
      - Software Bus: 'sigio/softbus.md'
      - Zak Patch System:
        - 'sigrouting/zak/top.md'
      - Mixer Opcodes: 'sigrouting/mixer.md'
      - Signal Flow Graph Opcodes: 'sigrouting/signalflowgraph.md'
    - Instrument Control:
      - Clock Control: 'control/clockctl.md'
      - Conditional Values: 'control/conditional.md'
      - Duration Control Statements: 'control/durctl.md'
      - Instrument Invocation: 'control/invocat.md'
      - Program Flow Control: 'control/pgmctl.md'
      - Realtime Performance Control: 'control/realtime.md'
      - Initialization and Reinitialization: 'control/reinitn.md'
      - Sensing and Control: 'control/sensing.md'
      - Stacks: 'control/stacks.md'
      - Sub-instrument Control: 'control/subinstr.md'
      - Time Reading: 'control/timeread.md'
    - Function Table Control:
      - 'table/top.md'
      - Table Queries: 'table/queries.md'
      - Read/Write Operations: 'table/readwrit.md'
      - Table Reading with Dynamic Selection: 'table/select.md'
    - Mathematical Operations:
      - Amplitude Converters: 'math/amp.md'
      - Arithmetic and Logic Operations: 'math/artlogic.md'
      - Comparators and Accumulators: 'sigmod/compaccum.md'
      - Complex number Operations: 'math/complex.md'
      - Mathematical Functions: 'math/mathfunc.md'
      - Opcode Equivalents of Functions: 'math/opeqfunc.md'
      - Random Functions: 'math/rndfunc.md'
      - Trigonometric Functions: 'math/trig.md'
      - Linear Algebra Opcodes: 'math/linearalgebra.md'
    - Pitch Converters:
      - Functions: 'pitch/funcs.md'
      - Tuning Opcodes: 'pitch/tuning.md'
    - Real-time MIDI Support:
      - 'midi/top.md'
      - MIDI input and Initialization: 'midi/input.md'
      - MIDI Message Output: 'midi/output.md'
      - Generic MIDI Input and Output: 'midi/generic.md'
      - Converters: 'midi/convert.md'
      - Event Extenders: "midi/extender.md"
      - Note-on/Note-off Output: "midi/onoff.md"
      - MIDI/Score Interoperability opcodes: "midi/interop.md"
      - System Realtime Messages: 'midi/realtime.md'
      - Slider Banks: 'midi/sliderbk.md'
    - Spectral processing:
      - 'spectral/top.md'
      - Streaming Spectral Processing: 'spectral/realtime.md'
      - Linear Predictive Coding (LPC): 'spectral/lpcresyn.md'
      - Phase Vocoder Resynthesis: 'spectral/stft.md'
      - ATS Spectral Processing: 'spectral/ATS.md'
      - Array-based spectral opcodes: 'spectral/arrays.md'
      - Non-standard Spectral Processing: 'spectral/nonstand.md'
    - Strings:
      - 'strings/top.md'
      - String Manipulation Opcodes: 'strings/manipulate.md'
      - String Conversion Opcodes: 'strings/convert.md'
    - Vectorial opcodes:
      - 'vectorial/top.md'
      - Tables of vectors operators: 'vectorial/tables.md'
      - Operations Between a Vectorial and a Scalar Signal: 'vectorial/scalar.md'
      - Operations Between two Vectorial Signals: 'vectorial/vectorial.md'
      - Vectorial Envelope Generators: 'vectorial/envelopeGenerators.md'
      - Limiting and Wrapping of Vectorial Control Signals: 'vectorial/limiting.md'
      - Vectorial Control-rate Delay Paths: 'vectorial/delay.md'
      - Vectorial Random Signal Generators: 'vectorial/vectorialrandom.md'
    - OSC, Network and non-MIDI Devices:
      - OSC: 'oscnetwork/OSC.md'
      - Network: 'oscnetwork/Network.md'
      - Remote Opcodes: 'oscnetwork/Remote.md'
      - Non-MIDI Devices: 'oscnetwork/nonMIDIdevices.md'
    - Miscellaneous Opcodes: 'miscopcodes.md'
  - Score Statements: 'score/statemnt.md'
  - GEN Routines: 'score/genroutines.md'
- Reference:
  - Orchestra Opcodes and Operators: 'reference/opcodesReference.md'
  - Score Statements: 'reference/scoreStatementsRef.md'
  - GEN Routines: 'reference/genRoutinesRef.md'
  - Deprecated Opcodes: 'deprecated.md'
- Utility Programs:
  - About: 'utility/top.md'
  - Analysis File Generation: 'utility/analysis.md'
  - File Queries: 'utility/queries.md'
  - File Conversion: 'utility/convert.md'
  - Other Csound Utilities: 'utility/other.md'
- Index and Quick Reference:
  - Opcodes Index: opcodesIndex.md
  - Opcodes Quick Reference: opcodesQuickRef.md 
  - GEN Routines Index: genIndex.md
- Appendices:
  - List of Examples: 'misc/examples.md'
  - Pitch Conversion: 'misc/pitch.md'
  - Sound Intensity Values: 'misc/amp.md'
  - Formant Values: 'misc/formants.md'
  - Modal Frequency Ratios: 'misc/modalfreq.md'
  - Window Functions: misc/windows.md