Einführung ins TrampolinTurnen

Latest Changes

0.8.14
- fix web-layout
0.8.13
- Belehrung erweitert (endokrine störung)
- awesome 5.11, sphinx 7.2.6
- fix automatic release of pdf
0.8.11
- update sphinx v7 and awesometheme v5
- darkmode!
- fix release by tagging
  - adding a tag to a commit (v*.*.*) triggers release
  - webpage gets updated
  - pdf is automatically added to release
  - last step: add title & changelog
0.8.5
- Anpassungen am build-system
- kleinere Details am Skript überarbeitet
- externer Review
0.8.2
- Kapitel 1-4 überarbeitet
0.8.0
- Fehlerbilder der Grundsprünge erweitert
- Phasendarstellungen hinzugefügt
- Trampolinaufbauten hinzugefügt
0.7.5
- viel Restrukturierungen des Inhalts
- Grammatik und Rechtschreibprüfung verbessert
- Füllwörter reduziert (viele unnötige "auch")
- Mindestsatz an Aufgaben oder Ausführungen für Grobformen etabliert
- neue Quellen eingearbeitet

Basic Installation for Web-Content

Compiling this document needs Python 3 and a shell. For installation:

git clone ....

pip3 install pipenv
# pip3 install --upgrade pip pipenv wheel setuptools

pipenv install

pipenv shell

Compiling the document:

cd docs
sphinx-build -b html ./ _build/html
# or ?
make html

Viewing the document in a browser:

cd _build/html
python3 -m http.server

In browser go to localhost:8000 to view the documentation.

Generating a PDF (+Install)

Install for Ubuntu / Debian, following Sphinx.LaTeXBuilder

sudo apt install texlive-latex-recommended
sudo apt install texlive-fonts-recommended
sudo apt install texlive-latex-extra
sudo apt install tex-gyre latexmk
sudo apt install texlive-lang-german

Generating the PDF

cd docs/
# make latex
make latexpdf

Generating a DocX (+Install)

Pandoc must be installed, then simply run .\rst2docx.py.

Problems with Pandoc

internal links don't work ("Name <Link>")
leads (small introduction into chapter) is not converted and still has "lead" in front
same for "tip", "caution", "warning", and more?
no TOC

-> could be solved with rstdoc-lib, but that has other problems.

Wie kann ich beitragen?

Schreibfehler gefunden? Bessere Methodik zu bieten? Hilfe und Anmerkungen sind willkommen. Die Quellen befinden sich unter docs/content in Form von reStructuredText-Dateien.

Writing reStructuredText

TODO

switch to markdown / myst-parser
neutrale Anrede konsequenter umsetzen
Einsatz von Klammern reduzieren -> Nebensätze
Grundpositionen den Grundsprüngen vorlargern
- Breitenachsenrotation vw rw
- schraube
- vorgespannte, s-form
- c-plus, c-minus
Jeder Sprung mit festem Schema
- Einleitung
- Leistungsvoraussetzungen
- Bewegungsbeschreibung
- Methodik
- Fehler und Korrekturen
- [Hilfestellung]
Texte in kleinere Abschnitte teilen - um später kompakte Übersichten zu generieren (Aufbau, Hilfestellungen, Fehlerbilder, )
add videos
- basics techniques

orgua / TrampolinTurnen