Hinweise auf Überarbeitungen oder defekte Links durch Snippets ersetzt

docs/Benutzerhandbuch/BSD.md

@@ -1,7 +1,6 @@
 # <svg viewBox="0 0 24 24" width="1em"><path fill="currentColor" d="M2.69,2C3.54,1.95 6.08,3.16 6.13,3.19C4.84,4 3.74,5.09 2.91,6.38C2.09,4.81 1.34,2.91 2,2.25C2.17,2.08 2.4,2 2.69,2M20.84,2.13C21.25,2.08 21.58,2.14 21.78,2.34C22.85,3.42 19.88,8.15 19.38,8.66C18.87,9.16 17.57,8.7 16.5,7.63C15.43,6.55 14.97,5.26 15.47,4.75C15.88,4.34 19.09,2.3 20.84,2.13M12,2.56C13.29,2.56 14.53,2.82 15.66,3.28C15.17,3.6 14.81,3.85 14.69,3.97C13.7,4.96 14.14,6.83 15.72,8.41C16.7,9.38 17.84,9.97 18.78,9.97C19.46,9.97 19.92,9.68 20.16,9.44C20.33,9.27 20.6,8.88 20.91,8.41C21.42,9.59 21.69,10.88 21.69,12.25C21.69,17.61 17.36,21.97 12,21.97C6.64,21.97 2.31,17.61 2.31,12.25C2.31,6.89 6.64,2.56 12,2.56Z" /></svg> BSD-Systeme
 
-!!! warning "Zu überarbeiten"
-    Die Informationen auf dieser Seite sind teilweise veraltet oder obsolet. Bitte einmal durchsehen und überarbeiten. Die Links sind bereits angepasst.
+--8<-- "top/veraltet.md"
 
 ## FreeBSD
 Von Haus aus bringt FreeBSD Unterstützung für Neo 1.0 in Xorg mit. Für die

docs/Benutzerhandbuch/Sprachen-mit-Neo.md

@@ -28,8 +28,7 @@ Der Thanh nặng (.) kann durch T1(6) oder ♫!a → ạ eingegeben werden, der
 
 ## Afrikanische Sprachen mit Neo
 
-!!! info "Fehlender Inhalt"
-    Dieser Abschnitt existiert noch nicht. Du kannst helfen, ihn aufzubauen.
+--8<-- "fehlender Inhalt.md"
 
 ## Kyrillisch mit Neo
 Einen Modus zum Schreiben des kyrillischen Alphabets ist nicht in Neo 2 enthalten, es gibt aber dennoch bereits eine ausgearbeitete Belegung, die sich für Neo-Nutzer besonders einfach merken lässt und die praktische alle vorkommenden Zeichen abdeckt. Siehe im SVN-Repository unter neo-kyr. Hier die Belegungen von Ebene 1, bzw. Ebene 2.

docs/Entwicklung/Erstellen-von-Grafiken.md

@@ -1,7 +1,6 @@
 # Anleitung und Regeln für das Erstellen von Grafiken
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Eine Überarbeitung der Seite ist angeraten. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/inhaltliche Überarbeitung.md"
 
 ## Bevorzugte Dateiformate
 Wann immer möglich, sollten **alle Grafiken im verlustfreien [SVG-Vektorformat](https://de.wikipedia.org/wiki/Scalable_Vector_Graphics)** erstellt werden. Eine gute und freie Software hierfür ist [Inkscape](https://www.inkscape.org/?lang=de). Dabei solle stets darauf geachtet werden, in der Datei auch stets die CC-BY-SA-Lizenz (genaueres hierzu bei den [Lizenzfragen](/Beitragen/Lizenzfragen)) mit anzugeben; unter Inkscape geht dies komfortabel unter »Datei/Dokument-Metadaten/Nutzungsbedingungen → Lizenz«.

docs/Entwicklung/Treiber-KnowHow-NeoVars.md

@@ -1,7 +1,6 @@
 # NeoVars für Entwickler
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Eine Überarbeitung der Seite ist angeraten. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/inhaltliche Überarbeitung.md"
 
 **Eine schnelle, sehr pragmatische Kurzanleitung zum Verändern von Buchstaben findet sich [hier](http://www.adnw.de/uploads/Main/ADNWMitNeo-TreiberUnterWindows/NeoVarsModAnleitung2.pdf)**
 

docs/Entwicklung/Treiber-KnowHow.md

@@ -1,8 +1,7 @@
 
 # Treiber-Know-How
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Eine Überarbeitung der Seite ist angeraten. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/inhaltliche Überarbeitung.md"
 
 Auf dieser Seite sollen Interna der Treiberentwicklung festgehalten werden.
 Mit welchen Programmen lassen sich die Treiber bearbeiten, welche Möglichkeiten sind schon getestet worden, was kann in der Zukunft noch probiert werden?

docs/Hardware/Ergodox.md

@@ -1,5 +1,7 @@
 # Ergodox
 
+--8<-- "Link defekt.md"
+
 Zu neo und Ergodox gab es mindestens schon eine
 [Diskussion in der Mailingliste](http://comments.gmane.org/gmane.comp.hardware.keyboards.layout.neo/10321)
 
@@ -64,6 +66,8 @@ hinlegen und den Bindestrich dann wieder nach rechts oben neben die 0 legen).
 Die übrigen Tasten links in der unteren Reihe habe ich mangels besserer 
 Ideen einfach mal mit den verbliebenen eher nicht so wichtigen Tasten belegt.«
 
+--8<-- "Link defekt.md"
+
 – zitiert aus <http://permalink.gmane.org/gmane.comp.hardware.keyboards.layout.neo/10366>
 
 ### Vorschlag von ka’imi

docs/Hardware/Ergonomische-Tastaturen.md

@@ -1,7 +1,6 @@
 # Ergonomische Tastaturen
 
-!!! warning "Zu beachten"
-    Dieser Artikel enthält veraltete Informationen. Bitte hilf mit, ihn auf den neuesten Stand zu bringen.
+--8<-- "top/veraltet.md"
 
 Dieser Artikel handelt von ergonomischen, also an den Körper des Menschen angepasste Tastaturen.
 

docs/Hardware/Plover.md

@@ -1,7 +1,6 @@
 # Plover
 
-!!! warning "Fehlerhafte Links"
-    Einige Links zu anderen Dokuseiten funktionieren (noch) nicht und sind auch nicht umgestellt auf die Endung `.md`. Bitte passt die Links an, sobald die entsprechenden Seiten bereitstehen.
+--8<-- "top/fehlerhafte Links.md"
     
 Plover ist ein englischsprachiges Steno-System, dass sich vor allem für
 Fließtexte eignet und dabei höhere Geschwindigkeit bei verringerter Fehlerquote verspricht.

docs/Hardware/Truly.md

@@ -1,5 +1,7 @@
 # Tipps und Tricks zum Truly Ergonomic Keyboard
 
+--8<-- "top/komplette Überarbeitung.md"
+
 Das Truly Ergonomic Keyboard hat ein deutlich anderes Layout als „normale“ Tastaturen, wodurch mit einem Standard-Neo-Treiber Buchstaben an anderen Stellen sitzen, die höheren Ebenen schlechter erreichbar sind, etc.  
 
 Um dieser Problematik entgegenzuwirken, empfiehlt es sich *dringend*, die von der Tastatur gesendeten Scancodes mit Hilfe des vom Hersteller bereitgestellten Tools [Custom Layout Designer](https://www.trulyergonomic.com/store/layout-designer--configurator--reprogrammable--truly-ergonomic-mechanical-keyboard/) umzuprogrammieren. Folgt dafür einfach den Anweisungen der Homepage, die technischen Details sollen nicht Gegenstand dieses Artikels sein. Ihr braucht lediglich Folgendes zu wissen:

docs/Historisch/Cherry.md

@@ -1,7 +1,6 @@
 # Neo-Tastatur von Cherry?
 
-!!! warning "Zu beachten"
-    Dieser Abschnitt enthält veraltete Informationen. Bitte hilf mit, ihn auf den neuesten Stand zu bringen.
+--8<-- "top/veraltet.md"
 
 Am 7. Feb 2006 10:47 schrieb Hanno Behrens auf der yahoo-Liste:
 

docs/Lernen/EigeneKTouchLektionenSchreiben.md

@@ -1,5 +1,7 @@
 # Eigene KTouch-Lektionen schreiben
 
+--8<-- "top/fehlerhafte Links.md"
+
 !!! info "Information"
     Dieses Tutorial ist für KTouch Version 1.7.1 (unter KDE 4.2.3) geschrieben.
 
@@ -82,9 +84,6 @@ german.neo.poems.ktouch.xml
 Ist die Lektion überprüft und ausgiebig getestet worden, so kann sie im Repository unter [ktouch/lectures](https://git.neo-layout.org/neo/neo-layout/src/branch/master/ktouch/lectures) veröffentlicht werden.
 
 ### Upload
-!!! warning "Fehlerhafte Links"
-    Einige Links zu anderen Dokuseiten funktionieren (noch) nicht und sind auch nicht umgestellt auf die Endung `.md`. Bitte passt die Links an, sobald die entsprechenden Seiten bereitstehen.
-    
 Falls man keinen Account für dieses Trac besitzt und es sich nur um den gelegentlichen Upload einer neuen Lektion handelt, so kann man seine Lektion an die [Mailingliste](Mailingliste) schicken.
 
 Alternativ kann man auch jemanden im [IRC](IRC) bitten die Lektion hochzuladen.

docs/Unsortiert/Ebene12.md

@@ -1,9 +1,6 @@
 # Ebenen 1 und 2
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht überarbeitet worden. Interne Links werden größtenteils nicht funktionieren. Bitte einmal durchschauen und Links überprüfen / anpassen.
-
-    Die Inhalte sind noch nicht einsortiert. Sie sind womöglich obsolet oder sollten teilweise in anderen Seiten untergebracht werden. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/komplette Überarbeitung.md"
 
 Die 1. Ebene ist das „Herz“ von Neo, die Neubelegung der Buchstaben. Da das Prinzip „Shift + Kleinbuchstabe = Großbuchstabe“ beibehalten wurde, ergibt sich die Belegung von Ebene 2 daraus (größtenteils) automatisch.
 

docs/Unsortiert/Ebene4.md

@@ -1,9 +1,6 @@
 # Ebene 4
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht überarbeitet worden. Interne Links werden größtenteils nicht funktionieren. Bitte einmal durchschauen und Links überprüfen / anpassen.
-
-    Die Inhalte sind noch nicht einsortiert. Sie sind womöglich obsolet oder sollten teilweise in anderen Seiten untergebracht werden. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/komplette Überarbeitung.md"
 
 Die 4. Ebene enthält auf der linken Seite Navigationselemente (Pfeiltasten), auf der rechten Seite einen Zahlenblock, der im Wesentlichen der 1. Ebene des Hardware-Zahlenblocks entspricht.
 

docs/Unsortiert/Ebenen.md

@@ -1,9 +1,6 @@
 # Benennung der Ebenen und Modifier
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht überarbeitet worden. Interne Links werden größtenteils nicht funktionieren. Bitte einmal durchschauen und Links überprüfen / anpassen.
-
-    Die Inhalte sind noch nicht einsortiert. Sie sind womöglich obsolet oder sollten teilweise in anderen Seiten untergebracht werden. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/komplette Überarbeitung.md"
 
 Da sich die Nummerierung der Ebenen und Modifier mehrfach geändert hat, ist bei diesem Thema Vorsicht angesagt, wenn man alte Mails oder Dokumentationen vor sich hat.
 

docs/Unsortiert/Grafiken.md

@@ -1,9 +1,6 @@
 # Grafiken der Neo-Tastaturbelegung
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht überarbeitet worden. Bitte einmal durchschauen.
-
-    Die Inhalte sind womöglich obsolet oder sollten teilweise in anderen Seiten untergebracht werden. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/inhaltliche Überarbeitung.md"
 
 ## Aufsteller
 ![Image](https://neo-layout.org/grafik/aufsteller/neo20-aufsteller_600px.png)

docs/Unsortiert/VM.md

@@ -1,9 +1,6 @@
 # Virtuelle Maschinen, Emulationen und RDP-Verbindungen
 
-!!! warning "Zu überarbeiten"
-    Diese Seite ist nach der Portierung noch nicht überarbeitet worden. Interne Links werden größtenteils nicht funktionieren. Bitte einmal durchschauen und Links überprüfen / anpassen.
-
-    Die Inhalte sind noch nicht einsortiert. Sie sind womöglich obsolet oder sollten teilweise in anderen Seiten untergebracht werden. Diskussionen sind zu entfernen oder zu verschieben.
+--8<-- "top/komplette Überarbeitung.md"
 
 Soll Neo in Virtuellen Maschinen (z.B. VirtualBox, Qemu, VMware) oder für Remote-Desktop-Verbindungen verwendet werden, so kommt es oft zu Problemen, da zwei Tastaturbelegungen miteinander konkurrieren. Auf dieser Seite sollen einige Lösungsansätze vorgestellt werden.
 

mkdocs.yml

@@ -28,6 +28,9 @@ markdown_extensions:
   - pymdownx.details         # Einklappbare Admonitions mittels ??? statt !!!
   - pymdownx.superfences     # Verschachtelung von Blöcken, z.B. Code in Listen-Elementen
   - pymdownx.tabbed          # Tabs
+  - pymdownx.snippets:
+      base_path: './snippets'
+      check_paths: True
 
 nav:
   - Startseite: index.md

snippets/Link defekt.md

@@ -0,0 +1 @@
+!!! warning "Link funktioniert nicht mehr"

snippets/Verbesserung.md

@@ -0,0 +1,2 @@
+!!! todo "Verbesserung erwünscht"
+    Dieser Abschnitt enthält Informationen, die unvollständig oder unzureichend beschrieben sind. Hilf mit, ihn zu verbessern.

snippets/fehlender Inhalt.md

@@ -0,0 +1,2 @@
+!!! todo "Fehlender Inhalt"
+    Dieser Abschnitt existiert noch nicht. Hilf mit ihn aufzubauen, indem Du Inhalte einbringst.

snippets/top/fehlerhafte Links.md

@@ -0,0 +1,2 @@
+!!! warning "Fehlerhafte Links"
+    Einige Links zu anderen Dokuseiten funktionieren (noch) nicht und sind auch nicht umgestellt auf die Endung `.md`. Bitte passt die Links an, sobald die entsprechenden Seiten bereitstehen.

snippets/top/inhaltliche Überarbeitung.md

@@ -0,0 +1,2 @@
+!!! warning "Zu überarbeiten"
+    Diese Seite ist nach der Portierung noch nicht inhaltlich überarbeitet worden. Einige / alle Inhalte sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Diskussionen sind zu entfernen oder zu verschieben.

snippets/top/komplette Überarbeitung.md

@@ -0,0 +1,4 @@
+!!! warning "Zu überarbeiten"
+    Diese Seite ist nach der Portierung noch nicht überarbeitet worden. Interne Links werden größtenteils nicht funktionieren. Bitte einmal durchschauen und die Links überprüfen / anpassen.
+
+    Die Inhalte sind noch nicht einsortiert. Sie sind womöglich obsolet oder besser auf anderen Seiten aufgehoben. Diskussionen sind zu entfernen oder zu verschieben.

snippets/top/veraltet.md

@@ -0,0 +1,2 @@
+!!! todo "Zu überarbeiten"
+    Die Informationen auf dieser Seite sind ganz oder teilweise veraltet. Hilf mit, die Inhalte zu sichten und auf den neuesten Stand zu bringen oder entsprechend zu entfernen.