SELFHTML:Beispiel-Dokumentationsseite
Aus SELFHTML-Wiki
Achtung!
Im Gegensatz zur bisherigen Version sind die Abschnitte „Erläuterung“ und „Beachten Sie“ als Zwischenüberschriften weggefallen. Die Informationen aus „Erläuterung“ sind in den Fließtext eingearbeitet worden da es sich um allgemeine Erläuterungen zum Thema handelte. Für Erläuterungen die sich direkt auf das Beispiel beziehen, kann das Modul BeispielText der Vorlage:Beispiel verwendet werden (ausführliche Anwendungshinweise siehe dort).
Für den Code in den Beispielen ist übrigens bewusst auf das <source>-Element zur automatischen Syntaxhervorhebung verzichtet worden, weil zu viel Farbe vom eigentlich zu Erläuternden ablenkt. Stattdessen wurden nur die besprochenen Elemente besonders hervorgehoben.
Für „Beachten Sie“-Informationen steht ebenfalls eine Vorlage zur Verfügung: Vorlage:Beachten.
Die Icon-Leiste unter den Zwischenüberschriften kann mit der Vorlage:Iconset erstellt werden, die einzelnen Icons am Seitenende wurden mit der Vorlage:Icon eingebunden.
Hinweis:
Inhaltsverzeichnis |
Zeilenumbruch erzwingen
Text innerhalb von normalen Absätzen, Listen, sowie in Überschriften oder Tabellenzellen wird vom Web-Browser bei der Anzeige automatisch umbrochen. Sie können jedoch an einer gewünschten Stelle einen Zeilenumbruch erzwingen, indem Sie ein <br> (br = break = Umbruch) einfügen. Dabei ist es egal, ob das alleinstehende Tag am Ende der vorherigen Zeile steht (wie im Beispiel), oder in einer eigenen Zeile, oder am Anfang der folgenden Zeile.
br-Element als inhaltsleer kennzeichnen. Dazu notieren Sie das alleinstehende Tag in der Form <br />. Weitere Informationen finden Sie im Kapitel XHTML und HTML.Automatischen Zeilenumbruch verhindern
Sie können einen Textbereich bestimmen, in dem kein automatischer Zeilenumbruch erfolgt. Alles, was innerhalb dieses Bereichs steht, wird in einer langen Zeile angezeigt. Der Anwender kann dann mit der horizontalen Scroll-Leiste die überlangen Textzeile anzeigen.
<nobr> bewirkt, dass der auf das Tag folgende Text nicht umbrochen wird (nobr = no break = kein Umbruch). Am Ende des Textabschnitts, der nicht umbrochen werden soll, notieren Sie das abschließende Tag </nobr>.
Geschützte Leerzeichen
Sie können verhindern, dass bei einem Leerzeichen ein automatischer Zeilenumbruch erfolgen darf.
Die Zeichenfolge erzeugt ein geschütztes Leerzeichen (nbsp = nonbreaking space = Leerzeichen ohne Umbruch). Es wird ein normales Leerzeichen angezeigt, doch an dieser Stelle kann kein Zeilenumbruch erfolgen. Notieren Sie die Zeichenfolge inklusive dem "kaufmännischen Und" (&) am Beginn und dem Strichpunkt am Ende. Die gleiche Wirkung erzielen Sie durch Notieren der Zeichenfolge  .
Zu dieser Art von Zeichennotation siehe auch benannte Zeichen für die Zeichenkodierung ISO 8859-1.
Durch Notieren mehrerer solcher benannter Zeichen hintereinander können Sie auch mehrere Leerzeichen in Folge erzwingen.
Zeilenumbruch erlauben
Web-Browser brechen Text normalerweise nur bei Leerzeichen um, weil durch Leerzeichen Wörter voneinander abgegrenzt werden. Sie können explizit weitere Stellen markieren, an denen er den Text umbrechen darf. Sinnvoll ist dies bei langen Wörtern. Dies gilt für alle Absatzarten in HTML.
Beachten Sie bitte die Browserhinweise am Ende dieses Abschnitts.
Mit ­ (= soft hyphen = bedingter Trennstrich) markieren Sie eine Stelle, an der getrennt werden darf, falls das Wort bei der Bildschirmanzeige am Ende der Zeile steht und der Platz für eine vollständige Darstellung nicht mehr ausreicht. Der Browser sollte das Wort an dieser Stelle mit einem Umbruch trennen und einen Trennstrich einfügen.
<wbr> (wbr = word break = Umbruch innerhalb eines Wortes) bewirkt ebenfalls einen optionalen Umbruch, fügt jedoch keinen Trennstrich ein. Innerhalb von Abschnitten mit verhindertem Zeilenumbruch bewirkt <wbr>, dass an der betreffenden Stelle trotzdem ein Umbruch erfolgen darf. <wbr> gehört nicht zum offiziellen HTML-Sprachstandard. Sie sollten dieses Element daher vermeiden.
Als Alternative wäre ​ (zero width space = Leerzeichen ohne Breite) denkbar, da bei Leerzeichen grundsätzlich ein Umbruch erfolgen darf. Allerdings erzeugt auch dieses Zeichen keinen Trennstrich und es ist nicht in jeder Schriftart enthalten, was dann zur Darstellung eines Kästchens führt.
ja bedeutet, dass ein Umbruch erfolgt und ein Trennstrich sichtbar ist
nein bedeutet, dass die Notation keinerlei Auswirkung auf die Darstellung hat
kein Trennstrich bedeutet, dass zwar ein Umbruch erfolgt, jedoch kein Trennstrich sichtbar ist
fehlerhaft bedeutet, dass immer ein Trennstrich oder ein unerwünschtes Zeichen erscheint und/oder nicht umbrochen wird
Somit existiert derzeit keine Möglichkeit, bedingte Zeilenumbrüche zuverlässig und fehlerfrei einzusetzen.
Weitere Informationen
In der HTML-Referenz finden Sie genaue Angaben darüber, wo Zeilenumbrüche vorkommen dürfen, welche Attribute sie haben können und was bei den einzelnen Attributen zu beachten ist:
Element-Referenz für Zeilenumbrüche
Attribut-Referenz für Zeilenumbrüche

