From 3fa533f0f936345d50e74746645753f4ad29e599 Mon Sep 17 00:00:00 2001
From: Steven Barth <steven@midlink.org>
Date: Mon, 14 Apr 2008 10:58:34 +0000
Subject: [PATCH] * Added many descriptions

---
 core/src/ffluci/cbi.lua                               | 11 +++++++++++
 core/src/ffluci/view/footer.htm                       |  2 +-
 .../admin-core/src/model/cbi/admin_network/dhcp.lua   |  9 +++++----
 .../src/model/cbi/admin_network/firewall.lua          |  3 ++-
 .../admin-core/src/model/cbi/admin_network/ifaces.lua |  6 +++++-
 .../admin-core/src/model/cbi/admin_network/portfw.lua |  5 +++--
 module/admin-core/src/model/cbi/admin_network/ptp.lua |  8 +++++---
 .../admin-core/src/model/cbi/admin_network/routes.lua |  4 +++-
 .../admin-core/src/model/cbi/admin_network/vlan.lua   | 11 +++++++++--
 .../src/model/cbi/admin_services/dnsmasq.lua          |  2 +-
 .../src/model/cbi/admin_services/dropbear.lua         |  5 +++--
 .../admin-core/src/model/cbi/admin_services/httpd.lua |  4 ++--
 .../admin-core/src/model/cbi/admin_services/olsrd.lua |  3 ++-
 .../admin-core/src/model/cbi/admin_wifi/devices.lua   |  2 +-
 .../admin-core/src/model/cbi/admin_wifi/networks.lua  | 11 +++++++++--
 module/admin-core/src/view/admin_mesh/index.htm       |  2 --
 module/admin-core/src/view/admin_network/index.htm    |  9 +++++++++
 module/admin-core/src/view/admin_services/index.htm   |  6 ++++++
 module/admin-core/src/view/admin_wifi/index.htm       |  7 +++++++
 themes/fledermaus/contrib/media/cascade.css           |  4 ++++
 20 files changed, 88 insertions(+), 26 deletions(-)
 delete mode 100644 module/admin-core/src/view/admin_mesh/index.htm

diff --git a/core/src/ffluci/cbi.lua b/core/src/ffluci/cbi.lua
index 1ccf2e56d2..7a50189992 100644
--- a/core/src/ffluci/cbi.lua
+++ b/core/src/ffluci/cbi.lua
@@ -98,6 +98,17 @@ function Node.render_children(self, ...)
 end
 
 
+--[[
+A simple template element
+]]--
+Template = class(Node)
+
+function Template.__init__(self, template)
+	Node.__init__(self)
+	self.template = template
+end
+
+
 --[[
 Map - A map describing a configuration file 
 ]]--
diff --git a/core/src/ffluci/view/footer.htm b/core/src/ffluci/view/footer.htm
index 8d48c5fac4..338515129a 100644
--- a/core/src/ffluci/view/footer.htm
+++ b/core/src/ffluci/view/footer.htm
@@ -2,6 +2,6 @@
 	<div class="clear"></div>
 </div></div>
 
-<div class="separator magenta bold">FFLuCI 0.2 - Freifunk Lua Configuration Interface</div>
+<div class="separator magenta bold"><a href="http://luci.freifunk-halle.net">FFLuCI 0.2 - Freifunk Lua Configuration Interface</a></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/module/admin-core/src/model/cbi/admin_network/dhcp.lua b/module/admin-core/src/model/cbi/admin_network/dhcp.lua
index 83ba196418..0c37b89552 100644
--- a/module/admin-core/src/model/cbi/admin_network/dhcp.lua
+++ b/module/admin-core/src/model/cbi/admin_network/dhcp.lua
@@ -2,7 +2,8 @@
 require("ffluci.model.uci")
 require("ffluci.sys")
 
-m = Map("dhcp", "DHCP")
+m = Map("dhcp", "DHCP", [[Mit Hilfe von DHCP können Netzteilnehmer automatisch
+ihre Netzwerkkonfiguration (IP-Adresse, Netzmaske, DNS-Server, DHCP, ...) beziehen.]])
 
 s = m:section(TypedSection, "dhcp")
 s.addremove = true
@@ -15,15 +16,15 @@ for k, v in pairs(ffluci.model.uci.show("network").network) do
 	end
 end
 
-s:option(Value, "start", "Start").rmempty = true
+s:option(Value, "start", "Start", "Erste vergebene Adresse (letztes Oktett)").rmempty = true
 
-s:option(Value, "limit", "Limit").rmempty = true
+s:option(Value, "limit", "Limit", "Letzte vergebene Adresse (letztes Oktett)").rmempty = true
 
 s:option(Flag, "dynamicdhcp", "Dynamisches DHCP").rmempty = true
 
 s:option(Value, "name", "Name").optional = true
 
-s:option(Flag, "ignore", "Schnittstelle ignorieren").optional = true
+s:option(Flag, "ignore", "Schnittstelle ignorieren", "DHCP für dieses Netzwerk deaktivieren").optional = true
 
 s:option(Value, "netmask", "Netzmaske").optional = true
 
diff --git a/module/admin-core/src/model/cbi/admin_network/firewall.lua b/module/admin-core/src/model/cbi/admin_network/firewall.lua
index cf7018e996..c92662667a 100644
--- a/module/admin-core/src/model/cbi/admin_network/firewall.lua
+++ b/module/admin-core/src/model/cbi/admin_network/firewall.lua
@@ -1,5 +1,6 @@
 -- ToDo: Translate, Add descriptions and help texts
-m = Map("luci_fw", "Firewall")
+m = Map("luci_fw", "Firewall", [[Mit Hilfe der Firewall können Zugriffe auf das Netzwerk
+erlaubt, verboten oder umgeleitet werden.]])
 
 s = m:section(TypedSection, "rule")
 s.addremove = true
diff --git a/module/admin-core/src/model/cbi/admin_network/ifaces.lua b/module/admin-core/src/model/cbi/admin_network/ifaces.lua
index 193f83f514..28cf3d8310 100644
--- a/module/admin-core/src/model/cbi/admin_network/ifaces.lua
+++ b/module/admin-core/src/model/cbi/admin_network/ifaces.lua
@@ -1,5 +1,9 @@
 -- ToDo: Translate, Add descriptions and help texts
-m = Map("network", "Schnittstellen")
+m = Map("network", "Schnittstellen", [[An dieser Stelle können die einzelnen Schnittstellen 
+des Netzwerkes konfiguriert werden. Es können mehrere Schnittstellen zu einer Brücke zusammengefasst werden,
+indem diese durch Leerzeichen getrennt aufgezählt werden und ein entsprechender Haken im Feld Netzwerkbrücke
+gesetzt wird. Es können VLANs in der Notation SCHNITTSTELLE.VLANNR (z.B.: eth0.1) oder
+Aliase über die Notation SCHNITTSTELLE:ALIASNR (z.B.: eth0:1) verwendet werden.]])
 
 s = m:section(TypedSection, "interface")
 s.addremove = true
diff --git a/module/admin-core/src/model/cbi/admin_network/portfw.lua b/module/admin-core/src/model/cbi/admin_network/portfw.lua
index 70a174907f..96822b53a2 100644
--- a/module/admin-core/src/model/cbi/admin_network/portfw.lua
+++ b/module/admin-core/src/model/cbi/admin_network/portfw.lua
@@ -1,6 +1,7 @@
 -- ToDo: Translate, Add descriptions and help texts
 require("ffluci.sys")
-m = Map("luci_fw", "Portweiterleitung")
+m = Map("luci_fw", "Portweiterleitung", [[Portweiterleitungen ermöglichen es interne
+Netzwerkdienste von einem anderen externen Netzwerk aus erreichbar zu machen.]])
 
 s = m:section(TypedSection, "portfw")
 s.addremove = true
@@ -15,7 +16,7 @@ end
 proto = s:option(ListValue, "proto", "Protokoll")
 proto:value("tcp", "TCP")
 proto:value("udp", "UDP")
-proto:value("tcpudp", "TCP+UDP")
+proto:value("tcpudp", "TCP + UDP")
 
 dport = s:option(Value, "dport", "Externer Port", "Port[:Endport]")
 
diff --git a/module/admin-core/src/model/cbi/admin_network/ptp.lua b/module/admin-core/src/model/cbi/admin_network/ptp.lua
index 78fcf94b9e..6a627f2687 100644
--- a/module/admin-core/src/model/cbi/admin_network/ptp.lua
+++ b/module/admin-core/src/model/cbi/admin_network/ptp.lua
@@ -1,5 +1,7 @@
 -- ToDo: Translate, Add descriptions and help texts
-m = Map("network", "Punkt-zu-Punkt Verbindungen")
+m = Map("network", "Punkt-zu-Punkt Verbindungen", [[Punkt-zu-Punkt Verbindungen
+über PPPoE oder PPTP werden häufig dazu verwendet, um über DSL o.ä. Techniken eine
+Verbindung zum Internetgateway eines Internetzugangsanbieters aufzubauen.]])
 
 s = m:section(TypedSection, "interface")
 s.addremove = true
@@ -16,9 +18,9 @@ s:option(Value, "ifname", "Schnittstelle")
 s:option(Value, "username", "Benutzername")
 s:option(Value, "password", "Passwort")
 
-s:option(Value, "keepalive", "Keep-Alive").optional = true
+s:option(Value, "keepalive", "Keep-Alive", "Bei einer Verbindungstrennung automatisch neu verbinden").optional = true
 
-s:option(Value, "demand", "Dial on Demand (idle time)").optional = true
+s:option(Value, "demand", "Dial on Demand (idle time)", "Zeit nach der die Verbindung bei Inaktivität getrennt wird").optional = true
 
 srv = s:option(Value, "server", "PPTP-Server")
 srv:depends("proto", "pptp")
diff --git a/module/admin-core/src/model/cbi/admin_network/routes.lua b/module/admin-core/src/model/cbi/admin_network/routes.lua
index 5a5f780070..fb83916781 100644
--- a/module/admin-core/src/model/cbi/admin_network/routes.lua
+++ b/module/admin-core/src/model/cbi/admin_network/routes.lua
@@ -1,5 +1,7 @@
 -- ToDo: Translate, Add descriptions and help texts
-m = Map("network", "Statische Routen")
+m = Map("network", "Statische Routen", [[Statische Routen geben an,
+über welche Schnittstelle und welches Gateway ein bestimmter Host
+oder ein bestimmtes Netzwerk erreicht werden kann.]])
 
 s = m:section(TypedSection, "route")
 s.addremove = true
diff --git a/module/admin-core/src/model/cbi/admin_network/vlan.lua b/module/admin-core/src/model/cbi/admin_network/vlan.lua
index 3186f2d9bb..7b493643b1 100644
--- a/module/admin-core/src/model/cbi/admin_network/vlan.lua
+++ b/module/admin-core/src/model/cbi/admin_network/vlan.lua
@@ -1,7 +1,14 @@
 -- ToDo: Autodetect things, maybe use MultiValue instead, Translate, Add descriptions
-m = Map("network", "VLAN", "Konfguriert den Switch des Routers.")
+m = Map("network", "VLAN", [[Die Netzwerkschnittstellen am Router
+können zu verschienden VLANs zusammengefasst werden, in denen Geräte miteinander direkt
+kommunizieren können. VLANs werden auch häufig dazu genutzt, um Netzwerke voneiander zu trennen.
+So ist oftmals eine Schnittstelle als Uplink zu einem größerem Netz, wie dem Internet vorkonfiguriert
+und die anderen Schnittstellen bilden ein VLAN für das lokale Netzwerk.]])
 
-s = m:section(TypedSection, "switch")
+s = m:section(TypedSection, "switch", nil, [[Die zu einem VLAN gehörenden Schnittstellen
+werden durch Leerzeichen getrennt. Die Schnittstelle mit der höchsten Nummer (meistens 5) bildet
+in der Regel die Verbindung zur internen Netzschnittstelle des Routers. Bei Geräten mit 5 Schnittstellen
+ist in der Regel die Schnittstelle mit der niedrigsten Nummer (0) die standardmäßige Uplinkschnittstelle des Routers.]])
 
 for i = 0, 15 do
 	s:option(Value, "vlan"..i, "vlan"..i).optional = true
diff --git a/module/admin-core/src/model/cbi/admin_services/dnsmasq.lua b/module/admin-core/src/model/cbi/admin_services/dnsmasq.lua
index d6934c891c..86716ff9f3 100644
--- a/module/admin-core/src/model/cbi/admin_services/dnsmasq.lua
+++ b/module/admin-core/src/model/cbi/admin_services/dnsmasq.lua
@@ -1,4 +1,4 @@
-m = Map("dhcp", "Dnsmasq")
+m = Map("dhcp", "Dnsmasq", "Dnsmasq ist ein kombinierter DHCP-Server und DNS-Forwarder für NAT-Firewalls.")
 
 s = m:section(TypedSection, "dnsmasq", "Einstellungen")
 s.anonymous = true
diff --git a/module/admin-core/src/model/cbi/admin_services/dropbear.lua b/module/admin-core/src/model/cbi/admin_services/dropbear.lua
index b8fcb9e6b2..3ecf953356 100644
--- a/module/admin-core/src/model/cbi/admin_services/dropbear.lua
+++ b/module/admin-core/src/model/cbi/admin_services/dropbear.lua
@@ -1,5 +1,6 @@
 -- ToDo: Translate, Add descriptions
-m = Map("dropbear", "SSH-Server")
+m = Map("dropbear", "SSH-Server", [[Der SSH-Server ermöglicht Shell-Zugriff
+über das Netzwerk und bietet einen integrierten SCP-Dienst.]])
 
 s = m:section(TypedSection, "dropbear")
 s.anonymous = true
@@ -7,7 +8,7 @@ s.anonymous = true
 port = s:option(Value, "Port", "Port")
 port.isinteger = true
 
-pwauth = s:option(Flag, "PasswordAuth", "Passwortanmeldung")
+pwauth = s:option(Flag, "PasswordAuth", "Passwortanmeldung", "Erlaube Anmeldung per Passwort")
 pwauth.enabled = 'on'
 pwauth.disabled = 'off'
 
diff --git a/module/admin-core/src/model/cbi/admin_services/httpd.lua b/module/admin-core/src/model/cbi/admin_services/httpd.lua
index f89dbb7aeb..3bd49a2d7d 100644
--- a/module/admin-core/src/model/cbi/admin_services/httpd.lua
+++ b/module/admin-core/src/model/cbi/admin_services/httpd.lua
@@ -1,5 +1,5 @@
 -- ToDo: Translate, Add descriptions
-m = Map("httpd", "HTTP-Server")
+m = Map("httpd", "HTTP-Server", "Der HTTP-Server ist u.a. für die Bereitstellung dieser Obefläche zuständig.")
 
 s = m:section(TypedSection, "httpd")
 s.anonymous = true
@@ -12,7 +12,7 @@ s:option(Value, "home", "Wurzelverzeichnis")
 config = s:option(Value, "c_file", "Konfigurationsdatei", "/etc/httpd.conf wenn leer")
 config.rmempty = true
 
-realm = s:option(Value, "realm", "Anmeldeaufforderung")
+realm = s:option(Value, "realm", "Anmeldeaufforderung", "Aufforderungstext zum Anmelden im Administrationsbereich")
 realm.rmempty = true
 
 return m
\ No newline at end of file
diff --git a/module/admin-core/src/model/cbi/admin_services/olsrd.lua b/module/admin-core/src/model/cbi/admin_services/olsrd.lua
index 430b786874..b223898636 100644
--- a/module/admin-core/src/model/cbi/admin_services/olsrd.lua
+++ b/module/admin-core/src/model/cbi/admin_services/olsrd.lua
@@ -1,7 +1,8 @@
 -- ToDo: Autodetect things, Translate, Add descriptions
 require("ffluci.fs")
 
-m = Map("olsr", "OLSR")
+m = Map("olsr", "OLSR", [[OLSR ist ein flexibles Routingprotokoll, 
+dass den Aufbau von mobilen Ad-Hoc Netzen unterstützt.]])
 
 s = m:section(NamedSection, "general", "olsr", "Allgemeine Einstellungen")
 
diff --git a/module/admin-core/src/model/cbi/admin_wifi/devices.lua b/module/admin-core/src/model/cbi/admin_wifi/devices.lua
index 0b1b9a2ffe..b612dd6766 100644
--- a/module/admin-core/src/model/cbi/admin_wifi/devices.lua
+++ b/module/admin-core/src/model/cbi/admin_wifi/devices.lua
@@ -1,6 +1,6 @@
 -- ToDo: Translate, Add descriptions and help texts
 
-m = Map("wireless", "Geräte")
+m = Map("wireless", "Geräte", [[An dieser Stelle können eingebaute WLAN-Geräte konfiguriert werden.]])
 
 s = m:section(TypedSection, "wifi-device")
 --s.addremove = true
diff --git a/module/admin-core/src/model/cbi/admin_wifi/networks.lua b/module/admin-core/src/model/cbi/admin_wifi/networks.lua
index 20342ffb03..feb2c74714 100644
--- a/module/admin-core/src/model/cbi/admin_wifi/networks.lua
+++ b/module/admin-core/src/model/cbi/admin_wifi/networks.lua
@@ -1,5 +1,8 @@
 -- ToDo: Translate, Add descriptions and help texts
-m = Map("wireless", "Netze")
+m = Map("wireless", "Netze", [[Pro WLAN-Gerät können mehrere Netze bereitgestellt werden.
+Es sollte beachtet werden, dass es hardware- / treiberspezifische Einschränkungen gibt.
+So kann pro WLAN-Gerät in der Regel entweder 1 Ad-Hoc-Zugang ODER bis zu 3 Access-Point und 1 Client-Zugang
+gleichzeitig erstellt werden.]])
 
 s = m:section(TypedSection, "wifi-iface")
 s.addremove = true
@@ -17,7 +20,7 @@ if d then
 	end
 end
 
-network = s:option(ListValue, "network", "Netzwerk")
+network = s:option(ListValue, "network", "Netzwerk", "WLAN-Netz zu Netzwerk hinzufügen")
 network:value("")
 for k, v in pairs(ffluci.model.uci.show("network").network) do
 	if v[".type"] == "interface" and k ~= "loopback" then
@@ -35,6 +38,10 @@ s:option(Value, "bssid", "BSSID").optional = true
 
 s:option(Value, "txpower", "Sendeleistung", "dbm").rmempty = true
 
+s:option(Flag, "frameburst", "Broadcom-Frameburst").optional = true
+s:option(Flag, "bursting", "Atheros-Frameburst").optional = true
+
+
 encr = s:option(ListValue, "encryption", "Verschlüsselung")
 encr:value("none", "keine")
 encr:value("wep", "WEP")
diff --git a/module/admin-core/src/view/admin_mesh/index.htm b/module/admin-core/src/view/admin_mesh/index.htm
deleted file mode 100644
index 75aa026582..0000000000
--- a/module/admin-core/src/view/admin_mesh/index.htm
+++ /dev/null
@@ -1,2 +0,0 @@
-<%+header%>
-<%+footer%>
\ No newline at end of file
diff --git a/module/admin-core/src/view/admin_network/index.htm b/module/admin-core/src/view/admin_network/index.htm
index 75aa026582..7fa4f5565e 100644
--- a/module/admin-core/src/view/admin_network/index.htm
+++ b/module/admin-core/src/view/admin_network/index.htm
@@ -1,2 +1,11 @@
 <%+header%>
+<h1><%:network Netzwerk%></h1>
+<p><%:network1 In diesem Bereich finden sich alle netzwerkbezogenen Einstellungen.%></p>
+<p><%:network2 Der Netzwerkswitch kann bei den meisten Routern frei konfiguriert
+und in mehrere VLANs aufgeteilt werden. %></p>
+<p><%:network3 Schnittstellen und PPPoE/PPTP-Einstellungen ermöglichen
+die freie Organisation des Netzwerks und die Anbindung an ein WAN.%></p>
+<p><%:network4 DHCP ermöglichst die automatische Netzwerkkonfiguration von Rechnern im (W)LAN.%></p>
+<p><%:network5 Portweiterleitung und Firewall erlauben eine effektive Absicherung des Netzes, bei gleichzeitiger
+Bereitstellung von externen Diensten.%></p>
 <%+footer%>
\ No newline at end of file
diff --git a/module/admin-core/src/view/admin_services/index.htm b/module/admin-core/src/view/admin_services/index.htm
index 75aa026582..a06fe10568 100644
--- a/module/admin-core/src/view/admin_services/index.htm
+++ b/module/admin-core/src/view/admin_services/index.htm
@@ -1,2 +1,8 @@
 <%+header%>
+<h1><%:services Dienste%></h1>
+<p><%:services1 Dienste und Dämonen stellen bestimmte Funktionalitäten auf dem Router zur Verfügung.%></p>
+<p><%:services2 Es handelt sich hierbei meist um Netzwerkserver, die verschiedene Aufgaben auf dem Router erfüllen,
+beispielsweise Shell-Zugang ermöglichen oder diese Weboberfläche per HTTP anbieten.%></p>
+<p><%:servcies3 In diesen Bereich fallen auch die Meshnetzwerkdienste wie OLSR und BATMAN, die dabei helfen,
+ein autarkes Ad-Hoc Netzwerk aufzubauen.%></p>
 <%+footer%>
\ No newline at end of file
diff --git a/module/admin-core/src/view/admin_wifi/index.htm b/module/admin-core/src/view/admin_wifi/index.htm
index 75aa026582..6a6059835a 100644
--- a/module/admin-core/src/view/admin_wifi/index.htm
+++ b/module/admin-core/src/view/admin_wifi/index.htm
@@ -1,2 +1,9 @@
 <%+header%>
+<h1><%:wifi Drahtlos%></h1>
+<p><%:wifi1 Hier finden sich Konfiugrationsmöglichkeiten für Drahtlos-Netzwerke nach dem WLAN-Standard.%></p>
+<p><%:wifi2 802.11b/g/a/n-Geräte können so einfach in das bestehende physische Netzwerk integriert werden.
+Die Unterstützung von virtuellen Adaptern ermöglicht auch den Einsatz als Wireless-Repeater oder von
+mehreren Netzwerken gleichzeitig auf einem Gerät.%></p>
+<p><%:wifi3 Es werden Managed, Client, Ad-Hoc und WDS-Modus unterstützt sowie WPA und WPA2-Verschlüsselung zur gesicherten
+Kommunikation.%></p>  
 <%+footer%>
\ No newline at end of file
diff --git a/themes/fledermaus/contrib/media/cascade.css b/themes/fledermaus/contrib/media/cascade.css
index d09ab7477c..bc3c95ecf6 100644
--- a/themes/fledermaus/contrib/media/cascade.css
+++ b/themes/fledermaus/contrib/media/cascade.css
@@ -208,6 +208,10 @@ code {
 	margin: 0%;
 }
 
+.cbi-section-descr {
+	padding-bottom: 1em;
+}
+
 .cbi-value-description {
 	font-style: italic;
 	font-size: 0.8em; 
-- 
2.30.2