Klm46: 1 Version

2009-04-01T09:12:27Z

1 Version

CaZeRillo: /* Häufige Fehler */ typo

2009-03-29T16:55:12Z

‎Häufige Fehler: typo

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
=== 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 [[Byte#Einheiten für große Mengen Bytes|kB]]), wobei Größen zwischen 32 und 250 [[Byte#Einheiten für große Mengen Bytes|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ängigen Parameter beliebig kombiniert werden: (alle Zeitangaben beziehen sich auf das Datum des ersten Eintrags unter dem jeweiligen Abschnitt):
** <code><nowiki>((Tag))</nowiki></code>: Tag, z. B. <tt>1</tt>, <tt>24</tt>
** <code><nowiki>((Tag:##))</nowiki></code>: zweistelliger Tag, z. B. <tt>01</tt>, <tt>24</tt>
** <code><nowiki>((Tag:kurz))</nowiki></code>: abgekürzter Tagesname (kleingeschrieben), z. B. <tt>mo</tt>, <tt>fr</tt>
** <code><nowiki>((Tag:Kurz))</nowiki></code>: abgekürzter Tagesname, z. B. <tt>Mo</tt>, <tt>Fr</tt>
** <code><nowiki>((Tag:KURZ))</nowiki></code>: abgekürzter Tagesname (großgeschrieben), z. B. <tt>MO</tt>, <tt>FR</tt>
** <code><nowiki>((Tag:lang))</nowiki></code>: Tagesname (kleingeschrieben), z. B. <tt>montag</tt>, <tt>freitag</tt>
** <code><nowiki>((Tag:Lang))</nowiki></code>: Tagesname, z. B. <tt>Montag</tt>, <tt>Freitag</tt>
** <code><nowiki>((Tag:LANG))</nowiki></code>: Tagesname (großgeschrieben), z. B. <tt>MONTAG</tt>, <tt>FREITAG</tt>
** <code><nowiki>((Monat))</nowiki></code>: Monat, z. B. <tt>1</tt>, <tt>10</tt>
** <code><nowiki>((Monat:##))</nowiki></code>: zweistelliger Monat, z. B. <tt>01</tt>, <tt>10</tt>
** <code><nowiki>((Monat:kurz))</nowiki></code>: abgekürzter Monatsname (kleingeschrieben), z. B. <tt>jan</tt>, <tt>okt</tt>
** <code><nowiki>((Monat:Kurz))</nowiki></code>: abgekürzter Monatsname, z. B. <tt>Jan</tt>, <tt>Okt</tt>
** <code><nowiki>((Monat:KURZ))</nowiki></code>: abgekürzter Monatsname (großgeschrieben), z. B. <tt>JAN</tt>, <tt>OKT</tt>
** <code><nowiki>((Monat:lang))</nowiki></code>: Monatsname (kleingeschrieben), z. B. <tt>januar</tt>, <tt>oktober</tt>
** <code><nowiki>((Monat:Lang))</nowiki></code>: Monatsname, z. B. <tt>Januar</tt>, <tt>Oktober</tt>
** <code><nowiki>((Monat:LANG))</nowiki></code>: Monatsname (großgeschrieben), z. B. <tt>JANUAR</tt>, <tt>OKTOBER</tt>
** <code><nowiki>((Quartal))</nowiki></code>: Quartal, z. B. <tt>1</tt>, <tt>3</tt>
** <code><nowiki>((Quartal:##))</nowiki></code>: zweistelliges Quartal, z. B. <tt>01</tt>, <tt>03</tt>
** <code><nowiki>((Quartal:i))</nowiki></code>: Quartal (kleine römische Ziffern), z. B. <tt>i</tt>, <tt>iv</tt>
** <code><nowiki>((Quartal:I))</nowiki></code>: Quartal (große römische Ziffern), z. B. <tt>I</tt>, <tt>IV</tt>
** <code><nowiki>((Halbjahr))</nowiki></code>: Halbjahr, z. B. <tt>1</tt>, <tt>2</tt>
** <code><nowiki>((Halbjahr:##))</nowiki></code>: zweistelliges Halbjahr, z. B. <tt>01</tt>, <tt>02</tt>
** <code><nowiki>((Halbjahr:i))</nowiki></code>: Halbjahr (kleine römische Ziffern), z. B. <tt>i</tt>, <tt>ii</tt>
** <code><nowiki>((Halbjahr:I))</nowiki></code>: Halbjahr (große römische Ziffern), z. B. <tt>I</tt>, <tt>II</tt>
** <code><nowiki>((Woche))</nowiki></code>: Woche, z. B. <tt>1</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>((Lemma))</nowiki></code>: komplettes Lemma der Ursprungsseite
{| style="{{bgc|t}}"
| [[Bild:Zeichen 101.svg|36px]]
| Wichtig sind dabei die Hochkommata <code><nowiki>''</nowiki></code> um den Zielpfad!
|}

==== Beispiele ====
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=1|Ziel='Benutzer Diskussion:Sebmol/Archiv'}}</code>
: archiviert alle Abschnitte, deren letzter Beitrag mindestens einen Tag zurückliegt, nacheinander unter
:* <tt><nowiki>Benutzer Diskussion:Sebmol/Archiv</nowiki></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
:* <tt>Benutzer Diskussion:Sebmol/Archiv/{{LOCALYEAR}}/{{LOCALMONTHABBREV}}</tt>
; <code><nowiki>{{</nowiki>Autoarchiv|Alter=2|Ziel='Benutzer Diskussion:Sebmol/Archiv/((Jahr))/Woche ((Woche:##))'}}</code>
: archiviert alle Abschnitte, deren letzter Beitrag mindestens zwei Tage zurückliegt, auf Unterseiten nach dem Muster
:* <tt>Benutzer Diskussion:Sebmol/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''': Fügt in den eingebundenen Baustein den Satz "Die Archivübersicht befindet sich unter ''[Link auf Archiv]''." ein. Dieser Parameter ist sinnvoll bei Aufteilung des Archivs auf mehrere Seiten (z. B. /2006, /2007, ...). Es ist auch möglich, an das Ende des Bausteins weiteren Inhalt einzufügen. Bei nur einer Archivseite empfiehlt sich die Verwendung der [[Vorlage:Archiv Tabelle]].
** '''Beispiel''': <tt>Übersicht=<nowiki>[[{{subst:FULLPAGENAME}}/Archiv]]</nowiki></tt>
** '''Alternativ''', um mit einem einzigen Link zu einer „automatischen Übersicht“ aller Archivseiten zu verlinken: <tt>Übersicht=<nowiki>[[Spezial:Präfixindex/{{subst:FULLPAGENAME}}/Archiv|Archiv]]</nowiki></tt>
** '''Weiterer Inhalt''' kann durch einfaches Anhängen realisiert werden: (Siehe hierzu auch die [[Hilfe:Vorlagenprogrammierung|Vorlagenprogrammierung]]) <tt>Übersicht=<nowiki>[[Spezial:Präfixindex/{{subst:FULLPAGENAME}}/Archiv|Archiv]].</nowiki> Das momentan verwendete Archiv ist das <nowiki>[[{{subst:FULLPAGENAME}}/Archiv-{{#time:Y}}|Archiv vom Jahr {{#time:Y}}]]</nowiki></tt>
* '''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'' (veraltet): Standardmäßig wird {{Vorlage|Archiv}} gesetzt. Daher kann auch die Möglichkeit genutzt werden, ein [[Vorlage:Archiv#Eigenes Design|eigenes Design]] über diese Vorlage zu setzen. Dieser Parameter war die vorherige Lösung, wo die benannte Vorlage am Anfang automatisch eingebunden wurde. Der Parameter sollte nicht mehr verwendet werden.
* '''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, um leere Diskussionsseiten zu vermeiden (Standardwert: 0).
* '''Frequenz''': Mit diesem Parameter kann festgelegt werden, wie oft der Bot auf der Seite aufräumen soll (Standardwert: ständig, morgens und abends). Mögliche Werte sind:
** <code>ständig</code>: die Seite wird bei jedem Botlauf ausgewertet
** <code>montags</code>, <code>dienstags</code>, <code>mittwochs</code>, <code>donnerstags</code>, <code>freitags</code>, <code>samstags</code>, <code>sonntags</code>: jeweils 3:01 an diesem Wochentag
** <code>halbmonatlich</code>: 1. und 15. Tag des Monats
** <code>monatlich</code>: 1. Tag des Monats
** <code>halbjährlich</code>: 1. Januar und 1. Juli
** <code>jährlich</code>: 1. Januar
** Frequenzen können mittels Doppelpunkt auf eine Tageszeit eingeschränkt werden. Wird keine Einschränkung angegeben, so wird <code>morgens</code> angenommen.
**:Beispiele:
**:<code>montags:morgens</code> archiviert jeden Montag morgen.
**:<code>monatlich:mittags</code> archiviert immer am Mittag des ersten Monatstages.
**:<code>sonntags:ständig</code> archiviert jeden Sontag am Morgen und gegen Mittag.
** Mehrere Frequenz-Angaben können kombiniert werden. Dazu müssen sie durch Komma getrennt werden.
**:Beispiele:
**:<code>montags, monatlich:mittags</code> archiviert jeden Montag morgens und am ersten Tag des Monats auch mittags.
**:<code>dienstag:mittags, sonntag:mittags</code> archiviert jeden Dienstag und Sonntag mittags.
* '''Modus''': Mit diesem Parameter kann die Arbeitsweise des Bots festgelegt werden (Standardwert: Alter). Folgende Werte sind möglich:
** <code>Alter</code>: Abschnitte werden nur archiviert, wenn sie das eingestellte Alter erreicht haben.
** <code>Erledigt</code>: Abschnitte werden nur archiviert, wenn sie mit {{[[Vorlage:erledigt|erledigt]]}} markiert sind.
** <code>Alter, Erledigt</code>: Abschnitte werden nur archiviert, wenn sie das eingestellte Alter erreicht haben und sie mit {{[[Vorlage:erledigt|erledigt]]}} markiert sind.

=== Kopiervorlage ===
In folgender Kopiervorlage sind die ersten 3 Werte (Mindest<code>Alter</code> der zu archivierenden Beiträge, das <code>Ziel</code> und die <code>Übersicht</code>) nur bewährte Empfehlungen, alle anderen Parameter sind mit den Standardwerten vorbelegt. Im „Normalfall“ kann die Kopiervorlage unverändert übernommen werden. Lediglich beim Parameter <code>Ziel</code> kann es sinnvoll sein, wie oben beschrieben, die Pfadangabe zu präzisieren, damit z.B. für jedes Jahr oder jeden Monat eine Unterseite angelegt wird. Wird die Kopiervorlage unverändert eingesetzt, wird lediglich eine globale Archivseite angelegt.
<pre><nowiki>
{{Autoarchiv
|Alter =50
|Ziel ='((Lemma))/Archiv/((Jahr))'
|Übersicht =[[Spezial:Präfixindex/{{subst:VOLLER_SEITENNAME}}/Archiv|Archiv]]
|Mindestbeiträge =1
|Mindestabschnitte =3
|Frequenz =montags
}}
</nowiki></pre>

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

Damit der [[Benutzer:ArchivBot|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 ''[[Hilfe:Signatur|gültigen Zeitstempel]]'' nicht als Basis-Abschnitt erkennt, sondern als „leer“ ignoriert.

Weil der ArchivBot Diskussionsabschnitte nur anhand von <code>[[Hilfe:Textgestaltung|== Überschriften in Wiki-Syntax ==]]</code> erkennt, besteht die Möglichkeit Unterabschnittsüberschriften in [[Hypertext Markup Language|HTML]]-Syntax zu verwenden, um sicherzustellen, dass ein ganzer Abschnittszweig auf jeden Fall vom ArchivBot auch als ganzes betrachtet wird. Dennoch wird beispielsweise <code><nowiki><h3> Überschrift in HTML-Syntax </h3></nowiki></code>[http://de.selfhtml.org/html/text/ueberschriften.htm] von der [[MediaWiki]]-Software (innerhalb einer Seite, aber ''nicht in der [[Hilfe:Zusammenfassung und Quelle|Zusammenfassung]] und [[Hilfe:Versionen|Versionsgeschichte]]!)'' fast wie eine <code>=== übliche Überschrift ===</code> behandelt (auch wenn sie im Quelltext nicht am Zeilenanfang steht).
{{Hilfe:Textgestaltung/HTML Hn-Header und MediaWiki}}

=== (Unter-)Abschnitte vor dem Archivieren schützen ===

Um einen bestimmten Abschnitt und eventuell vorhandene Unterabschnitte nicht zu archivieren, kann die Vorlage <code><nowiki>{{</nowiki>[[Vorlage:Nicht archivieren|nicht archivieren]]<nowiki>}}</nowiki></code> verwendet werden.

=== Signatur ohne Einfluss auf die Archivierung ===

Um einen Beitrag [[Hilfe:Signatur|signieren]] zu können, der die Archivierung nicht beeinflusst (beispielsweise zeitabhängig laut Parameter „<code>Alter=</code>“), kann folgender Quelltext verwendet werden''':'''  <code><nowiki>-- ~~~ {{subst:LOCALTIME}}, {{subst:LOCALDAY}}. {{subst:LOCALMONTHABBREV}} {{subst:LOCALYEAR}}</nowiki></code>
 Entscheidend ist hier die fehlende [[Zeitzone]] „<code>(CET)</code>“ bzw. „<code>(CEST)</code>“ am Ende des Zeitstempels''':'''  -- [[Benutzer:Benutzername|Benutzername]] {{LOCALTIME}}, {{LOCALDAY}}. {{LOCALMONTHABBREV}} {{LOCALYEAR}}

=== Häufige Fehler ===

{| style="{{bgc|t}}"
| [[Bild:Zeichen 101.svg|36px]]
|
* '''Die Archivseite lautet ''"Benu+1er Di0ku00ion:Benu8zer/Arc2iv 2007"'' oder ähnlich:''' beim Parameter <code>Ziel</code> liegt ein Fehler vor, wichtig sind die Hochkommata <code><nowiki>''</nowiki></code> um den Zielpfad!
* '''''"Ungültiges Archivierungsziel – Die Zielangabe bei der automatischen Archivierung dieser Seite ist ungültig. ..."'':''' kann auftreten, wenn [[Hilfe:Artikel verschieben|die Seite verschoben]] wurde. Der Parameter <code>Ziel</code> muss entsprechend angepasst, bereits vorhandene Archive sollten auch verschoben werden.
* Es erfolgt keine Archivierung, obwohl die Zeit eigentlich dafür gekommen ist. Dies kann daran liegen, das auf der Diskussionsseite ein Paar geschweifte Klammern (<nowiki>{{</nowiki>) keine schließende Klammer hat. Das Problem kann umgangen werden, wenn die geschweiften Klammern in <code><no<nowiki/>wiki></code>-tags geschrieben werden. (<code><nowiki><nowiki>{{</nowiki></nowiki></code>)
|}

← Nächstältere Version	Version vom 1. April 2009, 09:12 Uhr
(kein Unterschied)

Vorlage:Autoarchiv/Doku - Versionsgeschichte

Klm46: 1 Version

CaZeRillo: /* Häufige Fehler */ typo