„Vorlage:Autoarchiv/Doku“ – Versionsunterschied

[ungesichtete Version][ungesichtete Version]
Inhalt gelöscht Inhalt hinzugefügt
K syntax
+ Mindestabschnitte, siehe Benutzer:ArchivBot/Bugs#2 Fragen: Parameter & Log; eigenen Absatz für optionale Parameter
Zeile 34:Zeile 34:
** <code><nowiki>((Woche:##))</nowiki></code>: zweistelliges Woche, z. B. <tt>01</tt>, <tt>43</tt>
** <code><nowiki>((Woche:##))</nowiki></code>: zweistelliges Woche, z. B. <tt>01</tt>, <tt>43</tt>
** <code><nowiki>((Jahr))</nowiki></code>: Jahr, z. B. <tt>2006</tt>, <tt>2007</tt>
** <code><nowiki>((Jahr))</nowiki></code>: Jahr, z. B. <tt>2006</tt>, <tt>2007</tt>

=== Beispiele ===
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=1|Ziel='Wikipedia:Auskunft/Archiv'}}</code>
: archiviert alle Abschnitte, deren letzter Beitrag mindestens ein Tag zurückliegt, nacheinander unter
:* <tt>[[Wikipedia:Auskunft/Archiv]]</tt>
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=7|Ziel='Benutzer Diskussion:Sebmol/Archiv/((Jahr))/((Monat:Kurz))'}}</code>: archiviert alle Abschnitte, deren letzter Beitrag mindestens sieben Tage zurückliegt, auf Unterseiten nach dem Muster
:* [[Benutzer Diskussion:Sebmol/Archiv/{{LOCALYEAR}}/{{LOCALMONTHABBREV}}|<tt>Benutzer Diskussion:Sebmol/Archiv/{{LOCALYEAR}}/{{LOCALMONTHABBREV}}]]</tt>
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=2|Ziel='Wikipedia:Fragen zur Wikipedia/Archiv/((Jahr))/Woche ((Woche:##))'}}</code>
: archiviert alle Abschnitte, deren letzter Beitrag mindestens zwei Tage zurückliegt, auf Unterseiten nach dem Muster
:* <tt>[[Wikipedia:Fragen zur Wikipedia/Archiv/{{LOCALYEAR}}/Woche {{#ifexpr:{{LOCALWEEK}}<10|0|}}{{LOCALWEEK}}|Wikipedia:Fragen zur Wikipedia/Archiv/{{LOCALYEAR}}/Woche {{#ifexpr:{{LOCALWEEK}}<10|0|}}{{LOCALWEEK}}]]</tt>

=== Weitere Möglichkeiten ===
Mit den folgenden optionalen Parametern ist die Darstellung und das Verhalten der automatischen Archivierung individuell einstellbar:
* '''Übersicht''': Anzeige des Links der Archivübersichtsseite im eingebundenen Baustein.
* '''Übersicht''': Anzeige des Links der Archivübersichtsseite im eingebundenen Baustein.
**'''Beispiel''': Übersicht=<nowiki>[[Wikipedia:Fragen zur Wikipedia/Archiv]]</nowiki>
**'''Beispiel''': Übersicht=<nowiki>[[Wikipedia:Fragen zur Wikipedia/Archiv]]</nowiki>
Zeile 40:Zeile 53:
* '''Mindestbeiträge''': Die Anzahl der Beiträge, die ein Abschnitt haben muss, bevor er archiviert wird. Damit können zum Beispiel alle nicht-beantworteten Beiträge von der Archivierung ausgeschlossen werden (Standardwert: 2).
* '''Mindestbeiträge''': Die Anzahl der Beiträge, die ein Abschnitt haben muss, bevor er archiviert wird. Damit können zum Beispiel alle nicht-beantworteten Beiträge von der Archivierung ausgeschlossen werden (Standardwert: 2).
* '''Zeigen''': Wird dieser Parameter auf 'Nein' gesetzt, dann wird der Autoarchiv-Hinweis nicht dargestellt. Diese Option ist sinnvoll, wenn der Aufbau der Vorlage beispielsweise das optische Design der zu archivierenden Seite stört (Standardwert: Ja).
* '''Zeigen''': Wird dieser Parameter auf 'Nein' gesetzt, dann wird der Autoarchiv-Hinweis nicht dargestellt. Diese Option ist sinnvoll, wenn der Aufbau der Vorlage beispielsweise das optische Design der zu archivierenden Seite stört (Standardwert: Ja).
* '''Mindestabschnitte''': Legt fest, wie viele Abschnitte auf einer Seite nach einer Archivierung noch erhalten bleiben müssen (Standardwert: 0).
* '''Frequenz''': Mit diesem Parameter kann festgelegt werden, wie oft der Bot auf der Seite aufräumen soll (Standardwert: ständig). Mögliche Werte sind:
* '''Frequenz''': Mit diesem Parameter kann festgelegt werden, wie oft der Bot auf der Seite aufräumen soll (Standardwert: ständig). Mögliche Werte sind:
** <code><nowiki>ständig</nowiki></code>: die Seite wird bei jedem Botlauf ausgewertet
** <code><nowiki>ständig</nowiki></code>: die Seite wird bei jedem Botlauf ausgewertet
Zeile 48:Zeile 62:
** <code><nowiki>halbjährlich</nowiki></code>: 1. Januar und 1. Juli
** <code><nowiki>halbjährlich</nowiki></code>: 1. Januar und 1. Juli
** <code><nowiki>jährlich</nowiki></code>: 1. Januar
** <code><nowiki>jährlich</nowiki></code>: 1. Januar

=== Beispiele ===
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=1|Ziel='Wikipedia:Auskunft/Archiv'}}</code>
: archiviert alle Abschnitte, deren letzter Beitrag mindestens ein Tag zurückliegt, nacheinander unter
:* <tt>[[Wikipedia:Auskunft/Archiv]]</tt>
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=7|Ziel='Benutzer Diskussion:Sebmol/Archiv/((Jahr))/((Monat:Kurz))'}}</code>: archiviert alle Abschnitte, deren letzter Beitrag mindestens sieben Tage zurückliegt, auf Unterseiten nach dem Muster
:* [[Benutzer Diskussion:Sebmol/Archiv/{{LOCALYEAR}}/{{LOCALMONTHABBREV}}|<tt>Benutzer Diskussion:Sebmol/Archiv/{{LOCALYEAR}}/{{LOCALMONTHABBREV}}]]</tt>
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=2|Ziel='Wikipedia:Fragen zur Wikipedia/Archiv/((Jahr))/Woche ((Woche:##))'}}</code>
: archiviert alle Abschnitte, deren letzter Beitrag mindestens zwei Tage zurückliegt, auf Unterseiten nach dem Muster
:* <tt>[[Wikipedia:Fragen zur Wikipedia/Archiv/{{LOCALYEAR}}/Woche {{#ifexpr:{{LOCALWEEK}}<10|0|}}{{LOCALWEEK}}|Wikipedia:Fragen zur Wikipedia/Archiv/{{LOCALYEAR}}/Woche {{#ifexpr:{{LOCALWEEK}}<10|0|}}{{LOCALWEEK}}]]</tt>


=== (Unter-)Abschnitte zusammenhalten ===
=== (Unter-)Abschnitte zusammenhalten ===

Version vom 19. November 2007, 00:13 Uhr

Benutzung

Diese Vorlage markiert eine Diskussionsseite zur automatischen Archivierung. Sie muss am Anfang der Seite eingebunden werden, möglichst vor dem ersten Absatz. Dabei müssen die folgenden Parameter angegeben werden:

  • Alter: die Anzahl der Tage gezählt vom letzten Beitrag, nachdem ein Abschnitt archiviert werden soll:
    • Für Artikel-Diskussionsseiten sind allgemein 30 Tage ein guter Wert, bei sehr aktiven Diskussionen 14, und in sehr ruhigen Diskussionen 60 und eventuell auch mehr. Bei gesperrten Artikeln kann eine „Deaktivierung“ mit beispielsweise 999 sinnvoll sein, bis der Artikel wieder entsperrt ist.
    • Die Größe von den Archivseiten kann über „ Seite bearbeiten “ und „ Vorschau zeigen “ überprüft werden (ab 32 kB), wobei Größen zwischen 32 und 250 KiloByte am praktischsten sein dürften.
    • Siehe auch „Wikipedia:Diskussionsseiten#Diskussionsseiten aufräumen“.
  • Ziel: Die Seite, auf der die Abschnitte archiviert werden sollen. Dabei können die folgenden zeitabhängige Parameter beliebig kombiniert werden: (alle Zeitangaben beziehen sich auf das Datum des ersten Eintrags unter dem jeweiligen Abschnitt):
    • ((Tag)): Tag, z. B. 1, 24
    • ((Tag:##)): zweistelliger Tag, z. B. 01, 24
    • ((Tag:kurz)): abgekürzter Tagesname (kleingeschrieben), z. B. mo, fr
    • ((Tag:Kurz)): abgekürzter Tagesname, z. B. Mo, Fr
    • ((Tag:KURZ)): abgekürzter Tagesname (großgeschrieben), z. B. MO, FR
    • ((Tag:lang)): Tagesname (kleingeschrieben), z. B. montag, freitag
    • ((Tag:Lang)): Tagesname, z. B. Montag, Freitag
    • ((Tag:LANG)): Tagesname (großgeschrieben), z. B. MONTAG, FREITAG
    • ((Monat)): Monat, z. B. 1, 10
    • ((Monat:##)): zweistelliger Monat, z. B. 01, 10
    • ((Monat:kurz)): abgekürzter Monatsname (kleingeschrieben), z. B. jan, okt
    • ((Monat:Kurz)): abgekürzter Monatsname, z. B. Jan, Okt
    • ((Monat:KURZ)): abgekürzter Monatsname (großgeschrieben), z. B. JAN, OKT
    • ((Monat:lang)): Monatsname (kleingeschrieben), z. B. januar, oktober
    • ((Monat:Lang)): Monatsname, z. B. Januar, Oktober
    • ((Monat:LANG)): Monatsname (großgeschrieben), z. B. JANUAR, OKTOBER
    • ((Quartal)): Quartal, z. B. 1, 3
    • ((Quartal:##)): zweistelliges Quartal, z. B. 01, 03
    • ((Quartal:i)): Quartal (kleine römische Ziffern), z. B. i, iv
    • ((Quartal:I)): Quartal (große römische Ziffern), z. B. I, IV
    • ((Halbjahr)): Halbjahr, z. B. 1, 2
    • ((Halbjahr:##)): zweistelliges Halbjahr, z. B. 01, 02
    • ((Halbjahr:i)): Halbjahr (kleine römische Ziffern), z. B. i, ii
    • ((Halbjahr:I)): Halbjahr (große römische Ziffern), z. B. I, II
    • ((Woche)): Woche, z. B. 1, 43
    • ((Woche:##)): zweistelliges Woche, z. B. 01, 43
    • ((Jahr)): Jahr, z. B. 2006, 2007

Beispiele

{{Autoarchiv|Alter=1|Ziel='Wikipedia:Auskunft/Archiv'}}
archiviert alle Abschnitte, deren letzter Beitrag mindestens ein Tag zurückliegt, nacheinander unter
{{Autoarchiv|Alter=7|Ziel='Benutzer Diskussion:Sebmol/Archiv/((Jahr))/((Monat:Kurz))'}}
archiviert alle Abschnitte, deren letzter Beitrag mindestens sieben Tage zurückliegt, auf Unterseiten nach dem Muster
{{Autoarchiv|Alter=2|Ziel='Wikipedia:Fragen zur Wikipedia/Archiv/((Jahr))/Woche ((Woche:##))'}}
archiviert alle Abschnitte, deren letzter Beitrag mindestens zwei Tage zurückliegt, auf Unterseiten nach dem Muster

Weitere Möglichkeiten

Mit den folgenden optionalen Parametern ist die Darstellung und das Verhalten der automatischen Archivierung individuell einstellbar:

  • Übersicht: Anzeige des Links der Archivübersichtsseite im eingebundenen Baustein.
    • Beispiel: Übersicht=[[Wikipedia:Fragen zur Wikipedia/Archiv]]
  • Klein: Wird dieser Parameter auf 'Ja' gesetzt, werden Archivierungen als kleine Bearbeitungen markiert. Bei Benutzerdiskussionsseiten führt das dazu, dass bei der Archivierung keine Nachricht (die sogenannten Kackbalken am oberen Bildschirmrand) für den Benutzer erzeugt wird (Standardwert: Nein).
  • Kopfvorlage: Wenn bei der Autoarchivierung eine neue Archivseite erstellt wird, so wird die hier benannte Vorlage am Anfang automatisch eingebunden. Wird dieser Parameter nicht angegeben, wird Vorlage:Archiv benutzt.
  • Mindestbeiträge: Die Anzahl der Beiträge, die ein Abschnitt haben muss, bevor er archiviert wird. Damit können zum Beispiel alle nicht-beantworteten Beiträge von der Archivierung ausgeschlossen werden (Standardwert: 2).
  • Zeigen: Wird dieser Parameter auf 'Nein' gesetzt, dann wird der Autoarchiv-Hinweis nicht dargestellt. Diese Option ist sinnvoll, wenn der Aufbau der Vorlage beispielsweise das optische Design der zu archivierenden Seite stört (Standardwert: Ja).
  • Mindestabschnitte: Legt fest, wie viele Abschnitte auf einer Seite nach einer Archivierung noch erhalten bleiben müssen (Standardwert: 0).
  • Frequenz: Mit diesem Parameter kann festgelegt werden, wie oft der Bot auf der Seite aufräumen soll (Standardwert: ständig). Mögliche Werte sind:
    • ständig: die Seite wird bei jedem Botlauf ausgewertet
    • morgens, mittags: 3:01 oder 12:01 Uhr
    • montags, dienstags, mittwochs, donnerstags, freitags, samstags, sonntags: jeweils 3:01 an diesem Wochentag, mehrere Tage können mit Komma angegeben werden
    • halbmonatlich: 1. und 15. Tag des Monats
    • monatlich: 1. Tag des Monats
    • halbjährlich: 1. Januar und 1. Juli
    • jährlich: 1. Januar

(Unter-)Abschnitte zusammenhalten

Damit der ArchivBot Unterabschnitte zusammen mit einem Basis-Abschnitt archiviert, darf der Basis-Abschnitt nicht leer sein (leere Basis-Abschnitte werden nicht archiviert, sondern ignoriert). Der Archivbot betrachtet Unterabschnitte als Teil eines nicht leeren Basis-Abschnitts, wobei der ArchivBot auch nicht-leere Basis-Abschnitte ohne einen gültigen Zeitstempel nicht als Basis-Abschnitt erkennt, sondern als „leer“ ignoriert.

Weil der ArchivBot Diskussionsabschnitte nur anhand von == Überschriften in Wiki-Syntax == erkennt, besteht die Möglichkeit Unterabschnittsüberschriften in HTML-Syntax zu verwenden, um sicherzustellen, dass ein ganzer Abschnittszweig auf jeden Fall vom ArchivBot auch als ganzes betrachtet wird. Dennoch wird beispielsweise <h3> Überschrift in HTML-Syntax </h3>[1] von der MediaWiki-Software (innerhalb einer Seite, aber nicht in der Zusammenfassung und Versionsgeschichte!) wie eine === übliche Überschrift === behandelt (auch wenn sie im Quelltext nicht am Zeilenanfang steht).

Signatur ohne Einfluss auf die Archivierung

Um einen Beitrag signieren zu können, der die Archivierung nicht beeinflusst (beispielsweise zeitabhängig laut Parameter „Alter=“), kann folgender Quelltext verwendet werden:  -- ~~~ {{subst:LOCALTIME}}, {{subst:LOCALDAY}}. {{subst:LOCALMONTHABBREV}} {{subst:LOCALYEAR}}
Entscheidend ist hier die fehlende Zeitzone(CET)“ bzw. „(CEST)“ am Ende des Zeitstempels:  -- Benutzername 01:14, 9. Aug. 2024

Signaturen vor der ersten Abschnittsüberschrift

Gültige Signaturen vor der ersten Abschnittsüberschrift können dazu führen, dass der „Abschnitt-Null“ ggf. komplett archiviert wird, inklusive der {{Autoarchiv|...}}-Einbindung. Um dies zu vermeiden siehe oben „Signatur ohne Einfluss auf die Archivierung“.