Typemill Tutorial

Setup, Konfiguration und eBook-Produktion

Sebastian Schürmanns

Auflage 2

Typemill für Publisher

Wer heute ein Gespräch über Bücher und Webseiten führt, der redet meist über zwei unterschiedliche Produkte. Und nicht selten führt er das Gespräch auch mit unterschiedlichen Gesprächspartnern: Die einen betreiben eine Webseite, die anderen schreiben ein Buch. Die einen surfen im Web, die anderen schmökern auf der Couch.

So kommt es, dass viele Buch-Autoren für ihr Eigenmarketing eine separate Webseite betreiben und viele erfolgreiche Webseiten-Betreiber und Blogger separat ein Buch publizieren. Ganz ähnlich sieht es in Unternehmen aus. Es gibt die Webseite und den Jahresbericht, das Kundenmagazin und das Corporate Blog, das Intranet und das Mitarbeiterhandbuch.

Die Realität der Leser sieht jedoch oft anders aus. Bücher werden im Web bestellt, das Web wird mit dem Tablet auf der Couch konsumiert und das Buch wird mit dem eReader am Strand gelesen. Denn dem Leser geht es vor allem um Inhalte. Inhalte, die man mit dem passenden Gerät im passenden Format am passenden Ort liest.

Man denke zum Beispiel an den Jahresbericht einer Organisation. Der wird gerne mal schnell als Webseite überflogen, dann aber doch als PDF heruntergeladen, um die Details während der Zugfahrt ohne Netzanbindung durchzugehen. Oder das Fachbuch, von dem man einige Kapitel frei zugänglich auf der Webseite liest, bevor man sich für den Kauf entscheidet und dann auf sämtliche Inhalte als Webseite oder als eBook zugreifen kann. Ganz ähnlich funktioniert seit der digitalen Transformation die Logik vieler Zeitungsverlage. Warum sollte das Prinzip nicht auch für andere Publikationsformen funktionieren?

Typemill für Micro-Publisher

Typemill ist ein schlankes Content Management System (CMS), das genau diesem Ansatz folgt. Bei Typemill geht es nicht in erster Linie um "das Buch" oder "die Webseite", sondern es geht um Autoren, Leser und Inhalte. Inhalte, die mit einem konsequent autorenfreundlichen System erstellt werden können. Und Leser, die die Inhalte gleichzeitig als Webseite und als Buch lesen können. Denn Webseiten und Bücher sind bei Typemill lediglich unterschiedliche Publikations-Formate, die auf dieselben Inhalte zurückgreifen.

Wenn die Inhalte in beiden Formaten vorliegen, dann können sie auch von den Stärken beider Formate profitieren: von der Attraktivität des Buches und von den Verbreitungs-Chancen moderner Web-Technologien. Denn die traditionelle Webseite ist auch heute noch das beste Mittel, um ohne Umwege eine Leserschaft aufzubauen und langfristig zu binden. Dagegen haben Bücher den Vorteil, dass sie als Produkt wahrgenommen werden und sich einfacher verkaufen lassen.

Der Ansatz ist nicht völlig neu und dürfte einigen Lesern unter dem Stichwort Single Source Publishing geläufig sein. Allerdings waren solche Lösungen bislang komplex und oftmals auf rein professionelle Anwender zugeschnitten. Typemill dagegen setzt auf junge und schlanke Technologien, die ähnlich wie WordPress auch für technisch versierte Laien nutzbar sind.

Features und Einsatzszenarien

Typemill hat jedoch noch mehr zu bieten als ein Single-Source-Publishing, denn es zielt mit seinen Features auf ein vollständiges und dennoch leichtgewichtiges Micro-Publishing ab:

Mit Typemill kann man einfach und intuitiv Webseiten mit strukturierten Inhalten erstellen.

Mit dem eBook-Plugin können aus der Webseite ein oder mehrere eBooks erstellt werden (PDF).

Mit dem Rechte-System von Typemill kann der Zugriff auf Seiten eingeschränkt werden.

Mit dem Register-Plugin kann eine Mitglieder-Basis aufgebaut werden.

Mit dem geplanten Subscription-Plugin sollen in naher Zukunft Bezahl-Abos für Mitglieder möglich werden.

Mit diesem Funktions-Umfang richtet sich Typemill genauso an Einzelautoren wie an kleine Organisationen und an mittelständische Unternehmen. Passende Einsatz-Szenarien können sein:

Produkt- und Software-Dokumentationen.

Mitarbeiterhandbücher als Webseite und als PDF-Dokument.

Schulungsunterlagen für Kurs-Teilnehmer.

Mehrsprachige Bedienungsanleitungen für Unternehmen.

Jahresberichte von Organisationen.

Ein Fachbuch oder Jahrbuch mit einer Abo-Funktion.

Demo und Support

Auch die vorliegenden Inhalte sind als eBook und gleichzeitig als Webseite unter der Adresse https://typemill.trendschau.net verfügbar. Das Publikations-Projekt demonstriert die unterschiedlichen Features von Typemill und bietet gleichzeitig einige Video-Tutorials an, die auch über den YouTube-Channel von Trendschau-Digital in deutscher Sprache oder auf der offiziellen Typemill-Webseite in englischer Sprache abrufbar sind. Die Webseite enthält für registrierte Nutzer zusätzlich einige exklusive Artikel, die unterschiedliche Einsatz-Szenarien von Typemill genauer beschreiben. Die Tutorials sollen Einzelpersonen, kleine Organisationen und mittelständische Unternehmen dabei unterstützen, ein Publikations-Projekt mit Typemill selbständig zu planen und aufzubauen.

Wenn für ein Publikations-Projekt mit Typemill externe Unterstützung erforderlich wird, dann bietet Trendschau Digital professionelle Entwicklungs- und Support-Leistungen an. Wenn die Anforderungen gerade an das Layout der Publikation besonders hoch sind, können auch Teams aus erfahrenen Spezialisten zusammengestellt oder vermittelt werden.

Danksagung

Typemill ist ein Open Source Projekt und steht mit der MIT-Lizenz kostenfrei zur Verfügung. Typemill nutzt zahlreiche weitere Open-Source-Projekte, ohne die Typemill nicht existieren würde. Allen voran gilt mein großer Respekt dem Team von paged.js und der Coko-Foundation. Ohne paged.js wäre eine Produktion von eBooks zumindest in dieser schlanken und unabhängigen Form nicht möglich. Ein weiterer Dank gilt den Mitgliedern der Community, die durch ihr Feedback und durch eine aktive Entwicklung das Typemill-CMS mitgestaltet haben. Einen großen Anteil an der Entwicklung des Projekts hatten außerdem zahlreiche Auftraggeber. Sie sorgen nicht nur für eine finanzielle Basis, sondern bringen auch ständig neue Ideen ein. Das eBook-Plugin ist in dieser Form beispielsweise das Resultat eines Kundenauftrags.

Außerdem ein Dankeschön an die folgenden Open-Source-Projekte:

Slim PHP-Framework

Vue.js Framework

Parsedown (Markdown-Parser)

Laminas-Framework (Permission Libraries)

Symfony-Framework (Diverse Libraries)

Twig (Template Engine)

Valitron (Validierungs-Script)

Tachyons (CSS-Framework)

Axios (JS-Script)

Sortable (JS-Script)

MathJax und KaTeX (JS-Scripts)

... sowie zahlreiche andere Libraries, die bei verschiedenen Plugins zum Einsatz kommen.

Inhalte mit Typemill erstellen

Typemill wurde speziell für Autoren entwickelt. Dementsprechend legt das System sehr hohen Wert auf eine gute Author Experience. Die Struktur der Webseite lässt sich intuitiv über eine interaktive Navigation erstellen. Für die Arbeit mit der Auszeichnungssprache Markdown wurde ein spezieller Visual Editor entwickelt, der an die gewohnten HTML-Editoren erinnert und so die Umstellung auf Markdown erleichtert.

Das folgende Video-Tutorial erklärt in zwölf Minuten die interaktive Navigation und den Editor von Typemill. Das Video ist auch direkt auf YouTube abrufbar.

Die Interaktive Navigation

Über die interaktive Navigation auf der rechten Seite kann der Nutzer neue Seiten erstellen und den gesamten Web-Auftritt per Drag & Drop intuitiv strukturieren. Anders als bei WordPress folgt der Aufbau einer Webseite bei Typemill einer hierarchischen Struktur und entspricht damit eher einem Buch oder einer in sich geschlossenen Publikation. Analog zur Datei-Ablage auf dem Desktop wird bei Typemill zwischen Ordnern und Files unterschieden. Allerdings sind Ordner im Frontend ebenfalls Inhaltsseiten, mit dem Unterschied, dass sie weitere Inhaltsseiten als Unterseiten enthalten können.

In der Navigation wird der Publikations-Status jeder Seiten mit unterschiedlichen Farben kenntlich gemacht:

Rot bedeutet, dass die Seite nicht publiziert und damit nicht im Frontend erreichbar ist.

Grün bedeutet, dass die Seite publiziert und im Frontend erreichbar ist.

Orange bedeutet, dass die Seite publiziert ist, in der Autorenoberfläche jedoch Änderungen vorgenommen wurden, die noch nicht veröffentlicht sind.

Der Status einer Seite lässt sich mit der Publish-Bar am unteren Rand ändern.

Die Publish-Bar

Mit der Publish-Bar am unteren Rand des Bildschirms lässt sich der Status jeder Seite intuitiv kontrollieren und ändern. Dazu gibt es die folgenden Buttons:

Publish: Damit wird die Seite entweder komplett neu veröffentlicht oder es werden Änderungen veröffentlicht.

Discard: Damit können Änderungen verworfen werden, sodass der aktuell veröffentlichte Status wieder hergestellt wird.

Online/Offline: Zeigt den Status der Seite an. Wenn die Seite veröffentlicht ist, kann die Seite über den Button wieder depubliziert werden.

Delete: Die Seite kann gelöscht werden.

Mode: Über den Button kann der Schreibmodus (Visual/Raw) geändert werden.

Frontend-Icon: Über den Button gelangt man auf die veröffentlichte Seite im Frontend.

Da im Raw-Modus keine Speicherung einzelner Blöcke, sondern nur eine Speicherung der gesamten Seite möglich ist, gibt es in diesem Modus in der Publish-Bar noch den Button "Save Draft".

Der Visual Markdown Editor

Inhalte werden bei Typemill mit der Auszeichnungssprache Markdown erstellt. Da nicht alle Autoren mit Markdown vertraut sind und einige Elemente in Markdown recht umständlich zu editieren sind, bietet Typemill einen speziell entwickelten Visual-Markdown-Editor an, der an die üblichen HTML-Editoren erinnert und die Autoren bei der Erstellung der Markdown-Inhalte unterstützt.

Der Visual Markdown Editor ist ein Block-Editor, das heißt die einzelnen Blocks lassen sich separat erstellen, bearbeiten, löschen oder auch verschieben.

Wer reines Markdown bevorzugt, kann über einen Button in der Publish-Bar am unteren Bildschirm-Rand in den Raw-Modus wechseln. Entsprechend der eigenen Vorlieben kann man den Raw-Editor in den Settings auch als Standard-Editor einrichten. Zusätzlich kann man für den Visual Editor in den Settings einzelne Content-Elemente aktivieren bzw. deaktivieren, sodass der Editor an die Erfordernisse der Publikation angepasst werden kann.

Über Plugins lassen sich auch neue Inhalte zum Editor hinzufügen. Aktuell existiert beispielsweise ein Math-Plugin, mit dem sich mathematische Formeln abbilden lassen. Die Formeln werden mit der Latex-Syntax geschrieben:

$$ x = \int_{0^1}^1(-b \pm \sqrt{b^2-4ac})/(2a) $$

Der Meta-Tab

Im Meta-Tab kann der Autor zahlreiche Meta-Angaben eintragen, dazu gehören:

Meta-Title

Meta-Description

Hero-Image

Alt-Text für das Hero-Image

Owner (mit Editor-Rechten)

Autorenzeile

Manuelles Datum

Navigations-Titel

Seite aus sichtbarer Navigation entfernen.

Sofern in den Settings von Typemill die Seiten-Einschränkungen (Page Restrictions) aktiviert wurden, sind zwei weitere Felder sichtbar, mit denen die Sichtbarkeit der Seite im Frontend entweder auf bestimmte Rollen, oder auf bestimmte Nutzer einschränken lässt. Die Details dazu werden im Kapitel über die Rollen und Rechte beschrieben.

Handelt es sich bei der Seite um einen Ordner mit Unterseiten, dann kann man zusätzlich angegeben, ob die Unterseiten entsprechend der Reihenfolger in der Navigation erscheinen sollen ("pages"), oder ob sie nach dem Veröffentlichungs-Datum sortiert werden sollen ("posts"). Mit einer Sortierung nach Datum lassen sich einfache News- oder Blog-Bereiche erstellen. Allerdings ist das Feature begrenzt und nicht für große News-Seiten oder reine Blogs ausgelegt.

Die Installation von Typemill

Typemill ist ein Content Management System (CMS), mit dem sich Webseiten und optional auch eBooks erstellen lassen. Anders als beispielsweise WordPress speichert Typemill die Inhalte und Konfigurationen nicht in einer Datenbank ab, sondern in ganz gewöhnlichen Text-Dateien. Typemill gehört damit zu den sogenannten Flat-File-CMS. Diese Technologie ist in den letzten Jahren besonders bei kleinen und schnellen Content Management Systemen sehr populär geworden. Gleichzeitig bedeutet der Verzicht auf eine Datenbank, dass die Installation noch einfacher und die System-Anforderungen noch geringer werden.

Für Typemill benötigt man lediglich einen Apache-Server und PHP. Die Installation erfolgt dann in fünf Schritten:

Schritt 1: Typemill herunterladen (ZIP).

Schritt 2: Die ZIP-Datei entpacken.

Schritt 3: Die Dateien auf den Server hochladen (z.B. per FTP).

Schritt 4: Schreib-Rechte für Ordner und Dateien setzen (Details in der offiziellen Dokumentation).

Schritt 5: Webseite besuchen und Administrations-Account anlegen.

Das folgende Video-Tutorial demonstriert die Installation von Typemill in drei Minuten. Das Video ist auch direkt über YouTube abrufbar.

Je nach Umgebung kann man noch einige Einstellungen an der .htaccess-Datei vornehmen, die im Root-Verzeichnis von Typemill liegt. Dort findet man beispielsweise auskommentierte Regeln zur Umleitung von http auf https, von www auf nicht-www oder von Urls mit Slash auf Urls ohne Slash.

Beim ersten Aufruf der Seite wird der Nutzer aufgefordert, mit einem Nutzernamen, einer E-Mail und einem Passwort einen Administrations-Account zu erstellen. Anschließend gelangt man auf eine Willkommens-Seite und kann das System in der Autoren- bzw. Administrations-Oberfläche nach seinen Wünschen einrichten.

Die Login-Seite von Typemill ist unter dem Pfad /tm/login erreichbar. Um die Login-Seite künftig schneller zu finden, empfehlen wir die Aufnahme der Seite in die Bookmarks des Browsers.

In seltenen Fällen kann es zu Schwierigkeiten bei der Installation kommen. Dann ist meistens die PHP-Version veraltet (geringer als Version 7) oder es fehlen Standard-Features wie htaccess, mod_rewrite oder auch Programmier-Bibliotheken wie GD für die Bild-Bearbeitung. Kommt es zu Schwierigkeiten, sollte man zunächst die offiziellen Dokumentation von Typemill zu Rate ziehen und im Zweifelsfall den Hoster konsultieren.

Konfiguration von Typemill

Nach der Installation kann man mit Typemill sofort und ohne weitere Konfigurationen eine Webseite erstellen. Wer das System jedoch individualisieren will, der kann detaillierte Einstellungen vornehmen. Alle Einstellungen sind über die Hauptnavigation unter dem Navigationspunkt "Settings" erreichbar. Dort finden sich die Konfigurationsmöglichkeiten im Menü auf der linken Seite:

System: Hier können generelle Angaben zur Webseite gemacht, der Editor konfiguriert und der Zugriff auf die Webseite mit einem Rechte-System gesteuert werden. Zusätzlich gibt es einige Einstellungsmöglichkeiten für Entwickler.

Themes Hier können Themes installiert und aktiviert werden. Viele Themes bieten detaillierte Konfigurationsmöglichkeiten an.

Plugins Hier können Plugins installiert und aktiviert werden. Ebenso wie bei den Themes bieten viele Plugins umfangreiche Einstellungen an.

Account Hier kann der eigene Account eingerichtet werden.

Users Unter diesem Punkt gelangt man zu der Nutzerverwaltung, in der unter anderem neue Nutzer angelegt und Rollen vergeben werden können.

In den folgenden Kapiteln werden die Einstellungsmöglichkeiten detailliert vorgestellt. Einen recht vollständigen Überblick über das Thema Konfiguration bietet auch das folgende Video-Tutorial an. Das Video ist auch direkt auf YouTube abrufbar.

System-Konfigurationen

Die Konfigurations-Möglichkeiten unter dem Menü-Punkt "System" gliedern sich in fünf Abschnitte:

Allgemein: Der Abschnitt enthält allgemeine Konfigurationen wie den Seiten-Titel oder einen globalen Autoren-Namen.

General Presentation: Der Abschnitt enthält Darstellungs-Elemente wie ein Logo, Favicons und Anker-Links für Überschriften.

Writing: In dem Abschnitt kann der Standard-Editor festgelegt werden, außerdem stehen Inhaltselemente für den Visual Editor zur Auswahl.

Access Control: In dem Abschnitt kann der Zugriff auf die gesamte Webseite eingeschränkt und ein feingranulares Rechte-System für einzelne Seiten aktiviert werden.

Developer: Der Abschnitt enthält speziellere Einstellungen, die überwiegend für Entwickler gedacht sind.

Im Detail umfassen die Allgemeinen Einstellungen die folgenden Funktionen:

Konfiguration | Erläuterung
Title | Der Titel der Seite. Der Titel wird auch als "Schrift-Logo" genutzt und zusätzlich zur Überschrift 1. Ordnung (H1) im Title-Attribut der Webseite eingefügt (abhängig vom Theme).
Author | Der globale Autor der Webseite. Er wird im Footer für das Copyright-Element verwendet und als Fallback für Seiten genutzt, sofern für die Seite kein anderer Autor angegeben wurde.
Copyright | Der Copyright-Hinweis wird üblicherweise im Footer verwendet (abhängig vom Theme).
Year | Das Startjahr der Webseite. Es wird im Footer zusammen mit dem Copyright-Hinweis genutzt (abhängig vom Theme).
Language Admin | Die Sprach-Auswahl für die Administrations-Oberfläche. Es stehen derzeit nur wenige Sprachen zur Verfügung und die Übersetzungen sind lückenhaft.
Lang_Attr | Das Sprach-Attribut für die Sprache der Webseite (z.B. "de").
Google Sitemap | Der Link zur Google Sitemap. Die Sitemap kann z.B. für die Google Search Console verwendet werden.

Im Abschnitt General Representation können neben Favicons und Logos auch Headline Anchors aktiviert werden. Wenn das Feature aktiviert ist, dann erhalten alle Überschriften auf allen Inhalts-Seiten jeweils einen Anker, auf den man direkt verlinken kann. Das Feature muss allerdings vom jeweiligen Theme unterstützt werden.

Im Abschnitt Writing kann der Autor seinen präferierten Schreib-Modus als Standard auswählen. Zur Auswahl stehen der Visual Markdown Editor oder der Raw Editor. Beide Varianten werden im Kapitel zur Erstellung von Inhalten detaillierter vorgestellt.

Im Abschnitt Access Control kann der Zugriff auf die gesamte Webseite bzw. auf einzelne Inhaltsseiten gesteuert werden. Mit den Website Restrictions kann die komplette Webseite gesperrt werden, sodass nur authentifizierte Nutzer Zugriff auf die Inhalte haben. Mit den Page Restrictions kann der Zugriff auf einzelne Inhaltsseiten auf bestimmte Rollen oder auf bestimmte Nutzer eingeschränkt werden. Mit dem Feature lassen sich beispielsweise exklusive Bereiche für Mitglieder aufbauen und öffentlich anteasern. Alle Details zu den Zugriffsbeschränkungen werden im Kapitel über Rechte und Rollen erklärt.

Im Abschnitt Developer sind verschiedene Detail-Einstellungen möglich. In diesem Abschnitt sollte man nur Änderungen vornehmen, wenn man die Auswirkungen zweifelsfrei verstanden hat. In vielen Fällen sind dafür Entwickler-Kenntnisse nötig. Die folgende Tabelle enthält einige Erläuterungen.

Einstellung
Erläuterung

Error Reporting
Das Error Reporting muss immer deaktiviert sein. Wenn es aktiviert ist, werden im Frontend Fehler-Berichte angezeigt. Das Feature kann temporär zur Analyse und Behebung von Fehlern aktiviert werden. Die Fehler-Berichte im Frontend können jedoch auch Angreifern Schwachpunkte des Systems verraten.

Twig Cache
Damit kann der zusätzliche Cache-Mechanismus der Template Engine Twig aktiviert werden. Der Mechanismus bringt Performance-Vorteile, die angesichts der ohnehin guten Performance von Typemill allerdings nur wenig ins Gewicht fallen.

Delete Cache
Damit können sämtliche vom System erstellten Cache Files gelöscht werden. Der Cache baut sich anschließend neu auf. Das Feature kann genutzt werden, wenn Fehler in den Cache-Dateien vorliegen.

Standard Size for Images
In den Feldern können abweichende Pixel-Angaben für die Größe von Bildern im Content-Bereich eingegeben werden. Mit den Standard-Einstellungen werden Bilder auf eine Breite von 820px verkleinert. Gibt man eine Breite und eine Höhe ein, dann werden die Motive entsprechend ausgeschnitten und dann verkleinert.

Proxy
Damit können die X-Forwarded-Headers für ein Proxy-Setup aktiviert und vertrauenswürdige IP-Adressen eingetragen werden (durch Komma getrennt). Ein Proxy-Setup ist häufig in Unternehmens-Szenarien relevant.

Disable Headers
In seltenen Fällen möchte man eigene Header anstelle der von Typemill gesendeten Header verschicken. Mit dieser Checkbox können die Typemill-Header deaktiviert werden.

URL-Schemes
Die von Typemill verwendete Markdown-Bibliothek akzeptiert nur Links mit bestimmten Protokollen (z.B. http://, ftp://). Sollten diese Protokolle nicht ausreichen, können hier weitere Protokolle eingetragen werden.

Plugins und Themes

Im Plugin-Directory und im Theme-Directory stehen verschiedene Plugins und Themes kostenfrei zum Download zur Verfügung. Zur Installation werden die entpackten Ordner in die entsprechenden Ordner plugins bzw. themes der Typemill-Installation hochgeladen. Die Plugins und Themes werden anschließend unter den gleichlautenden Navigationspunkten aufgelistet und können per Checkbox aktiviert und in vielen Fällen auch im Detail konfiguriert werden werden.

Account und User

Typemill bietet eine einfache Account- und User-Verwaltung an. Dabei können auch unterschiedliche Rollen vergeben werden. Bei der Erstellung eines neuen Nutzers werden nur wenige Standard-Felder abgefragt. Nach der Erstellung können je nach vergebener Rolle unterschiedliche Eingabe-Felder vorhanden sein.

Die Nutzerdaten werden bei Typemill in einfachen Dateien abgespeichert. In der Administrations-Oberfläche werden jedoch gegebenenfalls nicht alle Nutzerdaten angezeigt. Um Administratoren eine bessere Kontrolle zu ermöglichen, werden ihm alle Nutzerdaten (Passwörter ausgenommen) als Raw-Inhalte angezeigt.

Rechte und Registrierung

Mit dem Rechte-System von Typemill kann man Publikationen mit verschiedenen Autoren organisieren und den Zugriff auf einzelne Seiten im Frontend einschränken, beispielsweise auf angemeldete Mitglieder oder auch auf einzelne Nutzer. In Kombination mit dem Register-Plugin lassen sich so zum Beispiel Leser-Communities mit Member-Content aufbauen.

Nutzerrollen

In der Nutzerverwaltung kann man den Nutzern verschiedene Rollen zuteilen. Initial bietet Typemill die folgenden Rollen zur Auswahl an:

Member: Der User kann lediglich seinen Account verwalten und hat sonst keine Rechte.

Author: Der User sieht im Admin-Bereich den gesamten Content und kann alle Seiten ansehen. Er kann eigene Seiten erstellen und bearbeiten, aber nicht veröffentlichen.

Editor: Der User kann alle Inhalte bearbeiten und veröffentlichen, egal ob er der Autor ist oder nicht. Er hat aber keinen Zugriff auf die Einstellungen.

Administrator: Der Administrator darf alles.

Die Rollen bauen aufeinander auf, die Rechte des Autors umfassen also auch die Rechte des Members und die Rechte des Editors umfassen die Rechte des Authors.

Mit Hilfe von Plugins ist es möglich, die Rechte der bestehenden Rollen zu ändern oder komplett neue Rollen hinzuzufügen. Details dazu finden sich in der offiziellen Dokumentation.

Autoren-Rechte

Für jeden Artikel kann in den Meta-Tabs ein Autor angegeben werden. Dazu schreibt man im Feld "Owner" einen Usernamen hinein. Ist ein Nutzer mit der Rolle Author eingetragen, dann kann er den Artikel bearbeiten. Editoren und Administratoren können grundsätzlich alle Artikel bearbeiten, unabhängig von dem angegebenen Owner.

Mit den Autoren-Rechten lassen sich Publikationen mit beliebig vielen unterschiedlichen Autoren realisieren, ohne dass ein übergeordneter Editor oder Administrator die Kontrolle über die Publikation verliert. Anwendungsfälle sind zahlreich, beispielsweise können in einer unternehmensinternen Seite verschiedene Bereiche von unterschiedlichen Autoren gepflegt werden, gleiches gilt für Bedienungsanleitungen mit unterschiedlichen Autoren.

Zugriffsrechte im Frontend

Um die Zugriffsrechte im Frontend zu beschränken, müssen zunächst die Page Restrictions im Abschnitt "Access Control" in den Settings aktiviert werden. Anschließend findet man in den Settings zwei neue Felder.

Mit dem ersten Feld kann der Zugriff der Seite im Frontend auf eine Rolle beschränkt werden. Dazu können die exisiterenden Rollen ausgewählt werden. Es wird immer die niedrigste Rolle ausgewählt, da die höhergewichtete Rolle automatisch die Rechte der niedrigen Rolle erbt. Wird der Zugriff auf die Rolle member eingeschränkt, dann hat also auch ein Nuzter mit der Rolle author Zugriff auf die Seite, da er die Rechte der member-Rolle erbt.

Im zweiten Feld können einzelne Usernamen (mit Komma separiert) eingetragen werden, sodass nur diese explizit genannten Nutzer Zugriff auf die Seite erhalten.

In den settings kann man außerdem bestimmen, dass der Text einer eingeschränkten Seite angeteasert werden soll und erst nach dem ersten Trennstrich abgeschnitten wird. Außerdem kann der Text der Hinweis-Box angepasst und ein Box-Design ausgewählt werden.

Neben den Page-Restrictions kann in den Settings auch eine globale Website-Restriction aktiviert werden. In diesem Fall können nur angemeldete Nutzer (unabhängig von deren Rolle) die Inhalte der Webseite sehen. Alle nicht angemeldeten Nutzer werden im Frontend auf die Login-Seite umgeleitet.

eBooks mit Typemill generieren

Mit Typemill lassen sich nicht nur Webseiten erstellen, sondern auch eBooks generieren. So können Autoren mit Hilfe der Webseite eine Leserschaft aufbauen und gleichzeitig ein klassisches Publikations-Produkt anbieten. Das Feature eignet sich für Bücher von Einzel-Autoren ebenso wie für Unternehmens-Publikationen im Rahmen des Corporate Publishing. Anwendungs-Beispiele sind Bedienungsanleitungen, Handbücher, Jahrbücher, Schulungsunterlagen und mehr.

Das folgende Video-Tutorial demonstriert die Funktionen zur eBook-Generierung in zwölf Minuten. Das Video ist auch direkt auf YouTube abrufbar.

Das eBook-Plugin

Die eBooks werden mit Hilfe eines Plugins erstellt, das im Plugin-Directory von Typemill heruntergeladen werden kann. Die heruntergeladene Zip-Datei wird zunächst entpackt. Anschließend wird der enthaltene Ordner "ebooks" mit allen Dateien in den Plugin-Ordner von Typemill auf den Server hochgeladen. Das Plugin lässt sich anschließend unter dem Navigationspunkt "Plugins" in der Administrations-Oberfläche von Typemill aktivieren.

Im Unterschied zu vielen anderen Lösungen setzt Typemill bei der eBook-Generierung auf reine Frontend-Technologien (CSS, HTML und JavaScript). Das eBook wird dabei nicht als Datei erzeugt, sondern es wird eine Vorschau erstellt, die mit Hilfe des lokalen Drucker-Treibers in eine PDF-Datei umgewandelt werden kann. Typemill nutzt dabei die JavaScript-Bibliothek paged.js. Diese noch junge Technologie setzt auf die CSS-Eigenschaften Paged Media und stellt eine leichtgewichtige Alternative zu teuren Standard-Lösungen wie PrinceXML dar, bringt derzeit jedoch noch einige Einschränkungen mit sich.

Das Plugin bietet in den Settings zwei unterschiedliche Nutzungs-Varianten an, die auch parallel genutzt werden können:

eBooks in Settings: In dieser Variante erscheint das Interface zur eBook-Generierung in den Settings. Das Feature ist nur für den Administrator nutzbar und ermöglicht die Verwaltung eines einzelnen eBooks auf Basis der gesamten Webseite. Das Feature eignet sich vor allem für Einzel-Publikationen.

eBooks in Pages: In dieser Variante erscheint das Interface zur eBook-Generierung in einem neuen Tab auf jeder Inhalts-Seite. Das Feature ist für alle Autoren nutzbar und ermöglicht mehrere unabhängige eBooks aus verschiedenen Seitenbereichen. Das Feature eignet sich vor allem für Publikations-Reihen wie Jahrbücher, Bedienungsanleitungen und Ähnliches.

Die Interfaces für beide Nutzungs-Varianten unterscheiden sich lediglich in der Auswahl der Buch-Inhalte. Ansonsten sind sie identisch. In beiden Fällen führen fünf Tabs durch die Erstellung des eBooks:

General: Hier kann man das Layout auswählen und einige grundsätzliche Einstellungen vornehmen. Die Einstellungsmöglichkeiten sind von Layout zu Layout verschieden.

Front: Hier können Inhalte für die Front-Seiten wie der Titel, das Cover-Bild, ein Schmutztitel oder auch das Impressum konfiguriert werden.

Content: Hier können die Inhalte für das eBook ausgewählt werden. Grundsätzlich sind alle Inhalte ausgewählt, es können jedoch einzelne Seiten oder Bereiche ausgeschlossen werden. Zusätzlich lässt sich ein automatisch erzeugtes Inhaltsverzeichnis konfigurieren. Die Überschriftenhierarchien lassen sich ebenfalls manipulieren, sodass auch die Seitenhierarchie auf der Typemill-Webseite berücksichtigt wird.

Back: Derzeit kann hier lediglich ein Klappentext eingetragen werden, sofern das Feature vom ausgewählten Layout unterstützt wird.

Create: Im letzten Tab findet man einige Hinweise zu den Voraussetzungen für die eBook-Generierung sowie einen Button für die eBook-Vorschau.

Die Layout-Auswahl

Im Tab "general" kann ein Layout für das eBook ausgewählt werden. Derzeit bietet Typemill die Layouts "electric" und "typemill" an. Das Layout Typemill ist dabei auch produktiv einsetzbar. Entwickler können eigene Layouts erstellen und in das Plugin integrieren. Die technische Details dazu sind in der offiziellen Dokumentation für Publisher beschrieben.

Bilder-Qualität

Typemill nutzt bei der eBook-Generierung die verkleinerten Varianten von Bildern, die auch auf der Webseite verwendet werden. Über eine Checkbox können die qualitativ hochwertigeren Bilder in Original-Größe verwendet werden.

Endnoten

Seit beginn des Jahres 2021 unterstützt page.js, das Script für die eBook-Generierung, auch Fußnoten. Inzwischen hat auch Typemill die Logik angepasst und stellt Fußnoten nun am Fuß der Seite dar. Alternativ können jedoch auch Endnoten aktiviert werden. In diesem Fall werden alle Fußnoten in einem Kapitel am Ende des Buches zusammengefasst.

Die Vorder-Seiten

Je nach Layout können die Cover- und Frontseiten individuell gestaltet werden.

Cover and Titel-Seite

Für das Cover und für die Titel-Seite kann ein Haupt-Titel, ein Untertitel, ein Autor und eine Auflage eingetragen werden. Die Umsetzung hängt wiederum vom ausgewählten Layout ab.

Cover-Bild

Je nach Layout kann ein Cover-Bild hochgeladen werden. Wenn man per Checkbox die Integration aller manuellen Inhalte auf dem Cover deaktiviert, kann das Cover vollkommen frei über die Grafik gestaltet werden. Bei einigen Layouts sind auch Hintergrundfarben wählbar.

Impressum und Danksagung

Je nach Layout kann ein Impressum und eine Danksagung integriert werden. Beides akzeptiert in der Regel eine Markdown-Auszeichnung.

Die Inhalte

Inhaltsverzeichnis

Typemill unterstützt ein automatisch generiertes Inhaltsverzeichnis. Dazu kann eine Überschrift eingetragen werden, außerdem kann angegeben werden, wie tief das Inhaltsverzeichnis reichen soll. Optional können die Überschriften auch mit einem Prefix durchnummeriert werden. Das Inhaltsverzeichnis enthält automatisch verlinkte Seitenzahlen.

Die Inhalts-Auswahl

die Inhalte können über einen interaktiven Inhalts-Baum ausgewählt werden. Initial sind alle Seiten ausgewählt. Es können einzelne Unterseiten oder auch ganze Kapitel aus dem eBook ausgeschlossen werden.

Wenn sich die Struktur der Inhalte geändert hat, kann der Auswahl-Baum über den Button am oberen Ende neu geladen werden.

Überschriften-Ordnungen

Die Überschriften-Ordnungen werden von Typemill bei der Generierung eines eBooks abgeändert, und zwar je nach Position der Seite in der Seitenstruktur. Befindet sich eine Seite in der zweiten Ebene, dann werden alle Überschriften der Seite um ein Level herabgestuft. Befindet sich die Seite in der dritten Ebene, dann werden die Überschriften um zwei Level herabgestuft. Durch diese Logik wird die Struktur der Webseite im eBook widergespiegelt und verhindert, dass jede Seite als ein eigenes Kapitel dargestellt wird.

In einigen Fällen ist diese Logik nicht erwünscht. Daher bietet Typemill mehrere Optionen an, um die Logik der Überschriften-Anpassung zu ändern oder komplett abzuschalten. Da die Anpassungs-Logik nicht immer leicht nachvollziehbar ist, kann sich der Nutzer eine Vorschau von der Überschriften-Hierarchie anzeigen lassen. Mit ein paar Experimenten kommt man so zum Ziel.

Die Rückseite

Je nach Layout kann ein Klappentext für die Rückseite erstellt werden.

Die eBook-Vorschau

Im letzten Tab kann man über einen Button eine Vorschau des eBooks in einem neuen Fenster öffnen. Die Vorschau lässt sich anschließend über die Druck-Funktion des Browsers als PDF abspeichern.