Vorlage:RFC-Internet/Doku

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen
Link auf ein Dokument der Request for Comments (RFC) für das Internet

Vorlagenparameter

RFC-CodeRFC
Ziffernfolge der Request for Comments ohne RFC, maximal vier Ziffern
Beispiel
2324
AutorAutor
Namen der Autoren (bzw. oft eher Herausgeber); Komma-separierte Liste
Beispiel
L. Masinter
TitelTitel
Titel des Dokuments. Mit - kann hinterlegt werden, dass absichtlich kein RFC-Titel dargestellt werden soll, etwa bei wiederholtem Verweis auf einzelne Abschnitte.
Beispiel
Host Software
Abschnitts­nummerAbschnitt
Ziffernfolge, die den genauen Abschnitt definiert (ohne den hinteren Punkt); nicht zugleich mit dem Parameter Seite verwenden
Beispiel
2.1.3
Anhangs­nummerAnhang
Ziffernfolge, die den genauen Abschnitt im Anhang definiert (ohne den hinteren Punkt); nicht zugleich mit dem Parameter Seite verwenden
Beispiel
B.4
Abschnitts­titelAbschnittstitel
Ausgeschriebener Titel des Abschnitts (nur zusammen mit der Nummer Abschnitt oder Anhang , auch in einem Anhang
Beispiel
PROPFIND method
DatumDatum
Publikationsdatum im ISO-Format JJJJ-MM-TT
Beispiel
2024-04-06
SeiteSeite
Link auf eine Seite (nur einzelne Seite, keine Seitenbereiche und nicht zugleich mit dem Parameter Abschnitt verwenden)
Beispiel
3
StandardStandard
Einstufung als STD oder BCP (best current practice)
ErsetztObsoletes
Ziffernfolge einer RFC, die zuletzt durch diese Version ersetzt wurde; noch frühere im Kommentar
Beispiel
1234
AktualisierungUpdated
Ziffernfolge einer RFC, durch die diese Version unmittelbar aktualisiert wurde; spätere im Kommentar
Beispiel
7168
FehlerberichtErrata
Fehlerbericht existiert
Standard
0
Beispiel
1
AnmerkungKommentar
Kurze Anmerkung oder Zitat

Hinweis[Quelltext bearbeiten]

Perspektivisch wird die automatische Verlinkung als „Magisches Wort“ nicht mehr erfolgen.

  • Das Feature stammt aus den Anfangsjahren der Wikis. Es macht das effiziente Parsen von Wikitext jedoch unmöglich, weil nicht erst durch ein Sonderzeichen wie < oder { oder [ eine Analyse ausgelöst werden braucht, sondern aller Text auch auf R oder P oder I untersucht und dann die vorangehenden und folgenden Zeichen weiter analysiert werden müssen.
  • RFC 1925 wird eines Tages als ganz normaler Text (unverlinkt) erscheinen.

Im Fließtext von Artikeln sollte verwendet werden:

… wird in <nowiki>RFC&nbsp;1925</nowiki><ref>{{RFC-Internet |RFC=1925}}</ref> sowie in <nowiki>RFC&nbsp;
  • &nbsp; verhindert nicht die Erkennung als Magisches Wort, vermeidet jedoch eine Auffindung abgearbeiteter Fälle bei globaler Textsuche. Dass nebenbei der Zeilenumbruch verhindert wird, ist ein angenehmer Zusatznutzen.
  • <nowiki>RFC …</nowiki> ist temporär bis zum Abschluss der Migration erforderlich, um Irritationen durch doppelte Verlinkungen zu vermeiden.

Bei Aufzählungen wie etwa im Abschnitt „Weblinks“ kann ganz normal eine Internetquelle mittels dieser Vorlage zitiert werden.

  • Natürlich können überall aufschlussreiche Parameterwerte wie der Titel oder das Erscheinungsjahr beigegeben werden.

Kopiervorlagen[Quelltext bearbeiten]

Pflichtangabe

{{RFC-Internet |RFC=}}

mit Titel und Datum

{{RFC-Internet |RFC= |Titel= |Datum=}}

Seitenlink

{{RFC-Internet |Autor= |RFC= |Titel= |Datum= |Seite= |Standard= |Updated= |Obsoletes= |Kommentar=}}

Abschnittslink

{{RFC-Internet |Autor= |RFC= |Titel= |Datum= |Abschnitt= |Abschnittstitel= |Standard= |Updated= |Obsoletes= |Kommentar=}}

Verlinkung der Ressource[Quelltext bearbeiten]

Die Verlinkung erfolgt über „Pseudo-Interwiki“ [[rfc:]] und nicht über eine bestimmte Website.

  • Die aktuelle Website wird von MediaWiki global gepflegt.
  • Damit weisen auch alle Wikis, die sich dieser Methodik anschließen, eine einheitliche Präsentation der Dokumente auf.
  • Die Vorlage selbst hat keine Kenntnis davon, welche Website dies momentan ist.

Im Lauf der Jahrzehnte gab es unterschiedliche Domains, die teils offiziell, teils vertrauenswürdig spiegelnd die Ressourcen bereitstellten. Zunächst waren das TXT-Dateien über FTP-Server, später kamen inoffiziell HTML-Aufbereitungen hinzu, auch mit einem eingefügten Inhaltsverzeichnis und Sprungzielen. Bekannt wurden:

  • ietf.org (offiziell)
  • rfc-editor.org (offiziell)
  • doi:10.17487/RFC1 (offiziell)
  • w3.org (offiziös/befreundet)
  • faqs.org
  • sunsite.auc.dk
  • hunter.com
  • curl.haxx.se

Entscheidend ist lediglich, dass eine glaubwürdige Website verlinkt wird.

Wartung[Quelltext bearbeiten]

Fehlerhafte Einbindungen werden aufgelistet in der Kategorie:Wikipedia:Vorlagenfehler/Vorlage:RFC-Internet – aktuell keine     (6. April 2024 09:39) Aktualisieren