Unterschiede zwischen den Revisionen 8 und 12 (über 4 Versionen hinweg)
Revision 8 vom 2011-02-05 14:10:12
Größe: 565
Autor: anonym
Kommentar:
Revision 12 vom 2011-03-26 15:48:55
Größe: 6222
Autor: anonym
Kommentar: + Doku zum blockquote-Parser, Entschärfung des Bildersturms
Gelöschter Text ist auf diese Art markiert. Hinzugefügter Text ist auf diese Art markiert.
Zeile 5: Zeile 5:
Da der Wikispam wirklich nervig wird, haben wir das Editieren über http (also die unverschlüsselte Fassung des Protokolls, über das Browser und Server miteinander reden) abgestellt. Um editieren zu können, müsst ihr in der Adresszeile statt http https schreiben oder auf [[https://www.datenschmutz.de/moin]] klicken. Da der Wikispam wirklich nervig wird, haben wir das Editieren über http
(also die unverschlüsselte Fassung des Protokolls, über das Browser und
Server miteinander reden) abgestellt. Um editieren zu können, müsst ihr
in der Adresszeile statt http https schreiben. Bitte macht keine Links
auf die https-Versionen, diese führen die Spambots u.U. auf die Fährte.

== Extra-Features dieses Wikis ==

=== Doclinks ===

Die Erfahrung vieler Jahre zeigt, dass externe Ressourcen auch und
gerade bei eher gesetzten Behörden wie etwa Datenschutzbeauftragten
verschwinden oder jedenfalls ihre Lage ändern. Deshalb spiegeln wir
einige Dokumente bei http://www.datenschmutz.de/li/docs/. Das sind
entweder Dokumente, die häufig zitiert werden (bei denen Änderungen der
URLs wirklich viel Arbeit wären) oder Dokumente, die vermutlich bald
verschwinden werden.

Um sie aus dem Wiki-Text zu zitieren, gibt es das Doclink-Makro, das im
ersten Argument den Dateinamen hat, im zweiten den Ankertext (als das,
was im Text steht). Beispiel:

{{{Doclink(2007-LfDBaWue-Bericht28.pdf, 28. TB LfD BaWü (2008))}}} wird
zu <<Doclink(2007-LfDBaWue-Bericht28.pdf, 28. TB LfD BaWü (2008))>>.

Wer Dokumente gespiegelt haben will, möge sie einfach hier eintragen,
jemand mit Schreibrecht sollte das in absehbarer Zeit sehen:

 * Beispiel-Dokument: http://sample.url/somewhere (für eine Beispielseite)

=== Blockquotes ===

Leider hat Moinmoin selbst kein Markup für "längeres Zitat". Weil längere
Zitatblöcke hier länger vorkommen, haben wir eine eigene Erweiterung dafür
gemacht, den blockquote-Parser. Das sieht so aus:

{{{example
{{{#!blockquote
Dieses ist ein Zitat, das zeigen ''soll'', dass innerhalb von
Blockquotes Wiki-Syntax erlaubt ist. Insofern gehen auch die

 #. nicht nur in der EU
 #. durchaus beliebten
 #. Aufzählungen.
}}}
example}}}

Gerendert wird das derzeit so (besseres CSS dafür ist willkommen):

{{{#!blockquote
Dieses ist ein Zitat, das zeigen ''soll'', dass innerhalb von
Blockquotes Wiki-Syntax erlaubt ist. Insofern gehen auch die

 1. nicht nur in der EU
 1. durchaus beliebten
 1. Aufzählungen.
}}}

=== Iimages ===

Das Iimage-Makro sollte für alle Bilder auf diesem Wiki verwendet werden (zur
Verwendung von Bildern allgemein vgl. unten, da erklären wir auch, warum wir
Links zu externen Bildern nicht gerne sehen). Es hat die Form

{{{Iimage(Dateiname,titel und alt)}}}

Der Dateiname hat dabei immer die Form Jahr-beschreibung.ext, also etwa 2006-pruemStructure.jpg. "titel und alt" bezeichnet hier ein paar Worte zu dem, was auf dem Bild zu sehen ist. Dieser Text wird gezeigt, wenn das Bild nicht geladen werden kann oder soll sowie z.B. als "Tooltip" in grafischen Browsern.

Bild-Dateien einrichten können nur die Server-Betreiber. Wenn ihr ein Bild hier drin aben wollt, schreibt eine Bestellung hierhin:

 * Beispiel-Bild: http://von.irgendwoh.er/bild.gif, soll 2011-beispielbild.jpg heißen.

Irgendwer sollte sich dann relativ schnell drum kümmern. Wenn ihr das Iimage-Makro verwendet habt, wird zunächst der Ersatztext gezeigt, danach, wenn wir das Bild verarztet haben, automatisch das Bild.

== Stil-Wünsche ==

Natürlich sind uns Beiträge in jedem Stil willkommen, die Erfahrung
einiger Jahre (oder Präferenzen der Datenschutzgruppe) führen allerdings
zu folgenden Wünschen:

=== Quellenangaben inline ===

Wenns geht, haben wir Quellenangaben und Verweise lieber inline:

  Laut [[http://some.url|23. Bericht Verschwörungsbeauftragten aus Absurdistan]] werden seit 2011 Melderegister und ZEVIS mit Reisedaten der Bahn und Payback zusammengeführt.

als:

  Inzwischen werden Melderegister und ZEVIS mit Reisedaten der Bahn und Payback zusammengeführt.

  Quelle: [[http://some.url|23. Bericht Verschwörungsbeauftragten aus Absurdistan]]

Das erste Format ist robuster gegenüber Edits, entspricht besser den
Gepflogenheiten des Web und verbindet Aussage und Beleg enger. Ähnliches gilt
für das Footnote-Makro -- in Hypertexten haben Fußnoten eigentlich nicht viel
verloren, und in der Regel ist es auch angenehmer, gleich im Text zu sehen,
woher eine Information kommt. Ausnahmen bestätigen natürlich die Regel.

Aufzählungen von Quellen sind recht als genau das, Aufzählungen von
vermischten oder noch nicht wirklich ausgewerteten Quellen.
Auch dann ist ein kurzer Kommentar für spätere Nutzer_innen hilfreich:

 * http://some.url/?doc=xy -- Herstellerdokumentation zum Streaming von Videoüberwachungsdaten in Datenbanktabellen.

=== Lieber weniger Seiten ===

Es gibt natürlich viel zu lange Seiten ([[Europol]] ist ein Beispiel), aber
generell sollte eine Entscheidung "soll ich Inhalt X auf eine eigene Seite
ausgliedern" immer mit einer Vorliebe für "in der Seite bleiben" fallen. Das
Wiki ist erstmal schon unübersichtlich genug, und es ist einfacher, auf einer
Seite hoch- und runterzuscrollen als zwischen vielen Seiten zu navigieren.
Außerdem geht auch nicht so leicht verloren, dass ein Thema schon behandelt
ist.

Bei der Gelegenheit: Wir haben hier das Unterseiten-Feature von moin
(Seite/Unterseite) viel zu wenig genutzt. Es wäre z.B. gewiss ein Gewinn, die
Teildatenbanken von INPOL unter INPOL (oder, wahrscheinlich besser, unter
[[Datenbanken BKA]]) zu gruppieren. Wer möchte, dann das gerne besser machen.

=== Bilder lieber nicht ===

Bitte fügt Bilder nur ein, wenn sie wirklich was bringen, nicht aus
nur ästhetischen Gründen.

Grundsätzlich wollen wir alle Bilder, die aus unserem Wiki referenziert werden,
auch bei uns speichern, schon, um externen Log-Einträgen vorzubeugen. Seht
also bitte, dass wir dafür keinen Ärger kriegen, die Rechte auf Bildern
abzuklären würde uns ziemlich nerven.

Die Alternative, nämlich Attachments erlauben, klingt immer noch zu gruselig.

Vgl. auch oben zum Iimage-Makro.
Zeile 9: Zeile 140:
Eine allgemeine Hilfe zum Editieren gibt es unter:

HilfeZumEditieren

E
ine Sandbox zum Ausprobieren:

WikiSandBox
Eine allgemeine Hilfe zum Editieren gibt es unter HilfeZumEditieren,
wer erstmal spielen will, kann das in der WikiSandBox tun.

Seiten verändern auf datenschmutz.de

Editieren nur bei https

Da der Wikispam wirklich nervig wird, haben wir das Editieren über http (also die unverschlüsselte Fassung des Protokolls, über das Browser und Server miteinander reden) abgestellt. Um editieren zu können, müsst ihr in der Adresszeile statt http https schreiben. Bitte macht keine Links auf die https-Versionen, diese führen die Spambots u.U. auf die Fährte.

Extra-Features dieses Wikis

Die Erfahrung vieler Jahre zeigt, dass externe Ressourcen auch und gerade bei eher gesetzten Behörden wie etwa Datenschutzbeauftragten verschwinden oder jedenfalls ihre Lage ändern. Deshalb spiegeln wir einige Dokumente bei http://www.datenschmutz.de/li/docs/. Das sind entweder Dokumente, die häufig zitiert werden (bei denen Änderungen der URLs wirklich viel Arbeit wären) oder Dokumente, die vermutlich bald verschwinden werden.

Um sie aus dem Wiki-Text zu zitieren, gibt es das Doclink-Makro, das im ersten Argument den Dateinamen hat, im zweiten den Ankertext (als das, was im Text steht). Beispiel:

Doclink(2007-LfDBaWue-Bericht28.pdf, 28. TB LfD BaWü (2008)) wird zu 28. TB LfD BaWü (2008).

Wer Dokumente gespiegelt haben will, möge sie einfach hier eintragen, jemand mit Schreibrecht sollte das in absehbarer Zeit sehen:

Blockquotes

Leider hat Moinmoin selbst kein Markup für "längeres Zitat". Weil längere Zitatblöcke hier länger vorkommen, haben wir eine eigene Erweiterung dafür gemacht, den blockquote-Parser. Das sieht so aus:

{{{#!blockquote
Dieses ist ein Zitat, das zeigen ''soll'', dass innerhalb von 
Blockquotes Wiki-Syntax erlaubt ist.  Insofern gehen auch die

 #. nicht nur in der EU
 #. durchaus beliebten
 #. Aufzählungen.
}}}

Gerendert wird das derzeit so (besseres CSS dafür ist willkommen):

Dieses ist ein Zitat, das zeigen soll, dass innerhalb von Blockquotes Wiki-Syntax erlaubt ist. Insofern gehen auch die

  1. nicht nur in der EU
  2. durchaus beliebten
  3. Aufzählungen.

Iimages

Das Iimage-Makro sollte für alle Bilder auf diesem Wiki verwendet werden (zur Verwendung von Bildern allgemein vgl. unten, da erklären wir auch, warum wir Links zu externen Bildern nicht gerne sehen). Es hat die Form

Iimage(Dateiname,titel und alt)

Der Dateiname hat dabei immer die Form Jahr-beschreibung.ext, also etwa 2006-pruemStructure.jpg. "titel und alt" bezeichnet hier ein paar Worte zu dem, was auf dem Bild zu sehen ist. Dieser Text wird gezeigt, wenn das Bild nicht geladen werden kann oder soll sowie z.B. als "Tooltip" in grafischen Browsern.

Bild-Dateien einrichten können nur die Server-Betreiber. Wenn ihr ein Bild hier drin aben wollt, schreibt eine Bestellung hierhin:

Irgendwer sollte sich dann relativ schnell drum kümmern. Wenn ihr das Iimage-Makro verwendet habt, wird zunächst der Ersatztext gezeigt, danach, wenn wir das Bild verarztet haben, automatisch das Bild.

Stil-Wünsche

Natürlich sind uns Beiträge in jedem Stil willkommen, die Erfahrung einiger Jahre (oder Präferenzen der Datenschutzgruppe) führen allerdings zu folgenden Wünschen:

Quellenangaben inline

Wenns geht, haben wir Quellenangaben und Verweise lieber inline:

als:

Das erste Format ist robuster gegenüber Edits, entspricht besser den Gepflogenheiten des Web und verbindet Aussage und Beleg enger. Ähnliches gilt für das Footnote-Makro -- in Hypertexten haben Fußnoten eigentlich nicht viel verloren, und in der Regel ist es auch angenehmer, gleich im Text zu sehen, woher eine Information kommt. Ausnahmen bestätigen natürlich die Regel.

Aufzählungen von Quellen sind recht als genau das, Aufzählungen von vermischten oder noch nicht wirklich ausgewerteten Quellen. Auch dann ist ein kurzer Kommentar für spätere Nutzer_innen hilfreich:

  • http://some.url/?doc=xy -- Herstellerdokumentation zum Streaming von Videoüberwachungsdaten in Datenbanktabellen.

Lieber weniger Seiten

Es gibt natürlich viel zu lange Seiten (Europol ist ein Beispiel), aber generell sollte eine Entscheidung "soll ich Inhalt X auf eine eigene Seite ausgliedern" immer mit einer Vorliebe für "in der Seite bleiben" fallen. Das Wiki ist erstmal schon unübersichtlich genug, und es ist einfacher, auf einer Seite hoch- und runterzuscrollen als zwischen vielen Seiten zu navigieren. Außerdem geht auch nicht so leicht verloren, dass ein Thema schon behandelt ist.

Bei der Gelegenheit: Wir haben hier das Unterseiten-Feature von moin (Seite/Unterseite) viel zu wenig genutzt. Es wäre z.B. gewiss ein Gewinn, die Teildatenbanken von INPOL unter INPOL (oder, wahrscheinlich besser, unter Datenbanken BKA) zu gruppieren. Wer möchte, dann das gerne besser machen.

Bilder lieber nicht

Bitte fügt Bilder nur ein, wenn sie wirklich was bringen, nicht aus nur ästhetischen Gründen.

Grundsätzlich wollen wir alle Bilder, die aus unserem Wiki referenziert werden, auch bei uns speichern, schon, um externen Log-Einträgen vorzubeugen. Seht also bitte, dass wir dafür keinen Ärger kriegen, die Rechte auf Bildern abzuklären würde uns ziemlich nerven.

Die Alternative, nämlich Attachments erlauben, klingt immer noch zu gruselig.

Vgl. auch oben zum Iimage-Makro.

Allgemeine Hilfe zum Editieren

Eine allgemeine Hilfe zum Editieren gibt es unter HilfeZumEditieren, wer erstmal spielen will, kann das in der WikiSandBox tun.