Hostsharing Wiki - Benutzerbeiträge [de]

Diskussion:Guter Stil

2012-04-23T13:00:43Z

Hsh00-purodha: /* Anrede des Lesers */

== Anrede des Lesers ==

Im Text steht momentan: "Sie ist wenn möglich in der zweiten oder dritten Person geschrieben, damit andere leichter an der Seite weiterarbeiten können."

Das finde ich etwas unklar bzw. nicht ausreichend. Erstens gibt es zwei Personen, von denen man in einem Artikel häufig sprechen wird: Hostsharing und den Leser. Von Hostsharing können wir meiner Meinung nach sowohl in der ersten Person Plural sprechen ("Wir bieten die Möglichkeit, ...") als auch in der dritten Person ("Hostsharing bietet die Möglichkeit, ..."). Je nachdem, was stilistisch besser passt, sollte der Autor die passende Form wählen.

Bei der Ansprache des Lesers gibt es schon ein paar mehr Möglichkeiten:

* Erste Person Plural ("Autor-und-Leser-Wir"), zum Beispiel: "Um einen neuen Benutzer anzulegen, geben wir auf der Kommandozeile xyz ein."). Nachteil: Gefahr der Verwechslung mit dem Wir, das sich (nur) auf Hostsharing bezieht; Gefahr, dass die Formulierung den Leser vereinnahmt.
* Zweite Person Du: "Um einen neuen Benutzer anzulegen, gibst Du auf der Kommandozeile xyz ein". Vorteil: entspricht dem üblichen Schreibstil auf unseren Mailinglisten. Nachteil: manche Anwender möchten nicht geduzt werden, die Dokumentation ist für Reseller nicht direkt verwendbar.
* Zweite Person Sie: "Um einen neuen Benutzer anzulegen, geben Sie auf der Kommandozeile xyz ein". Vorteil/Nachteil genau umgekehrt zum Du.
* Dritte Person: "Um einen neuen Benutzer anzulegen, gibt {man | der Paketadmin} auf der Kommandozeile xyz ein". Vorteil: neutral, Nachteil: unpersönlich.

Momentan werden in der Dokumentation alle diese Formen (außer "Sie") verwendet, teilweise sogar alle innerhalb eines Artikels, außerdem ziemlich häufig das Passiv. Ich denke, dass wir uns zumindest zwischen Wir, Du und Sie als Ansprache für den Leser entscheiden sollten, oder ganz auf die dritte Person beschränken. Oder wir legen uns nicht fest und halten es nur innerhalb eines Artikels konsistent.

Ich neige momentan dazu, das Du zu bevorzugen (plus Dritte Person und Passiv bei Bedarf).

Meinungen dazu?

--[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 23:18, 20. Feb. 2009 (UTC)

Unter uns ist das kein Problem. Die Doku soll aber auch Kunden von Resellern dienen, zumindest teilweise. Da hielte ich das "Sie" für angebrachter.

--[[Benutzer:Jsc00-wiki|Jsc00-wiki]] 09:03, 24. Mai 2009 (UTC)

Wenn wir uns den Aufwand machen wollen, können wir die Auswahl von Du- oder Sie-Form dem Nutzer oder einem Link überlassen. Die Wikisoftware kann für angemeldete Benutzer per Einstellung und für jeden per URL-Parameter eine Sprache einstellen. Für Deutsch gibt es mehrere Dialekte und die Du- oder Sie-Form zur Auswahl. Wenn wir das in unseren Seiten berücksichtigen … Ich halte es eher für zu umständlich für uns selber. --[[Benutzer:Hsh00-purodha|hsh00-purodha]] 14:49, 23. Apr. 2012 (CEST)

== Das Durcheinander... ==

...kommt von der derzeitigen Übernahme aus der Dokumentation. Solange es diese betrifft, bin ich für "Du", denn es passt besser zu uns. "Du" ist auch in vielen Firmen Standard und es ist einfach freundlicher, es sitzt ja praktisch immer eine einzelne Person als Leser vor dem Screen, das ist eine intime Situation, in der die Person Rat sucht. Also die persönlich Ansprache mit "Du" halte ich daher für sehr geeignet - besonders, wenn es um Handlungsanweisungen geht. Dazu ist es geschlechtsneutral. --[[Benutzer:Deg00-m.website|ChristofT]] 04:33, 21. Feb. 2009 (UTC)

== Mitglieder/Kunden von Resellern ==

Wie in der Umfrage oben ausgeführt, denke ich auch an die Kunden von Resellern, für die die Doku bestimmt ist. Dort kann sich vielleicht nicht jeder mit dem "Du" anfreunden. Auf der anderen Seite ist die Doku für diesen Personenkreis ohnehin etwas kryptisch. Wäre es nicht sinnvoll, für diese Personen einen eigenen Bereich zu haben, der ausschließlich auf die speziellen Belange eingeht? (Muss ja nicht sofort sein).
--[[Benutzer:Jsc00-wiki|Jsc00-wiki]] 09:07, 24. Mai 2009 (UTC)

== Für wen wir schreiben ==

"Du" ist nicht nur der Mitgenosse, sondern schließlich jeder, der bei IKEA einkäuft, also was soll's. Anstatt einen eignen "Sie"-Bereich aufzumachen, sollten wir uns einfach bewußt machen -- um die Doku verständlicher und damit nützlicher zu machen als bisher -- daß wir für verschiedene Personenkreise schreiben. Und zwar, in einer gewissen Reihenfolge:

Ich schreibe für:

- mich selbst. Mir sind Stil, Grammatik, Satzbau, Zeichensetzung, Rechtschreibung, konsistente und genaue Terminologie, und logische Gliederung vollkommen wurscht, denn ich weiß schon so, was die Seite sagen will.

- technisch versierte System-Admins. Sie verstehen genauso wie ich, daß ich mit einem einzelnen, grammatisch völlig losgelösten Stichwort in runden Klammern eine ganze Reihe von Operationen meine, und führen diese mitdenkend aus.

- Paket-Admins mit langjähriger HS-Erfahrung. Sie wissen nicht nur, wie alles hier läuft, sondern auch, wie es früher war. Sie wissen sofort, was eine "aufgesetzte Domain" oder ein "Domain-Robot" ist.

- Neue Paket-Admins. <ironie>Mein Gott, die nerven. Denen muß man alles erklären! Können wir nicht irgendwie dafür sorgen, daß nur technisch versierte System-Admins (siehe oben) zu Hostsharing kommen? Oder mindestens Leute, die einen gelinkten HS-Begriff anklicken können, um sich selbst unseren Jargon zu erarbeiten?</ironie>

- Domain-Admins. Wie Paket-Admins bringen sie mehr oder weniger Webmasterei-Grips mit.

- Und so weiter bis zum völlig unbeleckten und leider Gottes auch noch etwas begriffsstutzigen Reseller-Endkunden.

Kurz: Laßt uns doch, im Ggs zur alten HS-Doku, für den interessierten Leser schreiben, der kein Gedankenleser ist, auch wenn er Allgemeinbildung, Wohlwollen und durchschnittliche Intelligenz mitbringt. Schreiben wir ganze Sätze; überlegen wir uns, wie etwas korrekt zu bezeichnen ist; bleiben wir bei der gewählten Bezeichnung; setzen wir nicht voraus, daß der Leser schon die ganze Struktur des Dateisystems inklusive Permissions kennt. Gliedern wir die Anleitungen in der chronologischen Reihenfolge der Arbeitsschritte; gliedern wir die Softwarebeschreibungen so, daß die Optionen erklärt werden, bevor sie in Beispielen verwendet werden. Erklären wir die grundlegenden Strukturen am Anfang einer Beschreibung, nicht erst am Ende.

Darf ich etwas davon in die "Guter Stil"-Seite aufnehmen?

[[Benutzer:Apc00-tony|Apc00-tony]] 11:06, 17. Jun. 2009 (UTC)

== Rückgängig erste Person ==

Nein, es war nicht "eigentlich zweite Person", sondern es ist erste Person. Daher rückgängig gemacht.

"Kontrolliere das Ergebnis Deiner Eingaben mit der Vorschau, bevor Du die Seite endgültig speicherst." Hier ist das Objekt (Du) zweite Person, aber das Subjekt ist der nicht aufgeführte Autor, der in der ersten Person das Objekt anspricht: "Kontrolliere", nicht "Du kontrollierst" (da wäre das Subjekt zweite Person) oder "Man kontrolliert" (das wäre das Subjekt 3. Person). --[[Benutzer:Deg00-m.website|ChristofT]] 10:05, 18. Jun. 2009 (UTC)

:Sorry -- Da ist "Du" nicht Objekt, sondern Subjekt. "Kontrolliere Du das Ergebnis ..." wäre ebenso grammatikalisch und fast derselbe Satz. Bloß muß das Subjekt im Imperativ nicht explizit erscheinen. Im Allgemeinen sind Imperativsätze in der zweite Person. Ähnlich ist allerdings die optative Verwendung des Konjunktivs in der 3. Person: "Er möge das Ergebnis seiner Eingaben kontrollieren," oder gar "Er kontrolliere ...". Eine entsprechende Form in der ersten Person wäre künstlich, da man sich selbst normalerweise keine Befehle erteilt.

:Wenn du in deinem Satz ein Subjekt in der erste Person haben willst, kannst du es explizit schreiben, un jedes Mißverständnis auszuschließen: "'''Ich''' kontrolliere das Ergebnis Deiner Eingaben mit der Vorschau, bevor Du die Seite endgültig speicherst." Da könnte die Realiseriung aber technisch aufwendig sein ...--[[Benutzer:Apc00-tony|Apc00-tony]] 16:14, 18. Jun. 2009 (UTC)

::'''Ok''', ich schätze, Du hast recht. Ich habe jetzt den Satz mit der Person rausgeworfen. :-) --[[Benutzer:Deg00-m.website|ChristofT]] 17:23, 18. Jun. 2009 (UTC)

:::Wie hat man bloß kommuniziert, bevor die Grammatik erfunden wurde? :-)

:::: :-) Mit Keulen. Und mann hat sich über drei Dinge unterhalten: Beeren, Fleisch und Frauen. Je nachdem unterschiedlich priorisiert. --[[Benutzer:Deg00-m.website|ChristofT]] 23:31, 19. Jun. 2009 (UTC)

:::Sonst bin ich mit dir natürlich in allem einer Meinung und befürworte sehr die Bemühungen um Konsistenz und Verständlichkeit in der HS-Doku -- die mich seit Jahren häufig nervt. Ich freue mich riesig, daß die Doku jetzt auf Wiki umgestellt wurde, denn da werde ich (wie andere auch, nehme ich an) den Frust konstruktiv umsetzen können.
:::Meine Ideen über technische Redaktion sind nun mal von englischen Gepflogenheiten geprägt (ich durfte einmal für O'Reilly schreiben und verstand mich prächtig mit meinem Lektor) -- wir Englischsprachigen fragen uns häufig, wieso die Deutschen soviel Vorwissen oder Mitdenken oder Richtigraten seitens des Lesers, gerade in technischen Texten, voraussetzen können.
:::Nun ja. Was meinst du, ob ein paar Worte zu Fragen der Gliederung, Informationsumfang usw. in die Hilfeseiten für Wiki-Mitautoren hineingehören?--[[Benutzer:Apc00-tony|Apc00-tony]] 13:59, 19. Jun. 2009 (UTC)

:::: Danke und Danke! Es gibt ja schon die [[Hostsharing Wiki Konventionen | Konventionen]], das ist eventuell der bessere Platz für solche Dinge als [[Guter Stil]], keine Ahnung. Es gibt durchaus Handlungsbedarf, was die Verständlichkeit und den Schreibstil in der Dokumentation angeht, da gebe ich Dir vollkommen recht! Ich freue mich, dass ein neuer "Schreiberling" hier auftaucht und nicht ein weiterer "Techniker". Schreiben (in der Form, dass auch jemand den Hintergrund und das "Herz", das in HS steckt, in den Worten versteht) ist eine Sache, die nicht jedem gegeben ist, aber die "Techniker" bringen den Vorteil der Genauigkeit, der Stringenz und des Arbeitswillens. Wenn wir das in irgend einer Weise vereinen können, dann kann das Ding hier wirklich vollkommen geil werden. Aber ich denke, dass diese Diskussion hier nicht gut aufgehoben ist, sondern in der Mailingliste website@ geführt werden sollte. Ich habe das Gefühl, die Dokumentation fängt an zu "zerfleddern", vielleicht liege ich auch falsch. Wir müssen uns auf alle Fälle Gedanken über die Struktur machen, die alte Struktur funktioniert auf Dauer nicht. Wir müssen vom Überblick ausgehend ins Detail gehen. Im Moment wird der Leser mit Details erschlagen - ich denke, so habe ich Deine Kritik begriffen, oder? --[[Benutzer:Deg00-m.website|ChristofT]] 23:31, 19. Jun. 2009 (UTC)

Diskussion:Guter Stil

2012-04-23T12:49:27Z

Hsh00-purodha: /* Anrede des Lesers */

== Anrede des Lesers ==

Im Text steht momentan: "Sie ist wenn möglich in der zweiten oder dritten Person geschrieben, damit andere leichter an der Seite weiterarbeiten können."

Das finde ich etwas unklar bzw. nicht ausreichend. Erstens gibt es zwei Personen, von denen man in einem Artikel häufig sprechen wird: Hostsharing und den Leser. Von Hostsharing können wir meiner Meinung nach sowohl in der ersten Person Plural sprechen ("Wir bieten die Möglichkeit, ...") als auch in der dritten Person ("Hostsharing bietet die Möglichkeit, ..."). Je nachdem, was stilistisch besser passt, sollte der Autor die passende Form wählen.

Bei der Ansprache des Lesers gibt es schon ein paar mehr Möglichkeiten:

* Erste Person Plural ("Autor-und-Leser-Wir"), zum Beispiel: "Um einen neuen Benutzer anzulegen, geben wir auf der Kommandozeile xyz ein."). Nachteil: Gefahr der Verwechslung mit dem Wir, das sich (nur) auf Hostsharing bezieht; Gefahr, dass die Formulierung den Leser vereinnahmt.
* Zweite Person Du: "Um einen neuen Benutzer anzulegen, gibst Du auf der Kommandozeile xyz ein". Vorteil: entspricht dem üblichen Schreibstil auf unseren Mailinglisten. Nachteil: manche Anwender möchten nicht geduzt werden, die Dokumentation ist für Reseller nicht direkt verwendbar.
* Zweite Person Sie: "Um einen neuen Benutzer anzulegen, geben Sie auf der Kommandozeile xyz ein". Vorteil/Nachteil genau umgekehrt zum Du.
* Dritte Person: "Um einen neuen Benutzer anzulegen, gibt {man | der Paketadmin} auf der Kommandozeile xyz ein". Vorteil: neutral, Nachteil: unpersönlich.

Momentan werden in der Dokumentation alle diese Formen (außer "Sie") verwendet, teilweise sogar alle innerhalb eines Artikels, außerdem ziemlich häufig das Passiv. Ich denke, dass wir uns zumindest zwischen Wir, Du und Sie als Ansprache für den Leser entscheiden sollten, oder ganz auf die dritte Person beschränken. Oder wir legen uns nicht fest und halten es nur innerhalb eines Artikels konsistent.

Ich neige momentan dazu, das Du zu bevorzugen (plus Dritte Person und Passiv bei Bedarf).

Meinungen dazu?

--[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 23:18, 20. Feb. 2009 (UTC)

Unter uns ist das kein Problem. Die Doku soll aber auch Kunden von Resellern dienen, zumindest teilweise. Da hielte ich das "Sie" für angebrachter.

--[[Benutzer:Jsc00-wiki|Jsc00-wiki]] 09:03, 24. Mai 2009 (UTC)

Wenn wir uns den Aufwand machen wollen, können wir die Auswahl von Du- oder Sie-Form dem Nutzer oder einem Link überlassen. Die Wikisoftware kann für angemeldete Benutzer per Einstellung und für jeden per URL-Parameter eine Sprache einstellen. Für Deutsch gibt es mehrere Dialekte und die Du- oder Sie-Form zur Auswahl. Wenn wir das in unseren Seiten berücksichtigen … Ich halte es eher für zu umständlich für uns selber. --[[Benutzer:Hsh00-purodha|Hsh00-purodha]] 14:49, 23. Apr. 2012 (CEST)

== Das Durcheinander... ==

...kommt von der derzeitigen Übernahme aus der Dokumentation. Solange es diese betrifft, bin ich für "Du", denn es passt besser zu uns. "Du" ist auch in vielen Firmen Standard und es ist einfach freundlicher, es sitzt ja praktisch immer eine einzelne Person als Leser vor dem Screen, das ist eine intime Situation, in der die Person Rat sucht. Also die persönlich Ansprache mit "Du" halte ich daher für sehr geeignet - besonders, wenn es um Handlungsanweisungen geht. Dazu ist es geschlechtsneutral. --[[Benutzer:Deg00-m.website|ChristofT]] 04:33, 21. Feb. 2009 (UTC)

== Mitglieder/Kunden von Resellern ==

Wie in der Umfrage oben ausgeführt, denke ich auch an die Kunden von Resellern, für die die Doku bestimmt ist. Dort kann sich vielleicht nicht jeder mit dem "Du" anfreunden. Auf der anderen Seite ist die Doku für diesen Personenkreis ohnehin etwas kryptisch. Wäre es nicht sinnvoll, für diese Personen einen eigenen Bereich zu haben, der ausschließlich auf die speziellen Belange eingeht? (Muss ja nicht sofort sein).
--[[Benutzer:Jsc00-wiki|Jsc00-wiki]] 09:07, 24. Mai 2009 (UTC)

== Für wen wir schreiben ==

"Du" ist nicht nur der Mitgenosse, sondern schließlich jeder, der bei IKEA einkäuft, also was soll's. Anstatt einen eignen "Sie"-Bereich aufzumachen, sollten wir uns einfach bewußt machen -- um die Doku verständlicher und damit nützlicher zu machen als bisher -- daß wir für verschiedene Personenkreise schreiben. Und zwar, in einer gewissen Reihenfolge:

Ich schreibe für:

- mich selbst. Mir sind Stil, Grammatik, Satzbau, Zeichensetzung, Rechtschreibung, konsistente und genaue Terminologie, und logische Gliederung vollkommen wurscht, denn ich weiß schon so, was die Seite sagen will.

- technisch versierte System-Admins. Sie verstehen genauso wie ich, daß ich mit einem einzelnen, grammatisch völlig losgelösten Stichwort in runden Klammern eine ganze Reihe von Operationen meine, und führen diese mitdenkend aus.

- Paket-Admins mit langjähriger HS-Erfahrung. Sie wissen nicht nur, wie alles hier läuft, sondern auch, wie es früher war. Sie wissen sofort, was eine "aufgesetzte Domain" oder ein "Domain-Robot" ist.

- Neue Paket-Admins. <ironie>Mein Gott, die nerven. Denen muß man alles erklären! Können wir nicht irgendwie dafür sorgen, daß nur technisch versierte System-Admins (siehe oben) zu Hostsharing kommen? Oder mindestens Leute, die einen gelinkten HS-Begriff anklicken können, um sich selbst unseren Jargon zu erarbeiten?</ironie>

- Domain-Admins. Wie Paket-Admins bringen sie mehr oder weniger Webmasterei-Grips mit.

- Und so weiter bis zum völlig unbeleckten und leider Gottes auch noch etwas begriffsstutzigen Reseller-Endkunden.

Kurz: Laßt uns doch, im Ggs zur alten HS-Doku, für den interessierten Leser schreiben, der kein Gedankenleser ist, auch wenn er Allgemeinbildung, Wohlwollen und durchschnittliche Intelligenz mitbringt. Schreiben wir ganze Sätze; überlegen wir uns, wie etwas korrekt zu bezeichnen ist; bleiben wir bei der gewählten Bezeichnung; setzen wir nicht voraus, daß der Leser schon die ganze Struktur des Dateisystems inklusive Permissions kennt. Gliedern wir die Anleitungen in der chronologischen Reihenfolge der Arbeitsschritte; gliedern wir die Softwarebeschreibungen so, daß die Optionen erklärt werden, bevor sie in Beispielen verwendet werden. Erklären wir die grundlegenden Strukturen am Anfang einer Beschreibung, nicht erst am Ende.

Darf ich etwas davon in die "Guter Stil"-Seite aufnehmen?

[[Benutzer:Apc00-tony|Apc00-tony]] 11:06, 17. Jun. 2009 (UTC)

== Rückgängig erste Person ==

Nein, es war nicht "eigentlich zweite Person", sondern es ist erste Person. Daher rückgängig gemacht.

"Kontrolliere das Ergebnis Deiner Eingaben mit der Vorschau, bevor Du die Seite endgültig speicherst." Hier ist das Objekt (Du) zweite Person, aber das Subjekt ist der nicht aufgeführte Autor, der in der ersten Person das Objekt anspricht: "Kontrolliere", nicht "Du kontrollierst" (da wäre das Subjekt zweite Person) oder "Man kontrolliert" (das wäre das Subjekt 3. Person). --[[Benutzer:Deg00-m.website|ChristofT]] 10:05, 18. Jun. 2009 (UTC)

:Sorry -- Da ist "Du" nicht Objekt, sondern Subjekt. "Kontrolliere Du das Ergebnis ..." wäre ebenso grammatikalisch und fast derselbe Satz. Bloß muß das Subjekt im Imperativ nicht explizit erscheinen. Im Allgemeinen sind Imperativsätze in der zweite Person. Ähnlich ist allerdings die optative Verwendung des Konjunktivs in der 3. Person: "Er möge das Ergebnis seiner Eingaben kontrollieren," oder gar "Er kontrolliere ...". Eine entsprechende Form in der ersten Person wäre künstlich, da man sich selbst normalerweise keine Befehle erteilt.

:Wenn du in deinem Satz ein Subjekt in der erste Person haben willst, kannst du es explizit schreiben, un jedes Mißverständnis auszuschließen: "'''Ich''' kontrolliere das Ergebnis Deiner Eingaben mit der Vorschau, bevor Du die Seite endgültig speicherst." Da könnte die Realiseriung aber technisch aufwendig sein ...--[[Benutzer:Apc00-tony|Apc00-tony]] 16:14, 18. Jun. 2009 (UTC)

::'''Ok''', ich schätze, Du hast recht. Ich habe jetzt den Satz mit der Person rausgeworfen. :-) --[[Benutzer:Deg00-m.website|ChristofT]] 17:23, 18. Jun. 2009 (UTC)

:::Wie hat man bloß kommuniziert, bevor die Grammatik erfunden wurde? :-)

:::: :-) Mit Keulen. Und mann hat sich über drei Dinge unterhalten: Beeren, Fleisch und Frauen. Je nachdem unterschiedlich priorisiert. --[[Benutzer:Deg00-m.website|ChristofT]] 23:31, 19. Jun. 2009 (UTC)

:::Sonst bin ich mit dir natürlich in allem einer Meinung und befürworte sehr die Bemühungen um Konsistenz und Verständlichkeit in der HS-Doku -- die mich seit Jahren häufig nervt. Ich freue mich riesig, daß die Doku jetzt auf Wiki umgestellt wurde, denn da werde ich (wie andere auch, nehme ich an) den Frust konstruktiv umsetzen können.
:::Meine Ideen über technische Redaktion sind nun mal von englischen Gepflogenheiten geprägt (ich durfte einmal für O'Reilly schreiben und verstand mich prächtig mit meinem Lektor) -- wir Englischsprachigen fragen uns häufig, wieso die Deutschen soviel Vorwissen oder Mitdenken oder Richtigraten seitens des Lesers, gerade in technischen Texten, voraussetzen können.
:::Nun ja. Was meinst du, ob ein paar Worte zu Fragen der Gliederung, Informationsumfang usw. in die Hilfeseiten für Wiki-Mitautoren hineingehören?--[[Benutzer:Apc00-tony|Apc00-tony]] 13:59, 19. Jun. 2009 (UTC)

:::: Danke und Danke! Es gibt ja schon die [[Hostsharing Wiki Konventionen | Konventionen]], das ist eventuell der bessere Platz für solche Dinge als [[Guter Stil]], keine Ahnung. Es gibt durchaus Handlungsbedarf, was die Verständlichkeit und den Schreibstil in der Dokumentation angeht, da gebe ich Dir vollkommen recht! Ich freue mich, dass ein neuer "Schreiberling" hier auftaucht und nicht ein weiterer "Techniker". Schreiben (in der Form, dass auch jemand den Hintergrund und das "Herz", das in HS steckt, in den Worten versteht) ist eine Sache, die nicht jedem gegeben ist, aber die "Techniker" bringen den Vorteil der Genauigkeit, der Stringenz und des Arbeitswillens. Wenn wir das in irgend einer Weise vereinen können, dann kann das Ding hier wirklich vollkommen geil werden. Aber ich denke, dass diese Diskussion hier nicht gut aufgehoben ist, sondern in der Mailingliste website@ geführt werden sollte. Ich habe das Gefühl, die Dokumentation fängt an zu "zerfleddern", vielleicht liege ich auch falsch. Wir müssen uns auf alle Fälle Gedanken über die Struktur machen, die alte Struktur funktioniert auf Dauer nicht. Wir müssen vom Überblick ausgehend ins Detail gehen. Im Moment wird der Leser mit Details erschlagen - ich denke, so habe ich Deine Kritik begriffen, oder? --[[Benutzer:Deg00-m.website|ChristofT]] 23:31, 19. Jun. 2009 (UTC)

Guter Stil

2012-04-23T12:39:09Z

Hsh00-purodha:

Eine gute Seite im HS-Wiki hat einen passenden Namen, der auf das Einfachste reduziert ist. Wenn andere Worte mit der gleichen Bedeutung (Synonyme) auf die gleiche Seite linken sollen, dann kann eine Weiterleitung angelegt werden.

Eine gute Seite enthält Fakten. Sie ist wenn möglich in der zweiten oder dritten Person geschrieben, damit andere leichter an der Seite weiterarbeiten können. In der ersten Person wird nur geschrieben, wenn über Erfahrungen berichtet wird, die sich nicht auf Fakten oder Ratschläge reduzieren lassen. Auf den Diskussionsseiten wird immer in der ersten Person geschrieben. Am Ende des eigenen Beitrages auf den Diskussionsseiten kann unterschrieben werden. Das Wichtigste steht da, wo es leicht zu lesen ist: am Anfang, nicht am Ende. Das Ändern der Seiten erfolgt so, dass der Fluß der Ideen herausgestrichen wird, nicht die zeitliche Aufeinanderfolge der Beiträge. Erst dann, wenn eine Seite zu groß und damit unübersichtlich wird, sollte sie mit Links in weitere Seiten aufgeteilt werden.

Das Wiki hat einfache TextFormatierungsRegeln. Jede Zeile beginnt ohne Leerzeichen und jeder Absatz endet mit einer leeren Zeile. Wörter in eckigen <nowiki>[[Klammern]]</nowiki> werden zu Links auf andere Seiten. Die richtigen Wörter für einen Link zu finden braucht Kreativität.

Kontrolliere das Ergebnis Deiner Eingaben mit der Vorschau, bevor Du die Seite endgültig speicherst.

[[Kategorie: Hilfe]]

Hostsharing Wiki Konventionen

2012-04-23T11:02:58Z

Hsh00-purodha: typo, + Link, Grammatik, Stil.

Praktisches über den Umgang mit dem HS Wiki und der Software Mediawiki.

== Allgemein - Klauen erwünscht!==

Das Wiki verändert sich mit dem zunehmenden Wissen seiner Benutzer. Daher kann man beim Neuanlegen einer Seite durchaus mal schauen, wie ist eine andere Seite (die gut und sinnvoll aussieht) aufgebaut. Am Besten lernt man, indem man den Quelltext guter Seiten oder Absätze studiert. Auch der eine oder andere Blick in die [[Hilfe]] ist zu Beginn sehr sinnvoll. Aber lasse dich nicht abschrecken. Ändern, Korrigieren, das Arbeiten, geht hier von der ersten Minute an. Also los, mach mit!

== Was soll ins Wiki ==
'''Nur die reine Dokumentation.'''

Also nicht: Aktuelles, Produkte, Preise, Hostsharing eG. von der [http://www.hostsharing.net www.hostsharing.net] Seite.

== Seiten anlegen ==
Das funktioniert dadurch, dass man auf einer vorhandenen Seite einen Link anlegt:

<nowiki>[[Link]]</nowiki>

Danach klickt man den Link und befindet sich auf der neuen, noch leeren Seite. Die kann man jetzt mit "Bearbeiten" mit Inhalten füllen.

== Anrede des Lesers ==

Siehe auch [[Guter Stil]] und die zugehörige Diskussion.

Solange keine völlig unpersönliche Sprache gewählt ist, wirst du als Leser in der zweiten Person mit "Du" angesprochen. Die erste Person "ich" wird gemieden, damit auch andere an dem Text weiter arbeiten können. Benötigen wir ausnahmsweise die erste Person, verwenden wir wir. :-)

==Namenskonvention==

Eine Verpflichtung zu bestimmten Namensformen gibt es erst mal keine. Suche Dir einfach einen passenden Namen aus. Seiten können verschoben oder unter anderem Namen aufgerufen werden. Alles lässt sich nachträglich ändern!

Seiten, die sich auf eine bestimmte Software beziehen, sollten so benannt werden, dass der Name der Seite mit dem Namen der Software beginnt. So taucht die Seite in den von MediaWiki automatisch erstellten Seitenlisten alphabetisch unter dem Namen der Software einsortiert auf und ist für Leser leichter aufzufinden. [[:Kategorie:Installationsanleitungen|Installationsanleitungen]] sollten "Xyz installieren" heißen, wenn die Software Xyz heißt, wenn es mehrere Versionen der Software gibt, sollte auch die Versionsnummer mit in den Seitentitel aufgenommen werden und insgesamt müssen Installationsanleitungen natürlich entsprechend kategorisiert werden.

Seiten, die einen sehr allgemeinen Titel tragen und grundsätzliche Erklärungen beinhalten ([[Hive]]) verdienen es vielleicht, ins [[:Kategorie:Glossar|Glossar]] übernommen zu werden:

<pre><nowiki>
[[Kategorie:Glossar]]
</nowiki></pre>

== Kategorisieren ==

Praktisch jede Seite sollte kategorisiert werden. Das geschieht am Ende der Seite durch einen speziellen Link mit dem Namensraum "Kategorie":

<pre><nowiki>
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Plone]]
</nowiki></pre>

Alle Seiten, die die Dokumentation betreffen, werden grundsätzlich der Kategorie "HSDoku" zugeteilt.

== Weiterleitungen und Synonyme ==

'''Weiterleitungen'''

Es kommt ab und zu vor, dass man im Text etwas erwähnen möchte, das an anderer Stelle schon beschrieben ist, aber der Name des Links passt einfach nicht. So lange es sich um eine andere Wortform handelt, bietet sich die Einrichtung einer Weiterleitung an.

Dass [[Hive]] und [[Hives]] auf die gleiche Seite zeigen, ist das Ergebnis einer Weiterleitung. Die originale Seite trägt den Namen "Hive", damit der Link [[Hives]] auf die gleiche Seite zeigt, bedient er sich eines Redirects. Wenn man einen solchen Link anlegt, zeigt er zuerst einmal auf die neue Seite "Hives". Dort kann man folgendes eintragen:

<pre><nowiki>
#REDIRECT [[Hive]]
</nowiki></pre>

Damit wird [[Hives]] auf [[Hive]] ungelenkt.

'''Synonyme'''

Ein Synonym hingegen, das nicht allgemein, sondern nur speziell in dem aktuell bearbeiteten Text vorkommen soll, kann durch Umbenennung innerhalb des Links erreicht werden. Hier linkt [[User|Einrichten eines Benutzers]] in Wirklichkeit auf [[User]]:

<pre><nowiki>
Hier linkt [[User|Einrichten eines Benutzers]] in Wirklichkeit auf [[User]]:
</nowiki></pre>

== Weiterführende Links ==

Ist ein Thema zu umfangreich, um es auf einer Seite abzuhandeln, erhält die Hauptseite einen Absatz '''Weiterführende Links'''. Hier werden die direkt darunter liegenden Seiten verlinkt.

Für die Seite [[Pakete]] zum Beispiel sieht das so aus:

<pre><nowiki>

== Weiterführende Links ==
* [[Dynamic-Web]]<br>
* [[Static-Web]]

</nowiki></pre>

Im Beispiel muss natürlich auch in der Seite [[Dynamic-Web-Pakete]] ein entsprechender Absatz abgelegt werden, da sie ebanfalls auf "tiefer" liegende Seiten verweist.

Es bleibt dem Autor überlassen, ob der Absatz "Weiterführende Links" ganz oben oder ganz unten in der Seite angelegt wird, nur irgendwo in der Mitte hat er naturgemäß wenig Sinn. "Ganz oben" hat auf allen Seiten Sinn, die so lang sind, dass er sonst nicht gleich am Bildschirm auftaucht.

== Löschen und Ersetzen von Seiten ==

=== Löschen ===

Seiten werden nur in sehr begründeten Ausnahmefällen gelöscht, z.B. Spam, Seiten, deren Funktion einen temporären Charakter hatte und die durch Änderungen überflüssig geworden sind oder Seiten, die nicht mit sinnvollen Inhalten gefüllt werden (können). Löschen kann diese Seiten nur ein Administrator im Wiki. Daher wird eine solche Seite als Löschkandidat markiert, indem die entsprechende [[Vorlage:Löschkandidat]] an den Anfang gestellt (und der Grund für den Löschvorschlag in der zugehörigen Diskussionsseite festgehalten) wird:

<pre><nowiki>
{{Löschkandidat}}
</nowiki></pre>

'''Es ist immer vorher zu prüfen, ob die Seite nicht ersetzt werden kann.''' Das gilt insbesondere dann, wenn davon auszugehen ist, dass Links auf diese Seite zeigen, ob von innerhalb des Wikis oder von außen.

=== Ersetzen ===

Meist werden Seiten ersetzt, Zum Beispiel dann, wenn die auf der ursprünglichen Seite beschriebene Methode veraltet ist. Da aber immer noch Links auf die urprüngliche Seite zeigen können, löschen wir den Inhalt und verwenden als Seiteninhalt '''einzig und allein''' die [[Vorlage:Ersetzt]], um mit ihrer Hilfe einen Link auf die neue Seite zu setzen und eine Begründung anzugeben. Dadurch wird gleichzeitig die ursprüngliche Seite aus allen Kategorien entfernt, außer [[:Kategorie:Veraltet]].

== Anmerkungen und Diskussionen ==

Jede Seite hat zusätzlich einen Bereich für die Diskussion. Ist der Inhalt der Seite fehlerhaft, falsch oder einfach diskussionswürdig, schreibt man das entsprechend da hinein. Man kann auch Diskussionen in seine [[Special:Watchlist|Beobachtungsliste]] aufnehmen und wird dann bei Änderungen/Antworten durch Andere benachrichtigt.

Es wird leicht übersehen, neben dem Link "Bearbeiten" gibt es ein kleines "+", das einem die Antwort erleichtert, man kann sogar einen Betreff eingeben, der als Überschrift erscheint.

== Seiten mit fehlerhaften oder falschen Inhalten ==

Ist man nicht in der Lage, zum Beispiel aufgrund fehlenden Fachwissens, die Seite zu korrigieren, beschreibt man den Fehler in der Diskussionsseite und kategorisiert die Seite als "Baustelle" durch die [[Vorlage:Baustelle]]:

<pre><nowiki>
{{Baustelle}}
</nowiki></pre>

----
[[Kategorie:Hilfe]] [[Kategorie:Hostsharing Wiki]]

Autorenportal

2012-04-23T10:53:20Z

Hsh00-purodha: /* Erste Schritte */

Das Hostsharing-Wiki ist ein gemeinsames Projekt der Hostsharing-Mitglieder, in dem wir die Dokumentation der Dienste von Hostsharing überarbeiten und auf den aktuellen Stand bringen möchten. Auf dieser Seite findest du Informationen dazu, wie du dich daran beteiligen kannst.

== Erste Schritte ==

'''Anmelden'''

Das Wiki verwendet den Single-Sign-On-Dienst von Hostsharing, sodass Du Dich im Wiki mit jedem gültigen [[User]] (Benutzernamen) eines Servers von Hostsharing anmelden kannst. Du kannst Dir natürlich für die Nutzung des Wikis einen eigenen [[User]] in einem Deiner Pakete anlegen, zum Beispiel xyz00-wiki oder xyz00-hsdoku.

'''Benutzereinstellungen'''

Nachdem du dich im Wiki angemeldet hast, ist es sinnvoll, wenn du zunächst deine Benutzereinstellungen anpasst (der Link [[Spezial:Einstellungen | Einstellungen]] - nur sichtbar, wenn Du angemeldet bist). Mindestens deine E-Mail-Adresse solltest du eintragen, denn dann kannst du Seiten im Wiki beobachten und Nachrichten bekommen, wenn eine von dir beobachtete Seite geändert wurde.

Du solltest dich außerdem auf der Hostsharing-Mailingliste (nicht öffentliche Liste) [https://lists.hostsharing.net/mailman/listinfo/website/ website@hostsharing.net] anmelden. Dort diskutieren wir über die Weiterentwicklung der Dokumentation.

== Wo ist Arbeit nötig? ==

<div style="margin-left:2em;font-style:italic">Die wichtigsten Links: [[:Kategorie:Baustelle|Baustelle]]n, [[Hostsharing_Wiki:Wunschliste Installationsanleitungen|Wunschliste Installationsanleitungen]]</div>

Ganz konkret kannst du zum Beispiel schauen, welche Seiten hier im Wiki als [[:Kategorie:Baustelle|Baustelle]] gekennzeichnet sind und diese überarbeiten. Oder du erstellst eine ganz neue Dokumentation zu einem Thema.

Natürlich kannst du auch als Benutzer die Dokumentation lesen und in der Diskussion der entsprechenden Seite darauf hinweisen, wo aus deiner Sicht Verbesserungen notwendig sind. Um eine Seite als Baustelle zu kennzeichnen, trage einfach folgendes ganz am Anfang der Seite ein:

<nowiki>{{Baustelle}}</nowiki>

Am Anfang der Seite erscheint dann ein entsprechender Hinweis und die Seite wird in die [[:Kategorie:Baustelle|Liste der Baustellen]] aufgenommen.

== Konventionen ==

Wenn du an der Dokumentation arbeitest, solltest du unsere [[Hilfe:Hostsharing_Wiki_Konventionen|Konventionen]] und [[Hilfe:Guter_Stil|Hinweise zu gutem Stil]] beachten.

== Umgang mit der Wiki-Software ==

Wir verwenden als Software [http://www.mediawiki.org/ MediaWiki]. Nachfolgend einige Links auf Hinweise dazu, wie du im Wiki Texte formatierst und Links anlegst. Gefahrlos ausprobieren kannst du die Wiki-Funktionen auf der Seite [[Sandkasten]], diese ist explizit zum Experimentieren gedacht.

* [[Hilfe:Textgestaltung|Textformatierung im Wiki]]
* [[Hilfe:Link|Links anlegen]]

----
[[Kategorie:Hilfe]]
[[Kategorie:Hostsharing Wiki]]

Zonefile

2012-04-23T10:47:57Z

Hsh00-purodha:

Im Normalfall wird für eine bei Hostsharing liegende Domain (in diesem Beispiel <code lang="en" xml:lang="en">example.com</code> die Konfiguration der {{lang|en|[[Nameserver]]}} automatisch erledigt. Die zugehörige Konfigurationsdatei wird englisch {{lang|en|[[zonefile]]}} oder auf Deutsch Zonendatei genannt. Man findet sie als Textdatei <code lang="en" xml:lang="en">/etc/bind/pri.example.com</code> auf dem Server.

== Eigene Zonendateien ==
Die Konfiguration kann man anpassen durch das Anlegen oder Ändern eines [[Verwalten_der_Zonendaten|eigenen {{lang|en|zonefile}}]]. Diese Textdatei findet man als <code lang="en" xml:lang="en">/home/doms/example.com/etc/pri.example.com</code> auf dem Server. In dieser Datei kann man diverse Platzhalter verwenden, die erlauben, Dinge automatisch erledigen zu lassen. Da individuelle Zonendateien über ein automatisch ablaufendes Programm nur auf Anforderung ins System übernommen werden, kann man aus dem Vorhandensein oder Fehlen dieser Datei keine Schlüsse ziehen, ob sie bereits übernommen wurde oder womöglich nach dem Übernehmen gelöscht wurde,

== Fehler beim Übernehmen ==
Eine eigene Zonendatei kann fehlerhaft sein und beim Übernehemn kann theoretisch auch etwas schief laufen. Dann wird möglichwerweise eine fehlerhafte Datei <code lang="en" xml:lang="en">/etc/bind/pri.example.com</code> erzeugt und mit einer kleinen Zeitverzögerung den {{lang|en|Nameserver}}n angeboten. Solange das der Fall ist, findet man die entsprechenden Fehlermeldungen der der Textdatei <code lang="en" xml:lang="en">/var/log/named/named.log</code> und nach einer erfolgreichen Übernahme eine Erfolgsmeldung. Keine Meldung nach einer Änderung deutet darauf hin, daß (noch) nichts übernommen wurde.

== Standard-Zonendatei ==
Auch die Standard-{{lang|en|zonefile}} wird über Platzhalter generiert. In ihrer allgemeinen Form, also mit Platzhaltern, findet man sie ''wo?'' auf dem Server.

== Standard-Zonendatei herstellen lassen ==
Wer die Standardkonfiguration für die eigene Domain wieder herstellen möchte, leert das vorhandene {{lang|en|zonefile}} <code lang="en" xml:lang="en">/etc/bind/pri.example.com</code> komplett. Es muß danach 0 Byte groß sein. Dann läßt man die Datei ins System übernehmen, wobei sie automatisch gelöscht wird.

== Siehe auch ==
[[Verwalten der Zonendaten]]


[[Kategorie:HSDoku]]
[[Kategorie:Zonefile]]
[[Kategorie:Domains]]

Verwalten der Zonendaten

2012-04-23T10:45:01Z

Hsh00-purodha: /* Aktives Zonefile */

{{HSDoku-Links}}

Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service ([[DNS]]), d.h. der [[Nameserver]] der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen. Für einfache und unkomplizierte Änderungen bitte in [[Simple Zonefile Howto]] schauen.

{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}

== Aktives Zonefile ==

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden ([[Zonefile]]).

Im Standardfall sieht es vollständig expandiert wie folgt aus:

<pre><nowiki>
$TTL 6H
example.com. IN SOA h00.hostsharing.net. hostmaster.hostsharing.net. (
1303649373 ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

example.com. IN NS dns1.hostsharing.net.
example.com. IN NS dns2.hostsharing.net.
example.com. IN NS dns3.hostsharing.net.

example.com. IN MX 30 mailin1.hostsharing.net.
example.com. IN MX 30 mailin2.hostsharing.net.
example.com. IN MX 30 mailin3.hostsharing.net.

example.com. IN A 83.223.95.160

*.example.com. IN MX 30 mailin1.hostsharing.net.
*.example.com. IN MX 30 mailin2.hostsharing.net.
*.example.com. IN MX 30 mailin3.hostsharing.net.

*.example.com. IN A 83.223.95.160
</nowiki></pre>

== Logfile und Kontrolle==

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN':
AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN':
AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

<code>
-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100

Moin Moin,

aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.

Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!

Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:

tail -f /var/log/named/named.log

oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:

tail -f /var/log/named/named.log | grep example.com

Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.

Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:

dig -t SOA @dns1 example.com | grep '^example.com.*SOA' | awk '{ print $7 }'

grep serial /etc/bind/pri.example.com | awk '{ print $1 }'
</code>

== Eigenes Zonenfile ==

Wer ein eigenes Zonefile installieren möchte, um diverse Anwendungsfälle zu realisieren (Verweise auf extern gelagerte Subdomains, Anbindung externer Server, Verwendung eigener Mailserver), kann '''pro Domain''' ein eigenes Zonefile erstellen. Dieses befindet sich im Verzeichnis '''~/doms/example.com/etc''' mit den Namen '''pri.example.com''' (example.com steht hier als Beispiel für den wahren Domainnamen). Ein Neuanlegen oder eine Änderung dieser Datei führt zu einer baldigen Änderung der Nameservereinträge für die Domain.

{{Textkasten|rot|Warnung!|Das nicht sachgemäße Erstellen eines eigenen Zonefiles kann zur Nichterreichbarkeit der eigenen Domain und zum Verlust von Mails führen!}}

Eine Anleitung für die eher einfachen und oft gewünschten Änderungen findet sich in [[Simple Zonefile Howto]].

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern der DNS-Konfiguration, ohne dass der Domain-Admin sein Zonefile anpassen muss.

=== Komplexe Platzhalter ===

<pre>
{DEFAULT_ZONEFILE} :=
{HEADER}
{SOA_RR}
{NS_RR}
{MX_RR}
{A_RR}
{WILDCARD_MX_RR}
{WILDCARD_A_RR}

{HEADER} :=
$TTL {TTL}

{SOA_RR} :=
{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
{SIO} ; serial secs since Jan 1 1970
{REFRESH} ; refresh (>=10000)
{RETRY} ; retry (>=1800)
{EXPIRE} ; expire
{MINIMUM} ; minimum
)

{NS_RR} :=
{DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.

{MX_RR} :=
{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

{A_RR} :=
{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}

{WILDCARD_MX_RR} :=
*.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

{WILDCARD_A_RR} :=
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

=== Atomare Platzhalter ===

<pre>
{TTL} := 6H
{SOA_HOSTNAME} := <HIVE>.hostsharing.net
{SOA_EMAIL}:= hostmaster.hostsharing.net
{SIO} := <SEKUNDEN>
{REFRESH} := 6H
{RETRY} := 1H
{EXPIRE} := 1W
{MINIMUM} := 1H

{DNS1_HOSTNAME} := dns1.hostsharing.net
{DNS2_HOSTNAME} := dns2.hostsharing.net
{DNS3_HOSTNAME} := dns3.hostsharing.net

{MX1_HOSTNAME} := mailin1.hostsharing.net
{MX2_HOSTNAME} := mailin2.hostsharing.net
{MX3_HOSTNAME} := mailin3.hostsharing.net

{DOM_HOSTNAME} := <FQDN>
{DOM_IPNUMBER} := <IP>
</pre>

Hierbei stehen
* <Sekunden> für die Anzahl der Sekunden, welche seit dem 01.01.9170 vergangen sind
* <FQDN> für den vollständigen, qualifizierten Domainnamen der Domain
* <IP> für die der Domain zugewiesene IP-Adresse

Diese Werte werden von Hostsharing verwaltet.

=== Expansion der Platzhalter ===

Der Platzhalter für das Gesamtzonefile {DEFAULT_ZONFILE} wird folgermaßen expandiert.

Zunächst werden die komplexen Platzhalter ersetzt:

<pre>
{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
{SIO} ; serial secs since Jan 1 1970
{REFRESH} ; refresh (>=10000)
{RETRY} ; retry (>=1800)
{EXPIRE} ; expire
{MINIMUM} ; minimum
)

{DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.

{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}

*.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

Anschließend werden die atomaren Platzhalter ersetzt:

<pre>
$TTL 6H

<FQDN>. IN SOA <HIVE>.hostsharing.net. hostmaster.hostsharing.net. (
<SEKUNDEN> ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

<FQDN>. IN NS dns1.hostsharing.net.
<FQDN>. IN NS dns2.hostsharing.net.
<FQDN>. IN NS dns3.hostsharing.net.

<FQDN>. IN MX 30 mail1.hostsharing.net.
<FQDN>. IN MX 30 mail2.hostsharing.net.
<FQDN>. IN MX 30 mail3.hostsharing.net.

<FQDN>. IN A <IP>

*.<FQDN>. IN MX 30 mail1.hostsharing.net.
*.<FQDN>. IN MX 30 mail2.hostsharing.net.
*.<FQDN>. IN MX 30 mail3.hostsharing.net.

*.<FQDN>. IN A <IP>
</pre>

== Das Zonefile deaktivieren/zurücksetzen ==

In ~/doms/example.com/etc das vorhandene Zonefile (pri.example.com) komplett leeren (ist dann 0 Bytes groß). Dann kommt der Robot vorbei, löscht pri.example.com und setzt alles auf Standardwerte zurück.

----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Zonefile]]
[[Kategorie:ToDo-Kerndoku]]

Zonefile

2012-04-23T10:42:03Z

Hsh00-purodha: Die Seite wurde neu angelegt: „Im Normalfall wird für eine bei Hostsharing liegende Domain (in diesem Beispiel <code lang="en" xml:lang="en">example.com</code> die Konfiguration der {{lang|…“

Zonendatei

2012-04-23T10:34:25Z

Hsh00-purodha: Weiterleitung auf Zonefile erstellt

#redirect[[Zonefile]]

Hostsharing Wiki Diskussion:Urheberrechte

2012-04-23T09:43:18Z

Hsh00-purodha: Die Seite wurde neu angelegt: „Es könnte rechtlich problematisch sein, hier mitzumachen, solange nicht feststeht, unter welcher oder welchen Lizenzen man veröffentlicht, was man hier einst…“

Es könnte rechtlich problematisch sein, hier mitzumachen, solange nicht feststeht, unter welcher oder welchen Lizenzen man veröffentlicht, was man hier einstellt. Im Warntext beim Hochladen eigener Beiträge ist ein Link auf eine fehlende Seite ein grobes Versäumnis beim Installieren des Wikis. --[[Benutzer:Hsh00-purodha|Hsh00-purodha]] 11:43, 23. Apr. 2012 (CEST)