Fix READMEs

roles/network-batman/README.md

@@ -10,7 +10,8 @@ Diese Ansible role konfiguriert batman-adv Netzwerk Interfaces.
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
 ...
@@ -35,7 +36,8 @@ meshes:
             mtu: # integer
           ...
 
-´´´
+```
+
 - Host Variable `magic`
 
 ## MAC-Adressen

roles/network-fastd/README.md

@@ -5,13 +5,14 @@ Diese Ansible role konfiguriert Netzwerk Interfaces für die definierten fastd I
 Es wird zwischen node- und intragate-Instanzen unterschieden.
 
 ## Interface-Benamung
-Node-Interfaces: $mesh.id + vpn + '-' + $mesh.fastd.nodes.instances.xx.mtu, z.B. "mzvpn-1312"
-Intragate-Interfaces: $mesh.id + 'ig' + vpn + '-' + $mesh.fastd.intragate.instances.xx.mtu, z.B. "mzigvpn-1312"
+- Node-Interfaces: _$mesh.id_ + vpn + '-' + _$mesh.fastd.nodes.instances.xx.mtu_, z.B. "mzvpn-1312"
+- Intragate-Interfaces: _$mesh.id_ + 'ig' + vpn + '-' + _$mesh.fastd.intragate.instances.xx.mtu_, z.B. "mzigvpn-1312"
 
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
 ...
@@ -29,7 +30,8 @@ meshes:
             mtu: # integer
           ...
 
-´´´
+```
+
 - Host Variable `magic`
 
 ## MAC-Adressen

roles/network-ffrl/README.md

@@ -4,7 +4,8 @@ Diese Ansible role konfiguriert die GRE-Tunnel Interfaces, die für den Internet
 
 ## Benötigte Variablen
 - Dictionary `ffrl_exit_server` (Host Variable)
-´´´
+
+```
 ffrl_exit_server:
   ffrl-a-ak-ber:
     public_ipv4_address: 185.66.195.0
@@ -30,4 +31,4 @@ ffrl_exit_server:
     public_ipv4_address: 185.66.194.1
     tunnel_ipv4_network:
     tunnel_ipv6_network:
-´´´
+```

roles/network-iptables-gateway/README.md

@@ -9,7 +9,8 @@ Diese Ansible role konfiguriert iptables Regeln für IPv4+IPv6 eines Freifunk Ga
 ## Benötigte Variablen
 
 - List `sysctl_settings_netfilter` (Rollen Variable)
-´´´
+
+```
 sysctl_settings_netfilter:
   - name:       # sysctl-Parameter
     value:      # zu setzender Wert
@@ -22,8 +23,8 @@ meshes:
 ...
     ipv4_network:
 ...
+```
 
-´´´
 - Variable `internet_exit_tcp_mss_ipv4`
 - Variable `internet_exit_tcp_mss_ipv6`
 - Host Variable `ffrl_public_ipv4_nat` # Format ip-adresse/prefix

roles/network-meshbridge/README.md

@@ -9,7 +9,8 @@ Diese Ansible role konfiguriert die Linux Bridges für die Freifunk Meshes.
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   -id: xx
 ...
@@ -20,7 +21,8 @@ meshes:
     ipv6_public:
       - 2xxx.../48 # ipv6 public prefix
 
-´´´
+```
+
 - Host Variable `magic`
 
 ## MAC-Adressen

roles/network-routetables/README.md

@@ -5,8 +5,8 @@ Diese Ansible role legt die erforderlichen routing tables an.
 ## Benötigte Variablen
 
 - `routing_tables`
-´´´
+
+```
 routing_tables:
   $name: # integer
-
-´´´
+```

roles/network-routing/README.md

@@ -11,7 +11,8 @@ Diese Ansible role konfiguriert System Einstellung bzgl. IP Routing.
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
 ...
@@ -19,8 +20,10 @@ meshes:
     ipv4_network:
     ipv6_ula:
     ipv6_public:
-´´´
+```
+
 - List `sysctl_settings_gateway` (Rollen-Variable)
+
 ```
 sysctl_settings_routing:
   - name:       # sysctl-Parameter
@@ -28,6 +31,6 @@ sysctl_settings_routing:
 ...
 - Host Variable `ffrl_public_ipv4_nat` # Format ip-adresse/prefix
 - Host Dictionary `ffrl_exit_server
+```
 
-´´´
 - Host Variable `magic`

roles/packages/README.md

@@ -4,6 +4,7 @@ It expects the arguments pkg_repo_list, pkg_pkg_list and pkg_pip_list
 to be filled. If any argument is undefined, the repectibe action will
 be skipped. See below for examples.
 
+```
 pkg_repo_list: # example
   repo_keys:
   - cool_guy:
@@ -30,3 +31,4 @@ pkg_pip_list: # example
 
 # this flag controls the execution of the role; used to subdue if needed
 really_do: True
+```

roles/service-bind-slave/README.md

@@ -13,7 +13,8 @@ Die Gateways agieren lediglich als Slave-DNS Server.
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
 ...
@@ -27,8 +28,9 @@ meshes:
       forward_zones:
         - name: $zone # DNS-Domain
           master: # optional: IP-Adresse des DNS Masters, wenn die vom übergeordneten abweicht.
-      
-´´´
+
+```
+
 - Variable `icvpn_ipv4_transfer_net`
 - Variable `icvpn_ipv6_transfer_net`
 - Host Variable `magic`

roles/service-bird-ffrl/README.md

@@ -9,6 +9,7 @@ Diese Ansible role ergänzt die benötigte bird + bird6 Konfiguration für den I
 
 - Variable `as_public_ffrl` # Public ASN Freifunk Rheinland
 - Dictionary `meshes`
+
 ```
 meshes:
   - id: xx
@@ -16,8 +17,10 @@ meshes:
     ipv6_public:
       - # Public IPv6-Netzwerk
 ```
+
 - Host Dictionary `ffrl_exit_server`
-´´´
+
+```
 ffrl_exit_server:
   ffrl-a-ak-ber:
     public_ipv4_address: 185.66.195.0
@@ -43,8 +46,9 @@ ffrl_exit_server:
     public_ipv4_address: 185.66.194.1
     tunnel_ipv4_network:
     tunnel_ipv6_network:
-´´´
-- Host Variable `ffrl_public_ipv4_nat` # Format ip-adresse/prefix
+```
+
+- Host Variable `ffrl_public_ipv4_nat` (Format ip-adresse/prefix)
 - Host Variable `magic`
 
 ## Benötigte roles

roles/service-bird/README.md

@@ -16,20 +16,23 @@ Im iBGP peeren wir mangels separatem Transfernetz (im Moment) im Mainzer Mesh Ne
 - Variable `bgp_ipv6_transfer_net` # IPv6-Range des Mainzer Meshes, das aktuell als Transfernetz benutzt wird.
 - Variable `bgp_as_private_mwu` # Private ASN von Freifunk MWU
 - Dictionary `bgp_mwu_servers`
+
 ```
   spinat: # kurzer Hostname des Peers
     ipv4: 10.37.0.7 # IPv4-Adresse des Peers
     ipv6: fd37:b4dc:4b1e::a25:7 # IPv6-Adresse des Peers
 ...
+```
+
+- Dictionary `meshes`
 
 ```
-- Dictionary `meshes`
-´´´
 meshes:
   - id: xx
 ...
     ipv4_network:
     ipv6_ula:
       - # IPv6-ULA Network
-´´´
+```
+
 - Host Variable `magic`

roles/service-dhcpd/README.md

@@ -9,7 +9,8 @@ Wir nutzen diesen nur zur Verteilung von IPv4-Adressen.
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
 ...
@@ -20,7 +21,8 @@ meshes:
       - $domain # string
     kea_dnssl_binary: # kea < 1.2 only supports dnssl data in hex format
     iface_mtu: # integer
-´´´
+```
+
 - Host Variable `magic`
 - Host Variable `ipv4_dhcp_range`
 

roles/service-fastd-intragate/README.md

@@ -13,6 +13,7 @@ Diese Ansible role konfiguriert die fastd-Instanz für die Intra-Server Kommunik
 ## Benötigte Variablen
 
 - Dictionary `meshes`
+
 ```
 meshes:
   - id: xx

roles/service-fastd-mesh/README.md

@@ -11,12 +11,13 @@ Diese Ansible role konfiguriert die fastd-Instanz für die Knoten Kommunikation.
 - klont bingener fastd peer repo (im Moment hardcoded)
 
 ## Instanz-Benamung
-Node-Instanzen: $mesh.id + vpn + '-' + $mesh.fastd.nodes.instances.xx.mtu, z.B. "mzvpn-1312"
-Intragate-Instanzen: $mesh.id + 'ig' + vpn + '-' + $mesh.fastd.intragate.instances.xx.mtu, z.B. "mzigvpn-1312"
+- Node-Instanzen: _$mesh.id_ + vpn + '-' + _$mesh.fastd.nodes.instances.xx.mtu_, z.B. "mzvpn-1312"
+- Intragate-Instanzen: _$mesh.id_ + 'ig' + vpn + '-' + _$mesh.fastd.intragate.instances.xx.mtu_, z.B. "mzigvpn-1312"
 
 ## Benötigte Variablen
 
 - Dictionary `meshes`
+
 ```
 meshes:
   - id: xx
@@ -33,6 +34,7 @@ meshes:
             pass: # String - Pfad des fastd secrets im Admin Pass
           ...
 ```
+
 - Liste `legacy_gateways`
 
 ## fastd Secrets

roles/service-nginx-firmware/README.md

@@ -11,7 +11,8 @@ Diese Ansible role konfiguriert die Firmware Synchronisation und die erforderlic
 - Variable `http_domain_external` # string: Externe Freifunk MWU Domain
 - Variable `http_domain_internal` # string: Interne Freifunk MWU Domain
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
 ...
@@ -19,4 +20,4 @@ meshes:
 ...
     http_domain_external: # string: Externe Mesh Domain
     http_domain_internal: # string: Interne Mesh Domain
-´´´
+```

roles/service-radvd/README.md

@@ -9,7 +9,8 @@ Diese Ansible role installiert und konfiguriert den radvd daemon.
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
 ...
@@ -18,5 +19,6 @@ meshes:
     ipv6_public:
       - # Public-Prefix - String
     iface_mtu: # Integer
-´´´
+```
+
 - Host Variable `magic`

roles/service-respondd/README.md

@@ -9,8 +9,9 @@ Pro Mesh Netzwerk muss eine `mesh-announce`-Instanz laufen.
 ## Benötigte Variablen
 
 - Dictionary `meshes`
-´´´
+
+```
 meshes:
   - id: xx
     site_code: # string
-´´´
+```

roles/service-tinc/README.md

@@ -13,6 +13,7 @@ Diese Ansible role installiert und konfiguriert den tinc daemon, der für die Ve
 ## Benötigte Variablen
 
 - Dictionary `icvpn`
+
 ```
 icvpn:
   prefix: mwu
@@ -22,6 +23,7 @@ icvpn:
 - Variable `icvpn_ipv4_transfer_net`
 - Variable `icvpn_ipv6_transfer_net`
 - Dictionary `routing_tables`
+
 ```
 routing_tables:
   icvpn: 23

roles/system-sysctl-gateway/README.md

@@ -3,10 +3,10 @@ Diese Ansible role setzt Freifunk Gateway spezifische sysctl-Parameter.
 
 ## Benötigte Variablen
 - List `sysctl_settings_gateway` (Rollen-Variable)
+
 ```
 sysctl_settings_gateway:
   - name:	# sysctl-Parameter
     value:      # zu setzender Wert
 ...
-
-´´´
+```