first bunch of content

docs/assets/voctocat.svg

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="100"
+   height="100"
+   viewBox="0 0 26.458318 26.458333"
+   version="1.1"
+   sodipodi:docname="voctocat.svg"
+   inkscape:version="0.92.1 r">
+   <style>
+      path { fill: black; }
+      @media (prefers-color-scheme: dark) { path { fill: white; } }
+   </style>
+   <path
+      d="M 13.228772,0.30234532 C 6.0691486,0.30234532 0.26458395,6.10691 0.26458395,13.267323 A 12.964978,12.964978 0 0 0 1.1118578,17.862438 C 1.3017821,17.365207 1.5196676,16.879844 1.7942668,16.424026 1.9340722,16.191896 2.0878581,15.966888 2.1904701,15.717085 2.2933458,15.46649 2.3408269,15.183714 2.2622191,14.924942 2.2173761,14.77775 2.1329652,14.644803 2.041696,14.521352 1.9501631,14.397374 1.8499251,14.280254 1.7665694,14.150736 1.5544871,13.821798 1.4571509,13.41689 1.5122817,13.029655 c 0.055395,-0.387763 0.2643115,-0.754423 0.5792695,-0.98708 0.280666,-0.207333 0.6351916,-0.300714 0.9854966,-0.287524 a 1.7568007,1.7568007 0 0 1 0.3455569,0.04748 c 0.4526531,0.109998 0.852022,0.393037 1.1482512,0.751784 0.3671872,0.445795 0.5829625,1.009765 0.6357193,1.584813 0.053284,0.575049 -0.052757,1.160649 -0.2748629,1.693493 -0.3983136,0.954898 -1.1506253,1.725674 -1.5647659,2.673714 -0.3381711,0.774469 -0.4352436,1.638098 -0.3890813,2.482206 0.00633,0.0786 0.016883,0.156688 0.023741,0.235295 a 12.964978,12.964978 0 0 0 3.6193788,3.180442 17.628677,17.628677 0 0 1 -0.1287265,-2.11027 c 0.00184,-0.561333 0.030335,-1.121082 0.084411,-1.675029 C 6.2355962,20.384214 5.9259139,20.109878 5.7061819,19.760892 5.3152541,19.139153 5.2413947,18.352286 5.4023029,17.635586 c 0.1609082,-0.716702 0.5407569,-1.369567 0.997103,-1.944879 0.7528393,-0.948304 1.7362257,-1.715651 2.83515,-2.223699 -0.031654,-0.04352 -0.063308,-0.0881 -0.089689,-0.125561 C 8.7402212,12.686472 8.5012335,11.931786 8.4432007,11.163911 8.3841165,10.387331 8.5065088,9.609695 8.557947,8.8328528 8.5948734,8.2910402 8.5969902,7.7487012 8.6286443,7.2066251 8.6655707,6.5796108 8.7420714,5.9518051 8.9180158,5.3490588 8.981853,5.1306459 9.0599316,4.9124965 9.1839095,4.7212532 A 1.4006925,1.4006925 0 0 1 9.7782155,4.2058195 C 10.05176,4.0976681 10.289429,4.0744551 10.553741,4.1187705 c 0.22105,0.047481 0.425482,0.1569516 0.604593,0.295438 0.179372,0.1376952 0.334214,0.3041429 0.480614,0.4766575 a 7.2975815,7.2975815 0 0 1 1.037725,1.6159402 3.5711064,3.5711064 0 0 1 1.092065,0 7.2865025,7.2865025 0 0 1 1.038254,-1.6162038 C 14.953129,4.718088 15.108496,4.5516403 15.287607,4.4136814 15.46698,4.2754586 15.671148,4.1657246 15.892463,4.1187709 a 1.2680092,1.2680092 0 0 1 0.780009,0.087049 1.4022752,1.4022752 0 0 1 0.594305,0.5170164 c 0.123979,0.1907158 0.202058,0.40781 0.265894,0.6264868 0.175681,0.6027462 0.252178,1.2305519 0.289107,1.8570386 0.03166,0.5423399 0.03429,1.0862616 0.07122,1.6275471 0.05144,0.7771065 0.174888,1.5536852 0.116065,2.3300022 a 4.8549426,4.8549426 0 0 1 -0.703775,2.178064 c -0.03166,0.05012 -0.07017,0.09575 -0.102876,0.145081 0.246374,0.2775 0.597997,0.513324 0.89792,0.614089 a 1.9556938,1.9556938 0 0 0 1.048277,0.04273 1.6504958,1.6504958 0 0 0 0.533898,-0.226327 1.2529736,1.2529736 0 0 0 0.396995,-0.417834 c 0.118703,-0.208389 0.166184,-0.448433 0.192563,-0.687157 0.06726,-0.608813 0,-1.223957 -0.05012,-1.834353 -0.03429,-0.396203 -0.06198,-0.799265 0.0269,-1.1870281 0.06015,-0.2624642 0.177792,-0.5191263 0.374575,-0.7024558 A 1.1057821,1.1057821 0 0 1 21.088206,8.835488 1.3120611,1.3120611 0 0 1 21.618412,8.806466 c 0.379849,0.055401 0.735429,0.2727525 0.947512,0.5921948 0.120548,0.1814838 0.193881,0.3911921 0.237932,0.6048572 0.04378,0.213665 0.05988,0.431286 0.07174,0.648908 0.04115,0.76049 0.03957,1.522034 0.01847,2.283578 -0.01767,0.664735 -0.05539,1.347936 -0.321289,1.957277 -0.341864,0.782117 -1.03034,1.365872 -1.773946,1.785289 a 7.0517349,7.0517349 0 0 1 -1.586925,0.648907 c 0.481933,1.538388 0.732792,3.240586 0.732792,4.967051 a 17.59887,17.59887 0 0 1 -0.134527,2.12557 12.964451,12.964451 0 0 0 6.383571,-11.152254 C 26.192959,6.1071738 20.388395,0.30287299 13.228772,0.30287299 Z M 9.6027982,16.283956 v 1.482994 a 1.8799879,1.8799879 0 0 1 1.0833608,0.362438 1.7378083,1.7378083 0 0 1 0.556057,0.680563 c 0.12134,0.270378 0.166183,0.575841 0.116064,0.867849 a 1.4930169,1.4930169 0 0 1 -0.33184,0.707996 1.6468029,1.6468029 0 0 1 -0.635718,0.457929 1.7383359,1.7383359 0 0 1 -0.7879238,0.122131 V 24.69708 L 17.364903,20.488408 9.6025338,16.283693 Z"
+      id="path2"
+      inkscape:connector-curvature="0"
+      style="stroke-width:0.2637839" />
+</svg>

docs/case2.0/buildup.md

@@ -0,0 +1,5 @@
+---
+title: Buildup Plan
+---
+
+See <https://github.com/voc/checklists/blob/main/source/buildup.pdf>

docs/case2.0/overview.md

@@ -0,0 +1,6 @@
+---
+title: Overview
+order: 0
+---
+
+See <https://c3voc.de/wiki/hardware:room-case-2.0>

docs/case2.0/tips-and-tricks.md

@@ -0,0 +1,40 @@
+---
+title: Tips and Tricks
+order: 99
+---
+
+Something's not working and you want to know how to fix it? Hopefully this page got you covered.
+
+## Preface
+As a general rule: **don't disassemble any of the modules, ever!** This also applies to experienced VOC people!
+
+Everything which needs to be accessed can be reached without violence, especially in the lectern module.
+
+## Lecture Module
+
+### No Signal at Projector
+- Try another HDMI cable
+- Try to use the projector without the lectern module
+- If nothing helps, you can extend the tray all the way and use different ports
+
+### No Audio from the Speaker Laptop
+- Turn on the correct audio source on the ATEM mini:
+    * 3.5mm jack: Turn on "MIC 1"
+    * HDMI audio: Turn on input 1 ("ON" button is shining red or "AFV" is enabled)
+- Other inputs should be off when not needed
+
+![](img/lectern-audio-comp.jpeg)
+
+### Noise/ Humming from the Speaker Laptop/ Lectern Module
+- Turn off the 3.5mm jack input "MIC 1" on the ATEM mini ![](img/lectern-audio-comp.jpeg)
+
+### Fully Extend the Tray
+The lectern module's tray has some cable ties as stoppers which prevent it to be fully extended.
+If the tray is pulled out too much, the cables to the I/O panel will probably get dislodged and **will cram up between rack tray and network switch**!
+So do not pull out the tray more than needed!
+
+In case you need to reach the additional ports (HDMI and secondary SDI) of the UpDownCross, you can get over the stoppers with these steps:
+
+- Pull tray out until stoppers are reached
+- Place your hands with 4 fingers below the tray and the thumb on top ![](img/lectern-tray-stoppers_hands-comp.jpeg)
+- Press up next to the cable tie stopper until it goes past the I/O panel below ![](img/lectern-tray-stoppers-comp.jpeg)

docs/checklists/avtech-daily.md

@@ -0,0 +1,5 @@
+---
+title: "A/V-Tech: Daily Stage Bootup"
+---
+
+See: <https://github.com/voc/checklists/blob/main/source/stage_bootup.pdf>

docs/checklists/avtech-talk.md

@@ -0,0 +1,5 @@
+---
+title: "A/V-Tech: Talk Checklist"
+---
+
+See: <https://github.com/voc/checklists/blob/main/source/talk.pdf>

docs/checklists/camera.md

@@ -0,0 +1,5 @@
+---
+title: Camera Angel
+---
+
+See

docs/checklists/mixer.md

@@ -0,0 +1,5 @@
+---
+title: Video Mixer Angel
+---
+
+TODO: 

docs/faq.md

@@ -0,0 +1,9 @@
+---
+title: FAQ
+---
+
+## I want to be a Camera/ Video Mixer Operator
+TODO: Come to the introduction meeting which will be announced in the Engelsystem of the event.
+
+## I Want to Help With Buildup
+TODO: Just come to an event and talk to us.

docs/index.md

@@ -0,0 +1,14 @@
+# Home
+
+Welcome to the [c3voc](https://c3voc.de) lecture hall operations handbook.
+
+This site is intended for our volunteers (angels) during daily operations, as well as people building up our lecture hall setup.
+
+## For A/V Angels
+TODO: We have checklists with the most important items from the [angel introduction](https://github.com/voc/angel-introduction) lecture.
+
+## For A/V Technicians
+TODO: Checklists
+
+## For Buildup
+TODO: Hall setup

docs/tracker/checking.md

@@ -0,0 +1,6 @@
+---
+title: "Tracker: Checking"
+order: 2
+---
+
+Please refer to [the wiki](https://c3voc.de/wiki/c3tracker:checking) (for now).

docs/tracker/cutting.md

@@ -0,0 +1,6 @@
+---
+title: "Tracker: Cutting"
+order: 1
+---
+
+Please refer to [the wiki](https://c3voc.de/wiki/c3tracker:cutting) (for now).

docs/tracker/index.md

@@ -0,0 +1,38 @@
+---
+title: "Tracker: Overview"
+order: 0
+---
+
+The [CRS Ticket Trakcer](https://github.com/crs-tools/tracker) is the main tool which enables the c3voc to process so many videos during the duration of an event.
+It's a web-application at https://tracker.c3voc.de which is managing all tasks to record, cut, encode and release a talk based on the event's schedule in the [schedule.xml](https://c3voc.de/wiki/schedule) format.
+
+All automation at the c3voc is based on the schedule!
+
+## How to Help Us
+During an event, we may need help cutting and checking talks.
+How urgently help is needed depends on how many people from the team are present and how much help we get for operating the halls.
+
+There are two main kinds of help needed:
+
+- Help with normal cutting and checking: You need a laptop and some headphones
+- Help with broken talks: You need to know your way around in a video editor of your choice and ideally have experience in piecing together audio and video from different sources
+
+Usually only 0-10% of the recordings need manual editing becuase of a broken recording or becuase something was shown which shouldn't be released.
+As you may have guessed this work is quite labor-intensive and can take up to a few hours per talk to reach an state which can be released.
+
+## Tasks
+As mentioned before, we have a highly automated standard cutting workflow, but also a way to manually edit videos if needed.
+
+### Normal Cutting
+The normal process is mostly automated, but needs manual intervention to set the actual start and end of the talk.
+See the [cutting](cutting.md) and [checking](checking.md) pages for a detailed descrption what needs to be done.
+
+### Reparing Talks
+To repair a recording, you need to fetch the source files from where they are stored (depends on the event's specific setup) and do your magic in the video editor of your choice.
+Just make sure to render the output as 1920x1080px with 25 fps and no timecode track.
+
+Remove a timecode track with ffmpeg using:
+
+```shell
+ffmpeg -i inputfile.ext -c:a copy -c:v copy -write_tmcd 0 outfile.ext
+```

docs/tracker/setup.md

@@ -0,0 +1,5 @@
+---
+title: "Tracker: Setup"
+---
+
+Please refer to [the wiki](https://c3voc.de/wiki/c3tracker:setup) (for now).

mkdocs.yml

@@ -0,0 +1,45 @@
+site_name: c3voc Handbook
+repo_url: https://git.hamburg.ccc.de/jtbx/c3voc-docs
+copyright: CC BY 4.0
+markdown_extensions:
+  - smarty
+
+theme:
+  name: shadcn
+  show_title: true
+  show_stargazers: false
+  pygments_style:
+    light: shadcn-light
+    dark: github-dark
+  icon: oui:documentation
+  #icon: assets/voctocat.svg
+  topbar_sections: false
+  show_datetime: false
+# theme:
+#   name: material
+#   plugins:
+#     # - optimize # TODO: needs additional dependencies, see https://squidfunk.github.io/mkdocs-material/plugins/requirements/image-processing/
+#   palette:
+#     # Palette toggle for automatic mode
+#     - media: "(prefers-color-scheme)"
+#       toggle:
+#         icon: material/brightness-auto
+#         name: Switch to light mode
+
+#     # Palette toggle for light mode
+#     - media: "(prefers-color-scheme: light)"
+#       scheme: default
+#       toggle:
+#         icon: material/weather-sunny
+#         name: Switch to dark mode
+#       primary: blue-grey
+#       accent: blue-grey
+
+#     # Palette toggle for dark mode
+#     - media: "(prefers-color-scheme: dark)"
+#       scheme: slate
+#       toggle:
+#         icon: material/weather-night
+#         name: Switch to system preference
+#       primary: pink
+#       accent: pink