Installieren und Einrichten von Manifold Scholar

Manifold ist eine Open-Source-Webanwendung, mit der Sie webbasierte Ausgaben von Büchern und anderen textbasierten Medien veröffentlichen können, damit Benutzer diese Texte frei lesen und kommentieren können. Manifold eignet sich besonders für die Verwendung mit Open Access-Materialien (OA) und Open Education Resources (OERs) und kann in Klassenräume, Bootcamps, Workshops, Bibliotheken und andere Orte integriert werden, an denen Sie möglicherweise Wissen durch gemeinsames Lesen austauschen möchten.

Manifold wurde von der Mellon Foundation finanziert und ursprünglich unter Berücksichtigung der wissenschaftlichen Monografie erstellt. Auf der Plattform können jedoch viele Arten von Veröffentlichungen (Zeitschriften, Broschüren, Sammlungen) gesammelt, organisiert, gelesen und kommentiert werden. Ein Beispiel für ein Manifold-Buch finden Sie in der Manifold-Version des kostenlosen eBooks _https: //cuny.manifoldapp.org/projects/how-to-code-in-python-3 Python 3] _.

In diesem Lernprogramm richten wir Manifold auf einem Server ein und fügen Ihrer Installation einen Text hinzu.

Um loszulegen, sollten Sie Folgendes haben:

Damit Manifold auf einer Website mit einer URL ausgeführt werden kann, müssen Sie einen vollständig qualifizierten Domainnamen einrichten. Anleitungen zum Einrichten finden Sie in der Dokumentation Ihres Hosting-Anbieters. Wenn Sie DigitalOcean verwenden, finden Sie Anleitungen in unserem Tutorial unter https://www.digitalocean.com/community/tutorials/how-to-point-to-digitalocean-nameservers-from-common-domain-registrars[How To Verweisen Sie auf DigitalOcean-Nameserver von Common Domain Registrars.

Wenn Sie momentan nicht mit Ihrem Domain-Namen eingerichtet sind, können Sie den Host-Namen in + /etc/manifold/manifold.rb + manuell einstellen und die Anwendung neu konfigurieren. Die Neukonfiguration wird unten erläutert.

Wenn diese Voraussetzungen erfüllt sind, können Sie mit dem Lernprogramm beginnen.

Wir werden Manifold für Ubuntu 18.04 herunterladen.

Wechseln Sie zunächst in das temporäre Verzeichnis, um das Paket herunterzuladen, da das Paket später entfernt werden kann.

Verwenden Sie als Nächstes den Befehl + curl + mit dem Flag + -O +, um die Ausgabe in eine lokale Datei zu schreiben. Dadurch wird das Paket auf unseren Server heruntergeladen.

Als Nächstes installieren wir das Paket.

Wenn Sie diesen Befehl ausführen, sollten Sie eine Ausgabe erhalten, die die folgenden Zeilen enthält:

Sobald Sie diese Zeilen erhalten haben, können Sie mit dem nächsten Schritt fortfahren.

Wenn Sie die anfängliche Serverkonfiguration durchgeführt haben, sollte auf Ihrem Server eine "+ ufw +" - Firewall installiert sein. Wenn keine Firewall vorhanden ist, sollten Sie eine Firewall implementieren, indem Sie https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-18-04#step-4 befolgen -% E2% 80% 94-Einrichten einer Basis-Firewall [Einrichten einer Basis-Firewall] im Handbuch zur Erstinstallation des Servers.

Um Datenverkehr über "+ http +" im Web zuzulassen, sollten Sie Port 80 öffnen.

Sie sollten die Ausgabe erhalten, dass diese Regel hinzugefügt wurde. Sie können Ihren Firewall-Status überprüfen, indem Sie "+ sudo ufw status" eingeben, um die aktuellen Regeln auf Ihrem Server anzuzeigen.

Wenn auf diesem Server bereits ein vollqualifizierter Domänenname eingerichtet ist, müssen Sie möglicherweise keine weitere Konfiguration vornehmen. Dies ist der Fall, wenn Sie die folgende Ausgabe erhalten haben, die Ihrem Domainnamen entspricht:

Wenn Sie jedoch momentan die IP-Adresse des Servers verwenden oder die Ausgabe oben nicht mit Ihrer URL übereinstimmt, können Sie Manifold so konfigurieren, dass sie auf die richtige Stelle verweist.

Unter + / etc / manifold / manifold.rb + wurde eine Datei erstellt, mit der Sie die verschiedenen Dienste konfigurieren und verwalten können, aus denen Manifold besteht.

Öffnen Sie diese Datei in Ihrem bevorzugten Texteditor (wir verwenden nano).

Suchen Sie in dieser Datei nach der Einstellung "+ external_url +" oben in der Datei. Stellen Sie entweder die IP-Adresse Ihres Servers oder den Domänennamen Ihrer Manifold-Installation ein.

etc / manifold / manifold.rb

Wenn Ihre Website "+ example.com +" lautet, sieht Ihre Zeile folgendermaßen aus:

Wenn Ihre IP-Adresse "+ 192.0.2.0 +" lautet, sieht Ihre Zeile folgendermaßen aus:

Speichern Sie nun die Datei und beenden Sie sie. Drücken Sie dazu "+ CTRL " + " X " und dann " y ", um zu bestätigen, dass Sie es speichern möchten, und dann " ENTER +".

Zu diesem Zeitpunkt können Sie Manifold mit dem folgenden Befehl neu konfigurieren.

Die Manifold-App implementiert nun die in dieser Datei vorgenommenen Änderungen, um neue Einstellungen und Konfigurationsdateien zu generieren. Dieser Vorgang ist abgeschlossen, wenn Sie eine Ausgabe ähnlich der folgenden erhalten:

Sie können jetzt entweder die URL oder die IP-Adresse Ihres Servers aufrufen. Sie sollten eine leere Manifold-Homepage sehen.

image: https://assets.digitalocean.com/articles/manifold/manifold_home_page.png [Manifold-Homepage]

Wenn die Manifold-App bereitgestellt wird, können Sie mit dem nächsten Schritt fortfahren.

Alle in Manifold gespeicherten Inhalte (einschließlich Texte, Projekte, Autoren, Ressourcen und Benutzer) werden über die Manifold-Weboberfläche über den Pfad "+ / backend +" verwaltet.

Um auf das Backend zugreifen zu können, müssen Sie einen Administrator auf Ihrem Server einrichten. Sie rufen einen Befehl auf, um diesen Administrator über die ausführbare Datei "+ manifold-api" zu erstellen.

Um diesen Befehl zu verwenden, müssen Sie Ihre eigenen Daten eingeben, einschließlich Ihrer E-Mail-Adresse, Ihres Passworts, Ihres Vornamens und Nachnamens, und zwar im folgenden Format:

Ersetzen Sie Ihre eigenen Informationen im obigen Befehl wie im folgenden Beispiel:

Sobald Sie den Befehl ausführen, erhalten Sie eine Ausgabe ähnlich der folgenden:

Wenn Sie diesen Benutzer erstellt haben, kehren Sie zu Ihrem Browser zurück und klicken Sie auf das Avatar-Symbol in der oberen rechten Ecke von Manifold, um sich anzumelden.

image: https://assets.digitalocean.com/articles/manifold/manifold_login.png [Manifold Login]

Nachdem Sie Ihre Anmeldeinformationen eingegeben und sich erfolgreich angemeldet haben, wird in der Kopfzeile die Schaltfläche * ENTER ADMIN MODE * angezeigt.

image: https://assets.digitalocean.com/articles/manifold/enter_admin_mode.png [Manifold Admin Mode]

Klicken Sie auf diese Schaltfläche, um auf das Backend von Manifold zuzugreifen.

Über das Backend gelangen Sie zu Ihrem zukünftigen Projekt.

image: https://assets.digitalocean.com/articles/manifold/projects_list.png [Manifold Projects List]

Um ein neues Projekt zu erstellen, klicken Sie in der oberen Menüleiste auf * Projekte * und dann auf die Schaltfläche * Neues Projekt hinzufügen *. Sie werden aufgefordert, einen Titel sowie einen optionalen Untertitel und eine Beschreibung einzugeben. Zu Demonstrationszwecken können Sie das kostenlose eBook _https: //www.do.co/python-book [How To Code in Python 3] _ hochladen und als Titel + How To Code in Python 3 + eingeben .

Nachdem Sie diese Informationen eingegeben haben, können Sie das Projekt speichern und auf * Weiter * klicken.

Wenn Sie ein neues Projekt erstellen, wird es automatisch im Entwurfsmodus gespeichert. Projekte, bei denen es sich um Entwürfe handelt, sind nur für angemeldete administrative Benutzer sichtbar. Über die Registerkarten links von der Detailansicht Ihres Projekts können Sie eine Miniaturansicht hinzufügen, ein Heldenbild oder ein Banner für die öffentlich zugängliche Projektseite hochladen sowie Metadaten und zusätzliche Ressourcen hinzufügen.

Da Manifold Ihnen ein Repository für Texte zur Verfügung stellt, möchten Sie wahrscheinlich zuerst einen Text hinzufügen. Um die Textdatei in Ihr Projekt aufzunehmen, klicken Sie auf die Registerkarte * texts *.

image: https: //assets.digitalocean.com/articles/manifold/manifold_texts.png [Manifold Project Texts]

Sie können EPUBs, Markdown- und HTML-Dateien oder Google Docs in Manifold hochladen. Wenn Sie mit Google Text & Tabellen arbeiten möchten, müssen Sie https://manifoldapp.org/docs/customizing/settings/external_services/google/index.html eine zusätzliche Konfiguration vornehmen.] Zu Demonstrationszwecken laden wir das How To Code in Python 3 EPUB in unsere Manifold-Installation hoch. Über diesen Link können Sie direkt auf die EPUB des eBooks verlinken:

Um den Text einzublenden, klicken Sie auf die Schaltfläche * Neuen Text hinzufügen *, um den Aufnahmevorgang zu starten.

image: https://assets.digitalocean.com/articles/manifold/add_text.png [Text hinzufügen]

In unserer Demonstration verwenden wir den obigen Link. Sie können jedoch auch eine Datei auf das Cloud-Symbol hochladen oder ziehen, um eine Datei von Ihrer lokalen Festplatte hochzuladen. Wenn Sie die Datei bereitgestellt haben, können Sie * Weiter * drücken. Die App stellt eine Verbindung zum Manifold-Websocket her und Sie können jetzt auf * Ingest * klicken, um den Upload-Vorgang zu starten.

Abhängig von der Hosting-Umgebung und der Größe der Datei, die Sie hochladen, kann es einige Minuten dauern, bis Manifold den Text eingibt. Sie sollten ein Protokoll sehen, das die Statusausgabe der Aufnahme zeigt. Wenn dieser Vorgang abgeschlossen ist, wird unten im Dialogfeld die Schaltfläche "Fertig stellen" angezeigt.

image: https://assets.digitalocean.com/articles/manifold/ingestion_complete.png [Aufnahme abgeschlossen]

Sobald Sie auf die Schaltfläche * Fertig stellen * klicken, kehren Sie zu Ihrem Projekt zurück.

Ihr Text wird unter * UNCATEGORIZED * hinzugefügt. Verwenden Sie den Aufwärtspfeil, um die Datei in den Status * PUBLISHED * zu verschieben.

image: https://assets.digitalocean.com/articles/manifold/uncategorized_text.png [Nicht kategorisierter Text]

image: https://assets.digitalocean.com/articles/manifold/published_text.png [Veröffentlichter Text]

Klicken Sie auf den Link * PREVIEW * unter dem Projekttitel neben dem Augensymbol, um Ihr aktuelles Projekt anzuzeigen. Auf der Vorschauseite sollte unter dem Titel die Schaltfläche * LESEN STARTEN * angezeigt werden.

image: https://assets.digitalocean.com/articles/manifold/start_reading.png [Schaltfläche zum Starten des Lesens]

Sobald Sie diese Taste drücken, sollte sich der Text im Manifold-Reader öffnen.

image: https://assets.digitalocean.com/articles/manifold/manifold_reader.png [Manifold Reader Preview]

Wenn Sie mit Ihrem Projekt zufrieden sind, können Sie auf der Registerkarte * Allgemein * der Verwaltungsoberfläche die Sichtbarkeit umschalten, um den * Entwurfsmodus * zu deaktivieren.

image: https://assets.digitalocean.com/articles/manifold/visibility.png [Sichtbarkeit umschalten]

Jetzt sollte das Projekt auf Ihrer Hauptseite verfügbar sein.

image: https://assets.digitalocean.com/articles/manifold/final_with_project.png [Endgültiger Verteiler mit veröffentlichtem Projekt]

An diesem Punkt können Sie weiter an Ihrem Projekt arbeiten, um Metadaten, Bilder und mehr hinzuzufügen.

Beachten Sie, dass es empfehlenswert ist, Ihre Website zu schützen und über das HTTPS-Protokoll darauf zuzugreifen, wenn Sie eine Domain haben, die Ihrer Manifold-Seite zugeordnet ist, und erwarten, dass Benutzer Dateien beisteuern. Um mehr über das Sichern von Manifold mit der kostenlosen Zertifizierungsstelle Let’s Encrypt zu erfahren, lesen Sie unser Tutorial: "

Herzlichen Glückwunsch, Sie haben Ihre Manifold-Installation abgeschlossen und Ihr erstes Projekt erstellt! Sie sollten jetzt Manifold auf Ihrem Ubuntu 18.04-Server installiert haben. Wenn alles wie geplant gelaufen ist, sind Sie auf dem besten Weg, Ihre eigenen Projekte aufzubauen und Ihre eigenen Texte auf Manifold zu veröffentlichen.

Um mehr über das Manifold-Projekt, seine Entwicklung und die Universitätsdruckmaschinen zu erfahren, besuchen Sie die folgenden Links:

Wenn Sie während der Verwendung dieser Software auf Probleme stoßen, freut sich das Manifold-Team über Feedback. Sie können mit ihnen in Kontakt treten, indem Sie den Abschnitt getting support unter docs konsultieren.