Jump to content

Buch-Werkzeug

From Meta, a Wikimedia project coordination wiki
This page is a translated version of the page Book tool and the translation is 83% complete.
Printed Wikipedia-books

Es ist geplant, die Sammlungserweiterung in weiteren WMF-Projekten bereitzustellen, die Artikelabgleich und PDF-Konvertierung erlauben. Diese Seite zielt darauf, Gemeinschaften beim erfolgreichen Einsatz dieser Erweiterung zu führen. Sie richtet sich an die Wikipedia in ihren verschiedenen Sprachen. Um einen Eindruck zu erhalten, wie dieses Werkzeug arbeitet, gehe auf en.wikipedia.org und suche dort in der Seitenleiste nach "Print/export">"create a book".

Einleitung

Dieses Werkzeug erlaubt Benutzern, eine persönliche Auswahl von Seiten in einem Buch zu organisieren. Bücher können:

  • bearbeitet & in Kapitel unterteilt
  • gespeichert & geladen, geteilt
  • als PDF darstellen (Beispiel)
  • als ODF-Textdokument exportiert
  • als gedrucktes Buch bei PediaPress bestellt (Beispiel)

Siehe auch die Pressemeldung Wikis werden druckbar für weitere Informationen über das Projekt.

Die Erweiterung wurde auf *.wikibooks.org seit Oktober 2008 getestet und ist in der deutschen Wikipedia seit 27. Januar 2009 regulär verfügbar. Weitere Umsetzungen sind geplant.

Anleitung

Du besuchst diese Seite vielleicht seit Du benachrichtigt wurdest, dass Wikipedia diese Erweiterung bald zur Verfügung stellt. Einige Dinge müssen eingerichtet werden und diese Seiten (zeige alle) versuchen dabei zu helfen.

  • Die Hilfe übersetzen. Es gibt vier Hilfeseiten, die einer Übersetzung bedürfen. Siehe #Pages used by this extension für Vorschläge wo Du diese Seiten in Deiner Wiki erstellen kannst.
  • Die Buchwerkzeug Schnellanleitungsseite übersetzen
    Es werden auf der Rückmeldungsseite eine Menge Mitteilungen eingehen und Du wirst einen Weg finden müssen, übersetzte Einträge zu filtern und zur englischen Rückmeldungs-Meta weiterzuleiten. Siehe #Reporting Bugs, Collecting Feedback & Getting Help für weitere Informationen. Des Weiteren nutzen häufig einige Benutzer die Diskussion der Hilfeseite, um sch zum Werkzeug zu äußern und nicht zu der Hilfe.
    Eine Verknüpfung zu der Rückmeldungsseite am Anfang der Diskussionsseiten behebt das.
    Hinweis für Übersetzer: Setze diese Erweiterung zum Versuch auf http://simple.wikipedia.org ein, um ein besseres Verständnis der Funktionen und Konzepte dieser Erweiterung zu erlangen. Sei aufmerksam, wenn Du das Wort "Seite" übersetzt, da es sich sowohl auf eine Wiki-Seite (oder einen Artikel), wie auch auf eine Seite in einem PDF, oder gedruckten Buch beziehen kann.
  • Erstelle andere verwandte Seiten, Kategorien und Schablonen. Am Besten, sobald die Erweiterung einmal eingesetzt, siehe #Pages used by this extension
  • Sammle eine Liste aller Schablonen mit Inhalten, die in PDFs ausgelassen werden sollten, siehe #Templates to exclude in offline exports.

Wenn einmal diese Grundschritte durchgeführt wurden, sind einige Verbesserungen möglich:

Entwürfe

Buch
verweist meistens auf eine Sammlung von Seiten (optional mit Kapiteln, Titel, Untertitel), kann auch auf ein abgeleitetes PDF, ein gedrucktes Buch, oder ein gespeichertes Buch verweisen.
kurzlebiges Buch
eine Sammlung von Artikeln, die in der gegewärtigen Browsersitzung gespeichert sind. Die Liste der Artikel eines "flüchtigen Buches" kann unter [[Spezial:Buch]] eingesehen werden.
gespeichertes Buch
eine gespeicherte Sammlung von Artikeln, auf einer regulären Wikiseite erhalten, entweder im Benutzernamensraum ([[Benutzer:Name/Bücher/Buchname]]) oder im globalen Namensraum ([[Wikipedia:Bücher/Buchname]]). Gespeicherte Bücher können geladen werden. Das "flüchtige Buch" ist dann eine Kopie des "gespeicherten Buches".
Buchseite
bezieht sich gewöhnlich auf [[Spezial:Buch]], wo alle Artikel eines "flüchtigen Buches" aufgelistet werden und das "Buch" verändert, gespeichert, bestellt und exportiert werden kann. Kann sich auch auf ein "gespeichertes Buch" beziehen.
(book) portlet
mit "Erstelle Buch" bezeichneter Rahmen in der Seitenleiste (kapselt 'Artikel hinzufügen/entfernen'-, 'Zeige Buch (N Artikel)'-,'Lade Buch'-, 'Entferne Buch'-, 'Bücherhilfe'-Verweise)
Buchhilfe
Die vom "Portlet" verknüpfte Hauptseite [[Hilfe:Bücher]].
"Offline Export", "Export", "im Druck", "Druckversion", ...
bezieht sich auf den Export eines "Buches" entweder digital (PDF, ODF) oder physisch (gedrucktes Buch).
"Vorschläge", "vorgeschlagene Seiten"
bezieht sich auf eine Funktion die Seiten vorschlägt, welche zu dem gegenwärtigen Satz an Seiten im Buch in Beziehung stehen.

Die Lokalisierung ändern

Versuche die Konzepte zu verstehen Zum Beispiel "Zeige Buch (19 Seiten)" kann dahingehend fehlinterpreted werden, als wenn das PDF 19 Seiten haben wird, obwohl es auf 19 Artikel beruht und wahrscheinlich weit mehr Seiten in einem PDF oder gedruckten Buch haben wird. Worauf bezieht sich leere Buch, wenn jemand gerade ein gespeichertes Buch geladen hat, das jetzt auch ein flüchtiges Buch ist?

Wenn Du Nachrichten ändern musst, dann ändere sie auf translatewiki.net (ext-collection) (wirksam nach der nächsten Softwareaktualisierung) oder ändere sie für das Wiki, in dem Du [[Spezial:AlleNachrichten]] besuchst und mit "coll-*" filterst um alle passenden Nachrichten angezeigt zu bekommen. Ein schneller Blick auf Quelle kann helfen den richtigen Nachrichtenbezeichner zu finden, falls Zweifel bestehen.

Hinweis: Die Metapher "Buch" funktioniert gut für die meisten Wikis. Aber nicht auf *.wikibooks.org, wo sie mit deren "Buch"-Konzept in Konflikt gerät. Wenn Du Übersetzungen auf translatewiki.net veränderst, wäre es gut, wenn Du alle Projekte (z.B. Wikibooks) in der selben Sprache benachrichtigst.

Die in generierten PDFs genutzte Lokalisierung von Meldungen kann ebenfalls in translatewiki.net (mwlibrl) geändert werden.

Um alle in deine Sprache übersetzten Systemmeldungen zu verifizieren, die in dieser Erweiterung benutzt werden, prüfe doppelt bei translatewiki.net.

Seiten, die von dieser Erweiterung genutzt werden

Liste aller Seiten, Kategorien, Vorlagen, die erstellt werden sollten.

Seiten

[[Spezial:Buch?bookcmd=book_creator]]

(erfordert keine Erstellung)

Eine spezielle Einführungsseite (die angezeigte Seite, wenn ein Nutzer auf "Erstelle ein Buch" klickt), die die Aktivierung der "Bucherstellung" erlaubt und eine kurze Hilfeseite transkludiert. Der Name dieser Hilfeseite kann unter coll-book_creator_text_article eingestellt werden. Der voreingestellte ist: Help:Books/Bucherstellung Text, z.B. eine Unterseite der eingerichteten Hilfeseite namens "Bucherstellung Text".
[[Spezial:Buch]] (erfordert keine Erstellung)
Eine spezielle Seite, die alle wichtigen Bearbeitungen "kurzlebiger Bücher" erlaubt.
[[Spezial:Buch/rendern]] (erfordert keine Erstellung)
Die Renderseite zeigt den Fortschritt, während das Dokument erzeugt wird. Nach Abschluss zeigt sie eine Verknüpfung zum Herunterladen des Dokumentes an. Sie kann auch einen Fehler ausgeben, fall die Erstellung fehl schlug. Text kann auf folgende Weisen eingerichtet werden: coll-rendering_text, coll-rendering_article, coll-rendering_status, coll-rendering_page, coll-rendering_finished_text, coll-is_cached, coll-excluded_templates, coll-blacklisted_templates.
[[Spezial:Buch/lade_Sammlung]] (erfordert keine Erstellung)
Wird verwendet, wenn "gespeicherte Bücher" geladen werden. Nur sichtbar für den Benutzer, wenn dieser ein Buch laden will, obwohl bereits eines in der Sitzung existiert. Text kann auf folgende Arten eigerichtet werden: coll-load_overwrite_text, coll-overwrite, coll-append, coll-cancel.
[[Hilfe:Bücher]]
Haupthilfsseite (Beispiel) für dieses Werkzeug, das aus dem Portlet verknüpft ist. Seine Position kann in der Systemmeldung coll-helppage eingestellt werden.
Alle Vorlagen auf die von dieser verwiesen wird, werden vom Druck ausgeschlossen. Es wird empfohlen, diese Funktion nicht zu verwenden, da sie ein zentralisierter und unflexibler Ansatz ist. Die [[Kategorie:Vom Druck ausschließen]] wird stattdessen zur Verwendung empfohlen (siehe unten). Location kann in coll-template_blacklist_title geändert werden.

Kategorien

[[Kategorie:Wikipedia:Buchwerkzeug]]
Wird benutzt um die gesamte Dokumentierung und alle verwandten Seiten und Vorlagen zu speichern.
[[Kategorie:Wikipedia:Bücher]]
Category which tracks all stored books. This category is special as all included pages can be loaded as a book by a "load book"-link which appears in the portlet if one visits a page in this category. That said stored books are automatically added at creation time, while non-stored book pages should not exist in this category. Can be configured by coll-bookscategory. You probably want to change this message to "Wikipedia:Books" (category "Books" is the default).
[[Kategorie:Vom Druck ausschließen]]
Used to track all templates that inject information which is useless or distracting in exports (see below for some motivation). Can be configured by coll-exclusion_category_title.

Vorlagen

[[Vorlagen:Gespeichertes Buch]]
Diese Vorlage (Beispiel) wird automatisch am Anfang eines jeden gespeicherten Buches eingefügt. Sie kann angepasst werden, um die Seite eines gespeicherten Buches ansprechender zu gestalten und Metadaten bereitzustellen. Location kann durch coll-savedbook_template eingerichtet werden.
[[Vorlage:Im Druck verbergen]]
This template (example) returns all markup that was passed in the first parameter (read: does nothing). If added to the [[Category:Exclude in print]] it allows to selectively omit content in printed books or PDFs. Very handy! You can name this whatever you like, but don't forget to add it to the category and document/link it in the expert's help. Note: This template received quick adoption and soon was one of the most included templates, so you might want to protect it.
[[Vorlage:Nur im Druck]] und [[Vorlage:NurDruck im Druck]]
This template (example) returns none of the markup that was passed in the first parameter, while the corresponding [[Template:Only in print/Print]] (example) returns the passed markup. See Help for experts for more on the */Print-subpage used to substitute templates in print. The prefix which is used to substitute templates in print can be configured by coll-print_template_prefix.

Eine benutzerdefinierte Lizenzquelle einstellen

Einige Gemeinschaften möchten vielleicht einige zusätzliche Texte zur Lizenz in der PDF hinzufügen. The license to be included in the PDF is configurable by setting MediaWiki:Coll-license_url to a URL which points to the raw wikitext that shall be used to render the license. By default on public Wikimedia sites this is set to https://creativecommons.org/licenses/by-sa/3.0/.

Vorlagen um in Offline-Exporten Auszuschließen

Es gibt viele Vorlagen mit Inhalt, der in Druckversionen ausgeschlossen werden sollte. Es gibt mindestens drei Haupttypen:

Wartungsmeldungen
They are useless and distracting in offline exports as one can not contribute if offline. Examples: Maintenance, Cleanup...
Warnungs- & Hinweismeldungen
They are useless and distracting in offline exports as users noticed them when selecting the content and choose to add it anyway. Examples: Sources of articles, Disputes, Deletion, General...
Navigationsinhalt
Navigation links are useless and distracting in exports. Examples: Compact TOC, Wikimedia sister projects...

Solche Vorlagen sollten mit der CSS-Klasse noprint markiert werden.

Es wird empfohlen bedeutende Vorlagen zu identifizieren und zu dieser Kategorie frühzeitig - wenn möglich, vor der Entwicklung - hinzuzufügen.

In der deutschen Wikipedia waren wir in der Lage schnell 130 Vorlagen zu erkennen, in dem wir in verwandten Kategorien nachsahen. Wir listeten sie alle auf einer Seite auf und nutzen einen Bot um die Kategorie zuzuweisen. Nur 14 Vorlagen wurden seit dem erkannt, die manuell hinzugefügt werden mussten.

Hinweis: Einige Vorlagen dienen als Vorlagen für andere. In solche Fällen "kann" es hinreichend sein, diese (Eltern-) Vorlage zu der Kategorie hinzuzufügen; welches den Ausschluss einer ganzen Klasse von Vorlagen zum Ergebnis hat.

Die Verfügbarkeit des Buchschöpfers und gedruckter Bücher mitteilen

It is possible to transclude a page at the PDF rendering page which is seen by a user if she clicks on Download as PDF. At this page users (who are obviously in some offline desiring state) can be introduced to the book creator and the option to get 'printed books.

See en:Help:Books/Rendering page info text for an example of this page on en.wp and here to see how it looks at the PDF rendering page.

If the page exists at the location configured in this system message Coll-rendering_page_info_text_article (example on en.wp), it will show up on the PDF rendering page.

Gespeicherte Bücher organisieren

Während viele Vergnügen daran haben mögen, ihre eigenen Bücher zu erstellen, werden andere Gefallen daran finden, wenn sie direkt auf Bücher bestimmter Themen zugreifen können.

The [[Wikipedia:Books]] page can be used to promote availability and accessibility of stored books. There is not much experience on this topic yet but some of the ideas that came up are listed in the subsections below.

Für die Erstellung von Büchern werben

  • Eine Anleitung darüber bieten, wie man "großartige Bücher" erstellt:
    • wie man einen passenden Titel wählt;
    • wie man ein Vorwort einfügt;
    • wie man Artikel auswählt;
    • empfohlene Anzahl von Artikel.
  • Develop guidelines for books that are allowed to exist in the global namespace. These could require (examples):
    • vernünftige Anzahl von eingebundenen Artikeln (z.B. mehr als 5, weniger als 200);
    • einen aussagekräftigen Titel, Untertitel haben;
    • auf ein Thema konzentrieren;
    • vernünftige Qualität der eingebundenen Artikel (z.B. keine Umstrittenen, Schnipsel, Löschkandidaten, usw.).
  • Themen ordnen.

Bücher zugänglich machen

  • Einige Bücher der Woche/des Monats/des Jahres auflisten.
  • Hervorragende Bücher beschriften und vorstellen.
  • Füge den "Es gibt ein Buch zu diesem Thema"-Baustein zu verwandten Artikeln, Kategorien oder Portalen hinzu.
  • Verknüpfe oder binde Teile des Bücherregals A-Z ein.

Bücherregal

Stored books are tracked in the category [[Category:Wikipedia:Books]], but this gets crowded rapidly (de.wp is close to 1.000 stored books – mostly in user space – created within 10 days). Further the category view allows not to display metadata or access books by topic. It would be possible to link books to categories but this would either clutter the main categories with books or require/result in a replication of the category tree in a different namespace.

There is a bot that can automatically generate a bookshelf which allows to explore books by title (A-Z) or keywords. Of course a bookshelf can be created manually also. Visit the bookshelf page for more details on the bot approach.

HauptSeite vorbereiten

MainPages next to portals are special as they often use a multi column web layout. Such pages look really bad in rendered PDFs (fixed width constraints of portrait-layout pages). But then again this is the page which almost every user new to this tool adds first to his book.

A workaround to avoid premature disappointment is to prepare MainPage to look better in PDFs. This can be done by using the [[Hide in print]] template in a way that MainPage (in printed) has no table at all or consists only of on column.

(FIXME:example)

Another issue is the visibility of the portlet. Visitors (not you) to Wikipedia mostly simply ignore the sidebar. It might help if there is some notice about this new feature and a link to the help page on the MainPage's "News about Wikipedia"-box (if available at all) for a limited time.

Fehler melden, Rückmeldungen sammeln & Hilfe bekommen

innerhalb der Wiki

There is a central feedback page at meta (in english) aimed to collect all feature requests, suggestions, bug reports, questions, etc. Non-english Wikipedias may want to setup a similar page (example) on their wiki and define some policy when and how issues are translated and escalated to the feedback page on meta.

Fehlerverfolgung

Benutze die Komponente "Collection" auf Bugzilla.

IRC

Es gibt einen IRC-Chatraum #pediapress für alles, was mit dem Buchwerkzeug zu tun hat.

Erfahrungen aus vergangenen Aufstellungen

Deutsche Wikipedia

What worked: Reception of the tool was mostly positive. Many stored books were created in a short period of time. Media quickly covered this topic once there was a press release by the German chapter.

What didn't work: It was planned to limit the new tool to logged-in users for the first week. Somehow this plan was not executed. As a result the feature was activated while documentation and localization were not really finished. For some users the portlet did not show up on some pages, probably due to caching. The MainPage was not print-version friendly (see above). Finally there was a slashdot effect after the popular german online news magazin Heise covered the story. The rendering server collapsed (load close to 300) instead of serving visitors.

Aktualisierungen

Aktualisierungen - besonders solche, die die Aufmerksamkeit der Gemeinschaft erfordern - werden hier bekanntgegeben.

  • September 2014: statistics for sales have been updated till the end of 2013, at [1].
  • 3 Mar 2009 – PDF-server update & ColExt update
    • Important Change: The template substitution was changed from a prefix to a suffix */Print. The license to be included in the PDF is now configurable by setting MediaWiki:Coll-license_url
    • updated to mwlib release 0.9.11 (changelog)
    • updated to mwlib.rl release 0.9.8 (changelog)
    • Collection-Extension was updated to trunk (changelog)

mwlib + mwlib.rl are used for rendering documents, Collection-Extension implements the UI in Mediawiki