Erweiterung:Proofread Page
Die Proofread Page-Erweiterung erstellt ein Buch entweder als:
- Textspalte mit OCR-Texterkennung neben einer Spalte mit gescannten Bildern oder
- getrennt in Kapiteln bzw. Gedichten. Der Inhalt eines Dokuments erscheint in der MediaWiki-Seite (über Transklusion).
Die Erweiterung soll einen einfachen Vergleich des Textes mit der Digitalisierung des Originals ermöglichen.
Diese Erweiterung zeigt den Text auf verschiedene Arten an, ohne den Originaltext zu vervielfältigen.[1]
Verwendung
Die Erweiterung ist auf allen Wikisource-Wikis installiert. Für die Syntax siehe $1. Es wurde auch auf Bibliowiki verwendet.
Voraussetzungen und Empfehlungen
- Der Zugriff auf die Kommandozeile ist erforderlich, wenn das Ausführen des Update-Skripts (maintenance/update.php) über den Webbrowser fehlschlägt (Dokumentation hier und hier).
- Wenn du DjVu-Dateien verwenden willst (optional, jedoch empfohlen), muss ein nativer DjVu-Handler für die Konfiguration verfügbar sein. Siehe auch Handbuch:Wie man DjVu mit MediaWiki verwendet .
- Außerdem wird die Verwendung von ProofreadPage durch die Verwendung der folgenden Erweiterungen stark verbessert:
- LabeledSectionTransclusion (sehr empfohlen)
- Cite (Standard-Seitenfußzeile enthält
<references />
- Poem
- PdfHandler (Kann zusätzliche PHP-Pakete erfordern) — fügt PDF-Unterstützung hinzu
- PagedTiffHandler
- ParserFunctions
- TemplateStyles (Aktiviert Indexspezifisches CSS)
- Scribunto (Aktiviert die Korrekturlesung der Lua-Bibliothek)
Installation
Erweiterung
- Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens
ProofreadPage
im Ordnerextensions/
ablegen.
Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ProofreadPage - Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
wfLoadExtension( 'ProofreadPage' );
- Führe das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
- Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
Daumennageln
Die Erweiterung verlinkt direkt auf Bild-Thumbnails, die oft nicht vorhanden sind. Du musst 404-Fehler abfangen und die fehlenden Vorschaubilder erstellen. Du kannst dies mit jeder dieser Lösungen tun:
- Lege einen Apache RewriteRule in .htaccess bis thumb.php für fehlende Thumbnails fest:
RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^/w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/page([0-9]+)-?([0-9]+)px-.*$ /w/thumb.php?f=$1&p=$2&w=$3 [L,QSA]
- oder lege den Apache 404 Handler auf Wikimedia's thumb-handler fest. Dies ist ein allgemeiner 404-Handler mit Wikimedia-spezifischem Code, "nicht" einfach ein Thumbnail-Generator.
ErrorDocument 404 /w/extensions/upload-scripts/404.php
- Bei MediaWiki >= 1.20 kannst du einfach auf thumb_handler.php umleiten:
RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^/w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/page([0-9]+)-?([0-9]+)px-.*$ /w/thumb_handler.php [L,QSA]
- Oder in apache2.conf:
ErrorDocument 404 /w/thumb_handler.php
If you encounter a problem similar to the following:
- phab:T301291 – PDF and DjVu files on Commons failed to be processed (no thumbnails, zero pages) but otherwise valid
- phab:T298417 – Undeleted DjVu files show incorrect metadata: 0x0 size, no page number info
- phab:T299521 – PDF file has 0x0 image size in Commons after uploading a new version while the page number is correct
Try next steps:
- repair thumbnails for DjVu files of the core MediaWiki (for PDF use mimetype
application/pdf
)php maintenance/refreshImageMetadata.php --verbose --mime image/vnd.djvu --force
- needed for actualization info about the pages counts of the
Special:IndexPages
php maintenance/refreshLinks.php --namespace 252
Namensräume
ProofreadPage erstellt standardmäßig zwei benutzerdefinierte Namespaces mit den Namen "Page" und "Index" auf Englisch mit den IDs 250 bzw. 252.
Ihre Namen werden übersetzt, wenn dein Wiki eine andere Sprache verwendet. Vollständige Liste.
Du kannst ihren Namen oder ihre ID anpassen: Namespaces von Hand erstellen und ihre IDs in Manual:LocalSettings.php mit $wgProofreadPageNamespaceIds global festlegen. Du tust dann so etwas wie:
define( 'NS_PROOFREAD_PAGE', 250);
define( 'NS_PROOFREAD_PAGE_TALK', 251);
define( 'NS_PROOFREAD_INDEX', 252);
define( 'NS_PROOFREAD_INDEX_TALK', 253);
$wgExtraNamespaces[NS_PROOFREAD_PAGE] = 'Page';
$wgExtraNamespaces[NS_PROOFREAD_PAGE_TALK] = 'Page_talk';
$wgExtraNamespaces[NS_PROOFREAD_INDEX] = 'Index';
$wgExtraNamespaces[NS_PROOFREAD_INDEX_TALK] = 'Index_talk';
$wgProofreadPageNamespaceIds = array(
'index' => NS_PROOFREAD_INDEX,
'page' => NS_PROOFREAD_PAGE
);
Die Anpassung der Namespace-ID wird nicht empfohlen und wird möglicherweise auch in Zukunft nicht unterstützt.
Konfiguration
- Um das Seiten-Qualitätssystem verwenden zu können, müssen fünf Kategorien erstellt werden. Die Namen dieser Kategorien müssen in MediaWiki:Proofreadpage_quality0_category bis MediaWiki:Proofreadpage_quality4_category definiert werden.
- Stelle sicher, dass du Erweiterung:ParserFunctions installiert hast
Konfiguration des Index-Namensraumes
Für mehr Details siehe Extension:Proofread Page/Index data configuration
- Du musst MediaWiki:Proofreadpage_index_template erstellen, um Indexseiten anzeigen zu können. Diese Seite ist eine Vorlage, die als Parameter Einträge des Ausgabeformulars erhält.
- Du musst MediaWiki:Proofreadpage_index_data_config.json erstellen, die die Konfiguration des Indexformulars enthalten. Diese neue Konfigurationsseite setzt MediaWiki:Proofreadpage_index_attributes und MediaWiki:Proofreadpage_js_attributes außer Kraft.
Die Konfiguration ist ein JSON-Array mit Eigenschaften. Hier ist die Struktur einer Eigenschaft im Array, alle Parameter sind optional, der Standardwert ist festgelegt:
{
"ID": { //id of the metadata (first parameter of proofreadpage_index_attributes)
"type": "string", //the property type (for compatibility reasons the values have not to be of this type). Possibles values: string, number, page. If set, the newly set values should be valid according to the type (e.g. for a number a valid number, for a page an existing wiki page...)
"size": 1, //only for the type string : number of lines of the input (third parameter of proofreadpage_index_attributes)
"values": {"a":"A", "b":"B","c":"C", "d":"D"}, //an array values : label that list the possible values (for compatibility reasons the stored values have not to be one of these)
"default": "", //the default value
"header": false, //add the property to MediaWiki:Proofreadpage_header_template template (true is equivalent to being listed in proofreadpage_js_attributes)
"label": "ID", //the label in the form (second parameter of proofreadpage_index_attributes)
"help": "", //a short help text
"delimiter": [], //list of delimiters between two part of values. By example ["; ", " and "] for strings like "J. M. Dent; E. P. Dutton and A. D. Robert"
"data": "" //proofreadpage's metadata type that the property is equivalent to
}
}
Der Datenparameter kann einen Wert haben: "type", "language", "title", "author", "translator", "illustrator", "editor", "school", "year", "publisher", "place", "progress"
Seitentrenner
Die Erweiterung setzt ein Trennzeichen zwischen jede transkludierte Seite und die nächste, das durch wgProofreadPagePageSeparator
definiert ist.
Der Standardwert ist  
(ein Leerzeichen).
Lege wgProofreadPagePageSeparator = ""
fest, um das Trennzeichen zu unterdrücken.
Wörter mit Bindestrich seitenübergreifend verbinden
Wenn ein Wort zwischen einer Seite und der nächsten mit einem Bindestrich getrennt wird, verbindet die Erweiterung die beiden Worthälften miteinander.
Beispiel: his- und tory wird zu Geschichte.
Das "Verbindungszeichen" wird durch wgProofreadPagePageJoiner
definiert und ist standardmäßig '-' (der ASCII-Bindestrich).
Konfiguriere die Änderungsmarkierung (optional)
Siehe Änderungsmarkierung, um Änderungsmarkierungen festzulegen.
Verwendung
Erstellen deiner ersten Seite (Beispiel mit DjVu)
- Bevor du diese Schritte ausführst, vergewissere dich, dass du die Anweisungen in Handbuch:Wie man DjVu mit MediaWiki verwendet befolgt hast.
- (wann und in welchen Namespace wird die djvu-Datei selbst hochgeladen?)
- Erstelle eine Seite im Namensraum "Page" (oder den internationalisierten Namen, wenn du ein nicht-englisches Wiki verwendest). Wenn dein Namespace zum Beispiel 'Page' ist, erstelle
Page:Carroll - Alice's Adventures in Wonderland.djvu
- Erstelle die entsprechende Datei für diese Seite commons:File:Carroll - Alice's Adventures in Wonderland.djvu (oder lege Handbuch:$wgUseInstantCommons auf
true
fest). - Erstelle die Index-Seite
Index:Carroll - Alice's Adventures in Wonderland.djvu
- Füge den Tag
<pagelist />
in das Feld Seiten ein, um die Seitenliste zu visualisieren
- Füge den Tag
- Um Seite 5 des Buches zu bearbeiten, navigiere zu 'Page:Carroll - Alice's Adventures in Wonderland/5' und klicke auf Bearbeiten.
Syntax
Diese Erweiterung führt die folgenden Tags ein:
<pages>
, <pagelist>
Anmerkungen
- ↑ Da die Seiten nicht im Hauptnamensraum liegen, werden sie bei der statistischen Zählung der Texteinheiten nicht berücksichtigt.
Siehe auch
- Abschnitte
- Index data configuration
- Change tagging
- Lua library reference
- Page viewer
- Edit-in-Sequence — A new system (as of 2022) for proofreading without having to reload the entire page.
- Roadmap of the development
- API
- Metadata API — The
proofread
meta submodule - Proofread properties API — Proofreading-related properties of individual pages
- Index data API — Access index pages data (fields and categories)
- Index pagination API — List pages in a given index
- Metadata API — The
- Handbuch:Wie man DjVu mit MediaWiki verwendet
- PdfHandler — fügt PDF-Unterstützung zu Proofread Page hinzu
- Die aktuelle vollständige Beschreibung und Anleitung (auf Englisch) findest du unter: s:Help:Proofread
- Die Nutzungsstatistiken findest du hier: https://phetools.toolforge.org/statistics.php
- ToDo-Liste und Feature-Wünsche der Community
- Ein öffentlich zugängliches Benutzerhandbuch ist in Arbeit: Hilfe:Erweiterung:ProofreadPage
- MediaWiki:OCR.js - Das OCR-Skript
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |