Erstellen neuer Seiten: Unterschied zwischen den Versionen

Aus Baustatik-Wiki
Zur Navigation springen Zur Suche springen
 
(71 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
[[File:schreiben.jpg|mini]]
 +
Hier kannst Du nachlesen, wie neue Seiten im Baustatik-Mediawiki nach einem einheitlichen Format erstellt werden. Außerdem werden einige Regeln erläutert, die bei der Erstellung von Seiten zu beachten sind.
 +
 +
Um einen '''neuen Beitrag''' am einfachsten zu '''erstellen''', musst du den Titel des Beitrages zunächst über das Suchfeld von Baustatik-Wiki suchen. Wenn der Beitrag noch nicht im Wiki vorhanden ist, wird dir der Titel in Rot angezeigt. Durch anklicken wird dann eine neue Seite mit dem Titel erstellt, die du speichern kannst.
 +
Danach kannst du dir aus der [[Vorlage für neue Beiträge|'''"Vorlage für neue Beiträge"''']] im Bearbeitungsmodus den Quellcode kopieren und durch deine Texte und Bilder austauschen.<br />
 +
<br />
 +
 +
<!--
 
= Was ist Wo im Baustatik-MediaWiki? =
 
= Was ist Wo im Baustatik-MediaWiki? =
 
==Übersicht==
 
==Übersicht==
Zeile 13: Zeile 21:
  
 
==Grundlagen/Begriffe==
 
==Grundlagen/Begriffe==
Seiten, die in den Kategorien [Grundlagen/Begriffe] eingeordnet werden, enthalten Begriffserklärungen, Hinweise zu Berechnungsverfahren, Herleitungen oder theoretische Hintergrundinformationen. Die Informationen sollen allgemein gehalten sein und sich nicht auf die Verwendung bestimmter Statik-Software beziehen.
+
Seiten, die in den Kategorien - ''Grundlagen/Begriffe'' - eingeordnet werden, enthalten Begriffserklärungen, Hinweise zu Berechnungsverfahren, Herleitungen oder theoretische Hintergrundinformationen. Die Informationen sollen allgemein gehalten sein und sich nicht auf die Verwendung bestimmter Statik-Software beziehen. Sie müssen sich auch erschließen lassen, ohne dass man mit Hinweisen zur Software-Anwendung konfrontiert ist.
  
 
==mb AEC Module==
 
==mb AEC Module==
Seiten, die in den Kategorien -mb AEC Module- eingeordnet werden, enthalten Informationen zur Eingabe, zu konkreten Berechnungsverfahren sowie zur Interpretation der Berechnungsergebnisse ausgewählter Module der mb AEC Baustatik-Software. Hierzu zählen auch evtl. Missverständlichkeiten, Unstimmigkeiten in Berechnungen oder Bezeichnungen, Anwendungsgrenzen usw. - alles was dem Leser helfen kann, Fehler bei der Anwendung der Software bei seiner konkreten statischen Berechnung zu vermeiden.
+
Seiten, die in den Kategorien - ''mb AEC Module'' - eingeordnet werden, enthalten Informationen zur Eingabe, zu konkreten Berechnungsverfahren sowie zur Interpretation der Berechnungsergebnisse ausgewählter Module der mb AEC Baustatik-Software. Hierzu zählen auch evtl. Missverständlichkeiten, Unstimmigkeiten in Berechnungen oder Bezeichnungen, Anwendungsgrenzen usw. - alles was dem Leser helfen kann, Fehler bei der Anwendung der Software bei seiner konkreten statischen Berechnung zu vermeiden.
 +
<br /><br />
 +
Für ein besseres Verständnis von Eingaben ist man oft geneigt auch ergänzende Erläuterungen zu theoretischen Hintergründen bzw. Berechnungsgrundlagen einzufügen. Dies sollte hier jedoch unbedingt vermieden werden! Stattdessen sollte auf entsprechende Seiten in - ''Grundlagen/Begriffe -'' verwiesen werden.
  
 
==Beispiele==
 
==Beispiele==
Wie jeder weiß, sind Beispielberechnungen bestens geeignet, um die Anwendung von Berechnungsverfahren oder theoretische Zusammenhänge an konkreten Zahlen zu veranschaulichen. Derartige Beispielberechnungen sollen auf den Seiten in den Kategorien [Beispiele] untergebracht werden. Insbesondere sind hier auch Vergleichsbetrachtungen zwischen eigenen Berechnungen (möglichst nachvollziehbar) und den Berechnungsergebnissen der mb AEC Module von Interesse (Plausibilitätsbetrachtungen).
+
Wie jeder weiß, sind Beispielberechnungen bestens geeignet, um die Anwendung von Berechnungsverfahren oder theoretische Zusammenhänge an konkreten Zahlen zu veranschaulichen. Derartige Beispielberechnungen sollen auf den Seiten in den Kategorien - ''Beispiele'' - untergebracht werden. Insbesondere sind hier auch Vergleichsbetrachtungen zwischen eigenen Berechnungen (möglichst nachvollziehbar) und den Berechnungsergebnissen der mb AEC Module von Interesse (Plausibilitätsbetrachtungen).
 
+
-->
=Erstellen einer Seite in -Grundlagen/Begriffe-=
+
=Erstellen einer Seite in - ''Grundlagen/Begriffe'' -=
 
==Bezeichnung von Seiten==
 
==Bezeichnung von Seiten==
Da Seiten im Bereich -Grundlagen/Begriffe- unterschiedliche Informationen enthalten können, gibt es hier auch unterschiedliche Möglichkeiten der Seitenbezeichnung:
+
Da Seiten im Bereich - ''Grundlagen/Begriffe'' - unterschiedliche Informationen enthalten können, gibt es hier auch unterschiedliche Möglichkeiten der Seitenbezeichnung:
  
 
* Begriffe
 
* Begriffe
Zeile 39: Zeile 49:
 
:: Beispiel 1: [[Durchstanzen - Bemessungswert der einwirkenden Querkraft]]
 
:: Beispiel 1: [[Durchstanzen - Bemessungswert der einwirkenden Querkraft]]
 
:: Beispiel 2: [[Deckengleicher Unterzug - Lasteinzugsfläche]]
 
:: Beispiel 2: [[Deckengleicher Unterzug - Lasteinzugsfläche]]
 +
 +
Grundsätzlich sind für die Bezeichnung von Seiten nur Sachbegriffe zu wählen, da die Seiten in der Kategorie-Übersicht alphabetisch geordnet werden.
 +
::Beispiel: '''Mitwirkende Plattenbreite''' (RICHTIG)  - '''Ermittlung der mitwirkenden Plattenbreite''' (FALSCH)
  
 
==Struktur von Seiten==
 
==Struktur von Seiten==
Eine Seite in den Kategorien -Grundlagen/Begriffe- hat grundsätzlich folgende Struktur:
+
Eine Seite in den Kategorien - ''Grundlagen/Begriffe'' - hat grundsätzlich folgende Struktur:
* Lesernavigation
+
 
:Lesernavigationen gibt es mit unterschiedlichen Anzahlen von Links (2 - 6) (z. B. [[Vorlage:Lesernavigation 2 Links|Lesernavigation 2 Links]]). Hier kann je nach Anzahl der benötigten Links die entsprechende Vorlage ausgewählt werden. Die Links sind ggf. zu aktualisieren.
+
*Seiten-Vorschau
 +
:Wenn man mit der Maus über den Link zu einer Seite fährt, kann eine kurze Seitenvorschau (bestenfalls Kurztext mit einer Abbildung) angezeigt werden. Das klappt aber nur, wenn Kurztext und Abbildung vor der Gliederung angeordnet werden. Der Link auf die Abbildung steht ganz oben (als Vorlage siehe z. B. [[Expositionsklassen]]).<br>
 +
:Kurztext und Abbildung sollten so aufgebaut sein, dass Sie eine gute Übersicht über den zu erwartenden Seiteninhalt geben.
  
 
*Seiteninhalt
 
*Seiteninhalt
Zeile 74: Zeile 89:
 
*vollständiger Titel der Seite auf der die Datei (erstmalig) verwendet wird + laufende Nummerierung
 
*vollständiger Titel der Seite auf der die Datei (erstmalig) verwendet wird + laufende Nummerierung
 
*Beispiel: Betondeckung2.png (siehe Beispiel-Abbildung)
 
*Beispiel: Betondeckung2.png (siehe Beispiel-Abbildung)
 +
 +
{{Achtung |1 = |2 = Die Dateinamen von Grafikdateien dürfen keine Umlaute enthalten. Sonst gibt es Zuordnungsprobleme.}}
  
 
===Formeln und Bezeichnungen===
 
===Formeln und Bezeichnungen===
  
Für Formeln gelten ähnliche Regeln wie für grafische Darstellungen. Der Bezug zum Text wird durch die räumliche Nähe hergestellt (keine Nummerierung der Formel). Jede Formel sollte hinsichtlich Ihrer Bestandteile vollständig erklärt werden. Auch wenn eine ähnliche Formulierung auf der gleichen oder einer anderen Seite zu finden ist, muss davon ausgegangen werden, dass der Leser auf unterschiedlichem Wege zum betreffenden Abschnitt gelangt ist und daher eine vollständige Beschreibung des Formelinhalts zu schätzen weiß.
+
Für Formeln gelten ähnliche Regeln wie für grafische Darstellungen. Der Bezug zum Text wird durch die räumliche Nähe hergestellt (keine Nummerierung der Formel). Jede Formel sollte hinsichtlich Ihrer Bestandteile vollständig erklärt werden. Auch wenn eine ähnliche Formulierung auf der gleichen oder einer anderen Seite zu finden ist, muss davon ausgegangen werden, dass der Leser auf unterschiedlichem Wege zum betreffenden Abschnitt gelangt ist und daher eine vollständige Beschreibung des Formelinhalts zu schätzen weiß.<br />
 +
<br />
 +
Beispiel:
 
<br /><br />
 
<br /><br />
 +
:<math>\begin{align}c_\mathrm{nom}=c_\mathrm{min} + {\Delta}c_\mathrm{dev}\end{align}</math><br />
 +
<br/>
 +
wobei:
 +
:{|
 +
|-
 +
| c<sub>min</sub>... || Mindestbetondeckung
 +
|-
 +
| ∆c<sub>dev</sub>... || Vorhaltemaß
 +
|}<br />
 +
<br />
 
Bezüglich der Verwendung von Formeln und Berechnungen in Beispielen gelten andere Regeln.
 
Bezüglich der Verwendung von Formeln und Berechnungen in Beispielen gelten andere Regeln.
 
<br /><br />
 
<br /><br />
 
Die Erstellung von Formeln erfolgt mithilfe der LaTeX-Codierung (siehe - [[Formeln]]).
 
Die Erstellung von Formeln erfolgt mithilfe der LaTeX-Codierung (siehe - [[Formeln]]).
  
=Erstellen einer Seite in -mb AEC Module-=
+
==Beispiel-Seiten==
 +
 
 +
Nachfolgend sind einige Seiten angegeben, die hinsichtlich Ihrer Struktur und der Formatierung den zuvor beschriebenen Regeln entsprechen:
 +
* [[Betondeckung]]
 +
* [[Schwimmende Konstruktionen]]
 +
* ...
 +
 
 +
=Erstellen einer Seite in - ''Software-Anwendungen'' -=
 
==Bezeichnung und Strukturierung von Seiten==
 
==Bezeichnung und Strukturierung von Seiten==
Die Bezeichnung und Strukturierung von Seiten in dem Bereich -mb AEC Module- folgt prinzipiell der Bezeichnung und Strukturierung der betreffenden mb AEC Module selbst. Die Hauptseite des betreffenden Moduls erhält damit als Seitentitel die Bezeichnung des zugehörigen Moduls (Modul-Nr. + Bezeichnung)
+
===Hauptseiten===
:: Beispiel: [[S200.de Einachsig gespannte Mehrfeldplatte]]
+
Die Bezeichnung und Strukturierung von Seiten in dem Bereich - ''Software-Anwendungen'' - folgt prinzipiell der Bezeichnung und Strukturierung der betreffenden Software-Anwendungen selbst (z. B. Baustatik-Module der mb Worksuite). Die Hauptseite des betreffenden Moduls erhält damit als Seitentitel die Bezeichnung des zugehörigen Moduls (Modul-Nr. + Bezeichnung)
 +
:: Beispiel für ein Baustatik-Modul der mb Worksuite: [[S200.de Einachsig gespannte Mehrfeldplatte]]
  
 
Die Hauptseiten haben in der oberen Gliederungsebene immer die gleiche Struktur:
 
Die Hauptseiten haben in der oberen Gliederungsebene immer die gleiche Struktur:
 
* Eingabe → verweist auf Seiten mit Hinweisen zur Eingabe von Informationen für die Berechnung
 
* Eingabe → verweist auf Seiten mit Hinweisen zur Eingabe von Informationen für die Berechnung
* Grundlagen → verweist auf maßgebende Berechnungsgrundlagen (Seiten in -Grundlagen/Begriffe-)
+
* Grundlagen → verweist auf maßgebende Berechnungsgrundlagen (Seiten in - ''Grundlagen/Begriffe'' -)
* Beispiele → verweist auf Seiten mit zugehörigen Beispielberechnungen (Seiten in -Beispiele-)
+
* Beispiele → verweist auf Seiten mit zugehörigen Beispielberechnungen (Seiten in - ''Beispiele'' -)
 +
* Kategorie
 +
:Je nach betrachteter Bauweise ist die Seite in eine passende Kategorie einzuordnen. Für die Strukturierung der Liste auf der Kategorie-Seite kann der Kategorie-Angabe noch die Nr. des mb AEC Moduls hinzugefügt werden.
 +
:: Beispiel 1: <code><nowiki>[[Kategorie:MB-AEC Baustatik-Module Stahlbetonbau|200]]</nowiki></code>
 +
:: Beispiel 2: <code><nowiki>[[Kategorie:MB-AEC Baustatik-Module Stahlbau|404]]</nowiki></code>
  
 
Alle folgenden Erläuterungen beziehen sich nur noch auf Seiten in der Ebene [Eingabe].
 
Alle folgenden Erläuterungen beziehen sich nur noch auf Seiten in der Ebene [Eingabe].
Für die Bezeichnung von Seiten in -Grundlagen/Begriffe- → siehe [[#Erstellen einer Seite in -Grundlagen/Begriffe-|Erstellen einer Seite in -Grundlagen/Begriffe-]]
+
<br />
Für die Bezeichnung von Seiten in -Beispiele- → siehe ...
+
{|
 +
|-
 +
| Für die Bezeichnung von Seiten in - ''Grundlagen/Begriffe'' - || → siehe [[#Bezeichnung von Seiten|Bezeichnung von Seiten in - ''Grundlagen/Begriffe'' -]]
 +
|-
 +
| Für die Bezeichnung von Seiten in - ''Beispiele'' - || → siehe ...
 +
|}<br />
 +
 
 +
===Seiten zu Eingabekategorien===
  
 
Der Eingabebereich eines jeden mb AEC Moduls gliedert sich in Eingaberegister (Reiter) und Eingabekategorien (Unterpunkte im jeweiligen Eingaberegister).
 
Der Eingabebereich eines jeden mb AEC Moduls gliedert sich in Eingaberegister (Reiter) und Eingabekategorien (Unterpunkte im jeweiligen Eingaberegister).
Für Hinweise zur Eingabe wird für jede Eingabekategorie eine neue Seite angelegt. Sie erhält folgende Bezeichnung - Benennung der Eingabekategorie + Modul-Nr. (...des mb AEC Moduls). Einige Standard-Eingabekategorien werden in mehreren mb AEC Modulen benutzt. Die Modul-Nr. wird dann durch 3 Sterne ersetzt.
+
Für Hinweise zur Eingabe wird für jede Eingabekategorie eine neue Seite angelegt. Sie erhält folgende Bezeichnung: Benennung der Eingabekategorie + Modul-Nr. (...des mb AEC Moduls). Einige Standard-Eingabekategorien werden mit gleichem oder ähnlichem Aufbau in mehreren mb AEC Modulen benutzt. Die Modul-Nr. wird dann durch 3 Sterne ersetzt.
 
:: Beispiel 1 (für eine modulindividuelle Eingabekategorie): [[Zusatzangaben Plattenbalken (S340.de)]]
 
:: Beispiel 1 (für eine modulindividuelle Eingabekategorie): [[Zusatzangaben Plattenbalken (S340.de)]]
 
:: Beispiel 2 (für eine modulübergreifende Eingabekategorie): [[Werkstoff (S***.de)]]
 
:: Beispiel 2 (für eine modulübergreifende Eingabekategorie): [[Werkstoff (S***.de)]]
  
== MB-AEC Baustatik-Module ==
+
Die Seiten im Bereich - ''mb AEC Module'' - haben in der Regel folgenden einheitliche Aufbau:
Hier werden die einzelnen Baustatik-Module alphabetisch aufgelistet, in ihrer Handhabung erläutert und mit den geltenden Normen verglichen.<br />
+
* Eingabe
==== Erstellen eines MB-AEC Baustatik-Moduls ====
+
* Hinweise
#Im Suchfeld den gewünschten Namen des Moduls eintragen.
+
* Quellenangaben
#*hier gilt: Modulnummer + Modulname (z.B. S340.de Stahlbeton Durchlaufträger)
+
* Seiteninfo
#Im Suchergebniss die rot markierte Seite erstellen.
+
:Das Feld [Seiteninfo] gibt eine Übersicht über den Bearbeitungsstand der Seite und eine Bewertung der Informationsqualität (siehe auch [[Qualitätssicherung]]). Im Unterschied zu den Seiten in - Grundlagen/Begriffe - ist hier für die Seiteninfo die Vorlage [[Vorlage:Seiteninfo(mb)|Seiteninfo(mb)]] zu benutzen. Diese enthält zusätzlich noch die Modul-Versions-Nr., auf die sich die Informationen beziehen.
#*blau markierte Seiten existieren bereits!
+
 
#Die '''[[Vorlage:MB-AEC Baustatik-Modul]]''' einfügen.
+
==einheitlicher Aufbau von Seiten==
#*Quelltext der Vorlage über den Schalter <span style="border: 1px outset #000;">Bearbeiten</span> öffnen und kopieren.
+
===Eingabe===
<!-- #000 ist der Farbcode Schwarz -->
 
#*Quelltext der Vorlage in der neuen Seite einfügen.
 
#Im '''Quelltext''' die Zeile (unterste Zeile) <code><nowiki>[[Kategorie:MB-AEC Baustatik-Module ...|Nur die Ziffern der Nummer]]</nowiki></code> bearbeiten.
 
#*Thema zuordnen: Stahlbetonbau, Stahlbau, Holzbau und/oder Mauerwerksbau
 
#*Nummer zuordnen: hier bitte nur die drei Ziffern der Modulnummer eintragen.
 
#*z.B. <code><nowiki>[[Kategorie:MB-AEC Baustatik-Module Stahlbetonbau|340]]</nowiki></code>
 
#Seite Speichern!
 
#*Die gespeicherte Seite wird nun geöffnet.
 
#*Die Seite ist jetzt in der gewählten Kategorie unter dem angegebenen Namen zu finden.
 
#Seite weiter bearbeiten.  
 
#*Modulnummer und -Name im Text bearbeiten
 
#*Die Eingabeparameter dem neuen Modul anpassen
 
#Die Seite ist fertig!
 
#*Die einzelnen Modulseiten können hier erstellt werden.
 
  
==== Erstellen einer MB-AEC Baustatik-Modul-Seite ====
+
Den Informationen zur Eingabe sollte eine grafische Darstellung des Eingabebereiches vorangestellt werden. Im Unterschied zu den grafischen Darstellungen in den Seiten des Bereiches - ''Grundlagen/Begriffe'' - werden die Darstellungen in den hier betreffenden Seiten einfach linksbündig ohne Rahmen und Bezeichnung angeordnet.
#das gewünschte Modul öffnen, in Welchem die Seite aufgelistet werden soll.
+
<br />
#*(z.B. S340.de Stahlbeton Durchlaufträger)
 
#Quelltext des Moduls über den Schalter <span style="border: 1px outset #000;">Bearbeiten</span> öffnen und unter dem zugeordneten Eingabeparameter die neue Seite anlegen.
 
#*wurde beim anlegen des Moduls die vorgeschriebene Vorlage verwendet, existieren bereits rot markierte Seiten.
 
#*<code><nowiki>[[Seitenname (Modulnummer)|Seitenname]]</nowiki></code>
 
#*hier gilt: Modulname + Modulnummer
 
#*z.B. <code><nowiki>[[Positionstyp (S340.de)|Positionstyp]]</nowiki></code> für Modulseiten
 
#*z.B. <code><nowiki>[[Positionstyp (SXXX.de)|Positionstyp]]</nowiki></code> für Modulübergreifende Seiten
 
#Quelltext speichern!
 
#*Die Modulseite öffnet sich
 
#*Der neu angelegte Seitenname wird nun -rot markiert- an der gewünschten Stelle angezeigt.
 
#Die rot markierte Seite öffnen
 
#Die '''[[Vorlage:Modulseite]]''' einfügen.
 
#*Quelltext der Vorlage öffnen und kopieren.
 
#*Quelltext der Vorlage in der neuen Seite einfügen.
 
#Die Seite kann nun nach belieben verändert werden.
 
  
=== Grundlagen/Begriffe ===
+
Beispiel:
Hier werden allgemeine Grundlagen und Begriffe zum Thema Stahlbeton und Spannbeton erläutert
+
<br /><br />
=== Beispiele ===
+
:[[File:Werkstoff_1.jpg‎‎|rahmenlos|rand|tumb|500px|Baustatik-Wiki]]<br />
Hier werden alle Beispiele (Handrechnungen, Berechnung mit Baustatik-Modulen,...) alphabetisch aufgelistet. Es können mehrere Beispiele (zu '''einem''' Themengebiet) auf einer Seite vorhanden sein.<br />
+
<br /><br />
Zu jedem Beispiel muss in der Beschreibung eine Zugehörigkeit beschrieben werden.<br />
 
mögliche Beschreibung:
 
* Beispiel einer manuellen Handrechnung
 
* Beispiel einer Berechnung von mb-Baustatik
 
* Beispiel einer manuellen Handrechnung verglichen mit einer Berechnung von mb-Baustatik
 
* Beispiel einer Berechnung von mb-Baustatik verglichen mit einer manuellen Handrechnung
 
  
== Namensgebung der Seiten ==
+
Manche Eingabebereiche sind dynamisch aufgebaut, d. h. sie verändern ihre Gestalt und ihre Eingabeoptionen z. B. je nachdem welches Verfahren ausgewählt wurde oder welche Option angewählt wurde. Die Darstellung des Eingabebereiches sollte hier möglichst vollständig erfolgen, so dass alle Eingabemöglichkeiten erklärt werden können. Das kann u. U. mehrfache Darstellungen eines Eingabebereiches erfordern. Ggf. sind auch erklärende Bildunterschriften sinnvoll.
Für die Bezeichnung der einzelnen Seiten gibt es in den verschiedenen Kategorien Vorschriften, um Verwechselungen bzw. fehlerhaften Gliederung vorzubeugen.<br />
 
 
<br />
 
<br />
Titel der MB-AEC Baustatik-Module:
+
Alternativ können unterschiedliche Eingabemöglichkeiten sehr gut durch eine Gliederung der betreffenden Seite erläutert werden.
:* Vollständige Titelbezeichnung nach den Angaben des Herstellers.
+
Es ist grundsätzlich sinnvoll die Eingabe möglichst vollständig zu erklären. Dabei sind kurze, kompakte, übersichtlich strukturierte Informationen zu bevorzugen. Diese können und sollten ggf. durch Hinweise zu Normen/Richtlinien usw. oder auch Hinweise zu Anwendungsgrenzen ergänzt werden.
::Bsp.: '''S340.de Stahlbeton-Durchlaufträger'''
+
 
<br />
+
===Hinweise===
Titel innerhalb der MB-AEC Baustatik-Module:
+
 
:* Name des Eingabefeldes und die Nummer des Moduls in Klammern ()
+
Für die Nutzung der hier beschriebenen Seiten macht es keinen Sinn, nur Informationen zu bringen, die im Wesentlichen schon in der Anwendungshilfe der Baustatik-Module enthalten sind. Vielmehr von Bedeutung sind Hinweise, die über die in der Hilfe angegebenen Standardinformationen hinausgehen. Dies betrifft beispielsweise:
::Bsp.: '''Mitwirkende Plattenbreite (S340.de)'''
+
* Hinweise zur Verwendung (oder Nichtverwendung) der Eingabeparameter in der Berechnung
<br />
+
* Hinweise zur Erlangung einer benötigten Information, sofern diese nicht offensichtlich verfügbar ist und z. B. erst durch eine anderweitige Berechnung ermittelt werden muss
Titel der Grundlagen/Begriffe:
+
* Hinweise zur Ableitung einer Information aus dem statischen System oder anderweitigen Randbedingungen
:* Nur Sachwörter verwenden! Die Seiten werden alphabetisch geordnet, und können so übersichtlicher aufgelistet werden.
+
* Hinweise zu Grenzwerten bestimmter Eingabeparameter (mit Begründung)
::Bsp.: '''Mitwirkende Plattenbreite''' (RICHTIG)   - '''Ermittlung der mitwirkenden Plattenbreite''' (FALSCH)
+
* Hinweise zu Kontrollmöglichkeiten bestimmter Eingabewerte
<br />
+
* ...
Titel der Beispiele:
+
 
:* Name des Beispiels (Nur Sachwörter verwenden! Die Seiten werden alphabetisch geordnet, und können so übersichtlicher aufgelistet werden.) und Bsp. in Klammern ()  
+
==Beispiel-Seiten==
::Bsp.: '''Mitwirkende Plattenbreite (Bsp.)'''
+
 
 +
Nachfolgend sind einige Seiten angegeben, die hinsichtlich Ihrer Struktur und der Formatierung den zuvor beschriebenen Regeln entsprechen:
 +
* [[Effektive Stützweiten (S***.de)]] (für eine modulübergreifende Eingabekategorie)
 +
* [[Deckenstützweiten (S220.de)]] (für eine modulindividuelle Eingabekategorie)
 +
* ...
 +
 
 +
=Erstellen einer Seite in - ''Beispiele'' -=
 +
==Bezeichnung von Seiten==
 +
 
 +
Die Bezeichnung von Seiten im Bereich - ''Beispiele'' - erfolgt nach folgendem Schema:
 +
* Einzelthema + (Bsp.) - für ein Einzelthema
 +
:: Beispiel 1: [[Betondeckung (Bsp.)]]
 +
* Oberbegriff/Themenkomplex - Teilthema + (Bsp.)
 +
:: Beispiel 2: [[Zwang - Mindestbewehrung zur Rissbreitenbegrenzung für eine Sohlplatte (Bsp.)]]
 +
 
 +
==Struktur von Seiten==
 +
 
 +
Die Seiten sollten mindestens folgende Abschnitte bzw. Elemente aufweisen:
 +
 
 +
* Aufgabenstellung
 +
: Die Aufgabenstellung muss alle Informationen beinhalten, die für die Erfassung der Ausgangssituation und die weitere Berechnung benötigt werden (z. B. Bauteilgeometrie, Baustoffkennwerte, Einwirkungen/Schnittgrößen, statische Randbedingungen usw.). Darüber hinaus ist das konkrete Ziel der Beispielberechnung zu beschreiben. Die Aufgabenstellung sollte immer auch eine oder mehrere grafische Darstellungen des betrachteten Bauteils, des Bauteilausschnitts oder des Tragsystems enthalten.
 +
 
 +
* Lösung
 +
Die Lösung beinhaltet je nach Ermessen des Autors alle Berechnungsschritte, Annahmen und Informationen, die für ein vollständiges Nachvollziehen des Berechnungsablaufes erforderlich sind.  
 +
 
 +
*Quellenangaben (falls auf Quellen verwiesen wird)
 +
:Zusammenfassung der verwendeten Quellen (siehe auch - [[Quellenverweise]])
 +
 
 +
*Seiteninfo
 +
:Das Feld [Seiteninfo] gibt eine Übersicht über den Bearbeitungsstand der Seite und eine Bewertung der Informationsqualität (siehe auch [[Qualitätssicherung]]). Für die Seiteninfo ist die Vorlage [[Vorlage:Seiteninfo|Seiteninfo]] zu benutzen.
 +
 
 +
==Hinweise für eine gute Gestaltung von Seiten==
 +
 
 +
* Bemühen Sie sich um eine übersichtliche Struktur der Seite (Leerzeilen, Einrückungen, Markierungen)! Um so besser und schneller lassen sich Detailinformationen aus der Berechnung entnehmen.
 +
 
 +
* Versehen Sie die einzelnen Berechnungsschritte mit entsprechenden erläuternden Bemerkungen (z.B. Erklärungen, Annahmen oder Herkunft von Eingangsgrößen usw.)!
 +
 
 +
* Vermeiden Sie sich häufig wiederholende gleichartige Berechnungen ohne jeden informativen Mehrwert! Dadurch wird das Berechnungsbeispiel unübersichtlich. Hier reicht (für den Fall, dass man auf derartige Ergebnisse Bezug nehmen muss oder möchte) eine einfache Angabe des Berechnungsergebnisses (ggf. mit Verweis auf das angewendete Verfahren). Bei einer größeren Anzahl gleichartiger Berechnungsergebnisse bietet eine tabellarische Darstellung eine gute Übersicht.
 +
 
 +
* Verwenden Sie ggf. grafische Darstellungen, um die Definition bestimmter Größen deutlich zu machen (z. B. Abmessungen)! Auch grafische Darstellungen von Ablesungen in Tabellen oder Diagrammen (günstigerweise mit Hervorhebung der Ablesung) verbessern die Nachvollziehbarkeit Ihrer Berechnung erheblich.
 +
 
 +
==Beispiel-Seiten==
 +
 
 +
Nachfolgend sind einige Seiten angegeben, die hinsichtlich Ihrer Struktur und der Formatierung den zuvor beschriebenen Regeln und Hinweisen entsprechen:
 +
* [[Betondeckung (Bsp.)]] für ein einfaches Berechnungsbeispiel
 +
* [[Zwang - Mindestbewehrung zur Rissbreitenbegrenzung für eine Wand (Bsp.)]] für ein ausführlicheres Berechnungsbeispiel
 +
* ...<br />
 
<br />
 
<br />
==Regeln für die Aufteilung von Inhalten im Baustatik-MediaWiki==
 
Bei der Aufteilung von Inhalten im Baustatik-MediaWiki gelten folgende Regeln:
 
*Seiten mit theoretischen Aspekten sind getrennt anzulegen von Seiten, die Hinweise zur Anwendung der MB-AEC Baustatik-Module beinhalten. Es gilt der '''GRUNDSATZ''': Theoretische Zusammenhänge müssen sich vollständig erschließen lassen, ohne dass man mit Hinweisen zu Software-Anwendung konfrontiert ist!
 
*Theoretische Aspekte sind in die Kategorie '''GRUNDLAGEN/BEGRIFFE''' einzuordnen und bezeichnen alle Informationen, die - ohne einen Zusammenhang zur Programmanwendung herstellen zu müssen - in sich verständlich sind.
 
  
 
{{Seiteninfo
 
{{Seiteninfo
|Quality-flag = [[File:quality-flag-white.gif|right|70px]]
+
|Quality-flag = [[File:quality-flag-green.gif|right|70px]]
|Status = Seite in Bearbeitung
+
|Status = Seite fertig, inhaltlich OK
 
}}
 
}}
  
 
[[Kategorie:Hinweise für Autoren]]
 
[[Kategorie:Hinweise für Autoren]]

Aktuelle Version vom 26. März 2024, 18:02 Uhr

Schreiben.jpg

Hier kannst Du nachlesen, wie neue Seiten im Baustatik-Mediawiki nach einem einheitlichen Format erstellt werden. Außerdem werden einige Regeln erläutert, die bei der Erstellung von Seiten zu beachten sind.

Um einen neuen Beitrag am einfachsten zu erstellen, musst du den Titel des Beitrages zunächst über das Suchfeld von Baustatik-Wiki suchen. Wenn der Beitrag noch nicht im Wiki vorhanden ist, wird dir der Titel in Rot angezeigt. Durch anklicken wird dann eine neue Seite mit dem Titel erstellt, die du speichern kannst. Danach kannst du dir aus der "Vorlage für neue Beiträge" im Bearbeitungsmodus den Quellcode kopieren und durch deine Texte und Bilder austauschen.

Erstellen einer Seite in - Grundlagen/Begriffe -

Bezeichnung von Seiten

Da Seiten im Bereich - Grundlagen/Begriffe - unterschiedliche Informationen enthalten können, gibt es hier auch unterschiedliche Möglichkeiten der Seitenbezeichnung:

  • Begriffe
Enthält die Seite die Definition und Erläuterung eines Fachbegriffs, dann ergibt sich die Seitenbezeichnung einfach aus dem zu bezeichnenden Begriff.
Beispiel 1: Betonstahlmatten
Beispiel 2: Feuerwiderstandsdauer
  • abgrenzbare Themen (Einzelthemen)
Enthält die Seite Informationen zu einem gut abgrenzbaren Thema, welches nur auf der bezeichneten Seite behandelt wird, dann ergibt sich die Seitenbezeichnung einfach aus dem behandelten Thema.
Beispiel 1: Betondeckung
Beispiel 2: Mitwirkende Plattenbreite
  • komplexe Themen (Behandlung eines Teilthemas auf der betreffenden Seite)
Enthält die Seite Informationen zu einem Teilthema, welches sich in einen größeren Themenkomplex einordnen lässt oder für eine bessere Verständlichkeit einem Oberbegriff zugeordnet werden muss, dann ergibt sich die Seitenbezeichnung aus dem Oberbegriff/Themenkomplex + dem behandelten Teilthema. Trennzeichen ist hier ein Bindestrich.
Beispiel 1: Durchstanzen - Bemessungswert der einwirkenden Querkraft
Beispiel 2: Deckengleicher Unterzug - Lasteinzugsfläche

Grundsätzlich sind für die Bezeichnung von Seiten nur Sachbegriffe zu wählen, da die Seiten in der Kategorie-Übersicht alphabetisch geordnet werden.

Beispiel: Mitwirkende Plattenbreite (RICHTIG) - Ermittlung der mitwirkenden Plattenbreite (FALSCH)

Struktur von Seiten

Eine Seite in den Kategorien - Grundlagen/Begriffe - hat grundsätzlich folgende Struktur:

  • Seiten-Vorschau
Wenn man mit der Maus über den Link zu einer Seite fährt, kann eine kurze Seitenvorschau (bestenfalls Kurztext mit einer Abbildung) angezeigt werden. Das klappt aber nur, wenn Kurztext und Abbildung vor der Gliederung angeordnet werden. Der Link auf die Abbildung steht ganz oben (als Vorlage siehe z. B. Expositionsklassen).
Kurztext und Abbildung sollten so aufgebaut sein, dass Sie eine gute Übersicht über den zu erwartenden Seiteninhalt geben.
  • Seiteninhalt
Der Inhalt der Seite kann nach eigenem Ermessen strukturiert werden. Ziel ist es hier das behandelte Thema möglichst anschaulich zu behandeln, unter Beachtung schon vorhandener Seiten abzugrenzen und ggf. entsprechende Links zu anderen Seiten (Erläuterung von Begriffen, verwandte Themen/Seiten) einzufügen.
Zur einheitlichen Gestaltung von Seiteninhalten (Text, Formeln, Grafiken) gibt es später noch genauere Hinweise.
  • Quellenangaben
Zusammenfassung der verwendeten Quellen (siehe auch - Quellenverweise)
  • Seiteninfo
Das Feld [Seiteninfo] gibt eine Übersicht über den Bearbeitungsstand der Seite und eine Bewertung der Informationsqualität (siehe auch Qualitätssicherung). Für die Seiteninfo ist die Vorlage Seiteninfo zu benutzen.
  • Kategorie
Je nach betrachteter Bauweise ist die Seite in eine passende Kategorie einzuordnen.
Beispiel 1: [[Kategorie:Grundlagen/Begriffe-Stahlbetonbau]]
Beispiel 2: [[Kategorie:Grundlagen/Begriffe-Stahlbau]]

Einheitliche Gestaltung von Seiten

Text

Für die textliche Gestaltung von Seiten gibt es keine besonderen Hinweise. Es gelten die generellen Regeln für die übersichtliche und anschauliche Erstellung von Texten, d. h.

  • kurze präzise Formulierungen
  • sinnvolle Anordnung von Absätzen
  • Nutzung von strukturierten Inhalten (Aufzählungen, Tabellen) an den passenden Stellen

Grafische Darstellungen

Veranschaulichung der Betondeckungsmaße (Beispiel-Abbildung)

Grafische Darstellungen sind rechtsbündig in Rahmen anzuordnen und mit einer Bildunterschrift zu versehen. Der Zusammenhang zwischen Text und Abbildung ist durch die räumliche Nähe und ggf. durch geeignete Formulierungen im Text herzustellen (keine Bild-Nummerierungen o. ä.). Die Bildgröße kann variieren. Falls möglich, ist es sinnvoll die Schriftgröße in Abbildungen und die Größe der Abbildung so zu wählen, dass diese nicht unbedingt aufgemacht werden muss, um deren Inhalt zu erfassen. Grafiken (Dateien) sind vor dem Hochladen nach folgenden Regeln zu bezeichnen.

  • vollständiger Titel der Seite auf der die Datei (erstmalig) verwendet wird + laufende Nummerierung
  • Beispiel: Betondeckung2.png (siehe Beispiel-Abbildung)
Achtung :
  • Die Dateinamen von Grafikdateien dürfen keine Umlaute enthalten. Sonst gibt es Zuordnungsprobleme.

Formeln und Bezeichnungen

Für Formeln gelten ähnliche Regeln wie für grafische Darstellungen. Der Bezug zum Text wird durch die räumliche Nähe hergestellt (keine Nummerierung der Formel). Jede Formel sollte hinsichtlich Ihrer Bestandteile vollständig erklärt werden. Auch wenn eine ähnliche Formulierung auf der gleichen oder einer anderen Seite zu finden ist, muss davon ausgegangen werden, dass der Leser auf unterschiedlichem Wege zum betreffenden Abschnitt gelangt ist und daher eine vollständige Beschreibung des Formelinhalts zu schätzen weiß.

Beispiel:



wobei:

cmin... Mindestbetondeckung
∆cdev... Vorhaltemaß


Bezüglich der Verwendung von Formeln und Berechnungen in Beispielen gelten andere Regeln.

Die Erstellung von Formeln erfolgt mithilfe der LaTeX-Codierung (siehe - Formeln).

Beispiel-Seiten

Nachfolgend sind einige Seiten angegeben, die hinsichtlich Ihrer Struktur und der Formatierung den zuvor beschriebenen Regeln entsprechen:

Erstellen einer Seite in - Software-Anwendungen -

Bezeichnung und Strukturierung von Seiten

Hauptseiten

Die Bezeichnung und Strukturierung von Seiten in dem Bereich - Software-Anwendungen - folgt prinzipiell der Bezeichnung und Strukturierung der betreffenden Software-Anwendungen selbst (z. B. Baustatik-Module der mb Worksuite). Die Hauptseite des betreffenden Moduls erhält damit als Seitentitel die Bezeichnung des zugehörigen Moduls (Modul-Nr. + Bezeichnung)

Beispiel für ein Baustatik-Modul der mb Worksuite: S200.de Einachsig gespannte Mehrfeldplatte

Die Hauptseiten haben in der oberen Gliederungsebene immer die gleiche Struktur:

  • Eingabe → verweist auf Seiten mit Hinweisen zur Eingabe von Informationen für die Berechnung
  • Grundlagen → verweist auf maßgebende Berechnungsgrundlagen (Seiten in - Grundlagen/Begriffe -)
  • Beispiele → verweist auf Seiten mit zugehörigen Beispielberechnungen (Seiten in - Beispiele -)
  • Kategorie
Je nach betrachteter Bauweise ist die Seite in eine passende Kategorie einzuordnen. Für die Strukturierung der Liste auf der Kategorie-Seite kann der Kategorie-Angabe noch die Nr. des mb AEC Moduls hinzugefügt werden.
Beispiel 1: [[Kategorie:MB-AEC Baustatik-Module Stahlbetonbau|200]]
Beispiel 2: [[Kategorie:MB-AEC Baustatik-Module Stahlbau|404]]

Alle folgenden Erläuterungen beziehen sich nur noch auf Seiten in der Ebene [Eingabe].

Für die Bezeichnung von Seiten in - Grundlagen/Begriffe - → siehe Bezeichnung von Seiten in - Grundlagen/Begriffe -
Für die Bezeichnung von Seiten in - Beispiele - → siehe ...


Seiten zu Eingabekategorien

Der Eingabebereich eines jeden mb AEC Moduls gliedert sich in Eingaberegister (Reiter) und Eingabekategorien (Unterpunkte im jeweiligen Eingaberegister). Für Hinweise zur Eingabe wird für jede Eingabekategorie eine neue Seite angelegt. Sie erhält folgende Bezeichnung: Benennung der Eingabekategorie + Modul-Nr. (...des mb AEC Moduls). Einige Standard-Eingabekategorien werden mit gleichem oder ähnlichem Aufbau in mehreren mb AEC Modulen benutzt. Die Modul-Nr. wird dann durch 3 Sterne ersetzt.

Beispiel 1 (für eine modulindividuelle Eingabekategorie): Zusatzangaben Plattenbalken (S340.de)
Beispiel 2 (für eine modulübergreifende Eingabekategorie): Werkstoff (S***.de)

Die Seiten im Bereich - mb AEC Module - haben in der Regel folgenden einheitliche Aufbau:

  • Eingabe
  • Hinweise
  • Quellenangaben
  • Seiteninfo
Das Feld [Seiteninfo] gibt eine Übersicht über den Bearbeitungsstand der Seite und eine Bewertung der Informationsqualität (siehe auch Qualitätssicherung). Im Unterschied zu den Seiten in - Grundlagen/Begriffe - ist hier für die Seiteninfo die Vorlage Seiteninfo(mb) zu benutzen. Diese enthält zusätzlich noch die Modul-Versions-Nr., auf die sich die Informationen beziehen.

einheitlicher Aufbau von Seiten

Eingabe

Den Informationen zur Eingabe sollte eine grafische Darstellung des Eingabebereiches vorangestellt werden. Im Unterschied zu den grafischen Darstellungen in den Seiten des Bereiches - Grundlagen/Begriffe - werden die Darstellungen in den hier betreffenden Seiten einfach linksbündig ohne Rahmen und Bezeichnung angeordnet.

Beispiel:

Baustatik-Wiki



Manche Eingabebereiche sind dynamisch aufgebaut, d. h. sie verändern ihre Gestalt und ihre Eingabeoptionen z. B. je nachdem welches Verfahren ausgewählt wurde oder welche Option angewählt wurde. Die Darstellung des Eingabebereiches sollte hier möglichst vollständig erfolgen, so dass alle Eingabemöglichkeiten erklärt werden können. Das kann u. U. mehrfache Darstellungen eines Eingabebereiches erfordern. Ggf. sind auch erklärende Bildunterschriften sinnvoll.
Alternativ können unterschiedliche Eingabemöglichkeiten sehr gut durch eine Gliederung der betreffenden Seite erläutert werden. Es ist grundsätzlich sinnvoll die Eingabe möglichst vollständig zu erklären. Dabei sind kurze, kompakte, übersichtlich strukturierte Informationen zu bevorzugen. Diese können und sollten ggf. durch Hinweise zu Normen/Richtlinien usw. oder auch Hinweise zu Anwendungsgrenzen ergänzt werden.

Hinweise

Für die Nutzung der hier beschriebenen Seiten macht es keinen Sinn, nur Informationen zu bringen, die im Wesentlichen schon in der Anwendungshilfe der Baustatik-Module enthalten sind. Vielmehr von Bedeutung sind Hinweise, die über die in der Hilfe angegebenen Standardinformationen hinausgehen. Dies betrifft beispielsweise:

  • Hinweise zur Verwendung (oder Nichtverwendung) der Eingabeparameter in der Berechnung
  • Hinweise zur Erlangung einer benötigten Information, sofern diese nicht offensichtlich verfügbar ist und z. B. erst durch eine anderweitige Berechnung ermittelt werden muss
  • Hinweise zur Ableitung einer Information aus dem statischen System oder anderweitigen Randbedingungen
  • Hinweise zu Grenzwerten bestimmter Eingabeparameter (mit Begründung)
  • Hinweise zu Kontrollmöglichkeiten bestimmter Eingabewerte
  • ...

Beispiel-Seiten

Nachfolgend sind einige Seiten angegeben, die hinsichtlich Ihrer Struktur und der Formatierung den zuvor beschriebenen Regeln entsprechen:

Erstellen einer Seite in - Beispiele -

Bezeichnung von Seiten

Die Bezeichnung von Seiten im Bereich - Beispiele - erfolgt nach folgendem Schema:

  • Einzelthema + (Bsp.) - für ein Einzelthema
Beispiel 1: Betondeckung (Bsp.)
  • Oberbegriff/Themenkomplex - Teilthema + (Bsp.)
Beispiel 2: Zwang - Mindestbewehrung zur Rissbreitenbegrenzung für eine Sohlplatte (Bsp.)

Struktur von Seiten

Die Seiten sollten mindestens folgende Abschnitte bzw. Elemente aufweisen:

  • Aufgabenstellung
Die Aufgabenstellung muss alle Informationen beinhalten, die für die Erfassung der Ausgangssituation und die weitere Berechnung benötigt werden (z. B. Bauteilgeometrie, Baustoffkennwerte, Einwirkungen/Schnittgrößen, statische Randbedingungen usw.). Darüber hinaus ist das konkrete Ziel der Beispielberechnung zu beschreiben. Die Aufgabenstellung sollte immer auch eine oder mehrere grafische Darstellungen des betrachteten Bauteils, des Bauteilausschnitts oder des Tragsystems enthalten.
  • Lösung

Die Lösung beinhaltet je nach Ermessen des Autors alle Berechnungsschritte, Annahmen und Informationen, die für ein vollständiges Nachvollziehen des Berechnungsablaufes erforderlich sind.

  • Quellenangaben (falls auf Quellen verwiesen wird)
Zusammenfassung der verwendeten Quellen (siehe auch - Quellenverweise)
  • Seiteninfo
Das Feld [Seiteninfo] gibt eine Übersicht über den Bearbeitungsstand der Seite und eine Bewertung der Informationsqualität (siehe auch Qualitätssicherung). Für die Seiteninfo ist die Vorlage Seiteninfo zu benutzen.

Hinweise für eine gute Gestaltung von Seiten

  • Bemühen Sie sich um eine übersichtliche Struktur der Seite (Leerzeilen, Einrückungen, Markierungen)! Um so besser und schneller lassen sich Detailinformationen aus der Berechnung entnehmen.
  • Versehen Sie die einzelnen Berechnungsschritte mit entsprechenden erläuternden Bemerkungen (z.B. Erklärungen, Annahmen oder Herkunft von Eingangsgrößen usw.)!
  • Vermeiden Sie sich häufig wiederholende gleichartige Berechnungen ohne jeden informativen Mehrwert! Dadurch wird das Berechnungsbeispiel unübersichtlich. Hier reicht (für den Fall, dass man auf derartige Ergebnisse Bezug nehmen muss oder möchte) eine einfache Angabe des Berechnungsergebnisses (ggf. mit Verweis auf das angewendete Verfahren). Bei einer größeren Anzahl gleichartiger Berechnungsergebnisse bietet eine tabellarische Darstellung eine gute Übersicht.
  • Verwenden Sie ggf. grafische Darstellungen, um die Definition bestimmter Größen deutlich zu machen (z. B. Abmessungen)! Auch grafische Darstellungen von Ablesungen in Tabellen oder Diagrammen (günstigerweise mit Hervorhebung der Ablesung) verbessern die Nachvollziehbarkeit Ihrer Berechnung erheblich.

Beispiel-Seiten

Nachfolgend sind einige Seiten angegeben, die hinsichtlich Ihrer Struktur und der Formatierung den zuvor beschriebenen Regeln und Hinweisen entsprechen:


Seiteninfo
Quality-flag-green.gif
Status: Seite fertig, inhaltlich OK