Comment installer et configurer un collecteur

Manifold est une application Web à source ouverte qui vous permet de publier des éditions Web de livres et d’autres supports basés sur du texte afin que les utilisateurs puissent lire et annoter librement ces textes. Particulièrement adapté pour être utilisé avec du matériel en libre accès et des ressources éducatives libres, Manifold peut être intégré dans les salles de classe, codage des camps d’entraînement, ateliers, bibliothèques et autres lieux où vous souhaiterez peut-être échanger des connaissances grâce à la lecture collaborative.

Fondé par la Fondation Mellon, Manifold a été conçu à l’origine pour la monographie scientifique, mais de nombreuses formes d’édition (revues, pamphlets, collections) peuvent être rassemblées, organisées, lues et annotées sur la plate-forme. Pour voir un exemple de livre Manifold, vous pouvez consulter la version Manifold du livre électronique gratuit _https: //cuny.manifoldapp.org/projects/how-to-code-in-python-3 [How To Code in Python 3] _.

Dans ce didacticiel, nous allons configurer Manifold sur un serveur et ajouter un texte à votre installation.

Pour commencer, vous devriez avoir les éléments suivants:

Pour que Collecteur fonctionne sur un site Web avec une URL, vous devez configurer un nom de domaine complet. Pour des conseils sur la configuration, vous devriez lire la documentation de votre fournisseur d’hébergement. Si vous utilisez DigitalOcean, vous trouverez des conseils dans notre didacticiel à l’adresse How To Pointez sur les serveurs de noms DigitalOcean à partir des registres de domaine commun.

Si votre nom de domaine n’est pas encore configuré pour le moment, vous pouvez définir le nom d’hôte manuellement dans + / etc / manifold / manifold.rb + et reconfigurer l’application. La reconfiguration est discutée ci-dessous.

Avec ces conditions préalables en place, vous pouvez commencer le didacticiel.

Nous téléchargerons Manifold pour Ubuntu 18.04.

Tout d’abord, déplacez-vous dans le répertoire temporaire pour télécharger le package, ce dernier pouvant être supprimé ultérieurement.

Ensuite, utilisez la commande + curl + avec l’indicateur + -O + pour écrire la sortie dans un fichier local. Cela téléchargera le paquet sur notre serveur.

Ensuite, nous installerons le paquet.

Lorsque vous exécutez cette commande, vous devriez recevoir une sortie comprenant les lignes suivantes:

Une fois que vous avez reçu ces lignes, vous pouvez passer à l’étape suivante.

Si vous avez suivi la configuration initiale du serveur, vous devez installer un pare-feu + ufw + sur votre serveur. Si vous n’avez pas de pare-feu en place, vous devez implémenter un pare-feu en suivant les instructions https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-18-04#step-4. -% E2% 80% 94-configuration d’un pare-feu de base [Etape de la configuration d’un pare-feu de base] du guide de configuration initiale du serveur.

Pour autoriser le trafic via + http + sur le Web, vous devez ouvrir le port 80.

Vous devriez recevoir le résultat que cette règle a été ajoutée. Vous pouvez vérifier l’état de votre pare-feu en tapant + sudo ufw status pour voir les règles actuelles sur votre serveur.

Si vous avez déjà configuré un nom de domaine pleinement qualifié sur ce serveur, vous n’aurez peut-être pas besoin de faire plus de configuration. Cela sera vrai si vous avez reçu le résultat suivant qui correspond à votre nom de domaine:

Si, toutefois, vous utilisez actuellement l’adresse IP du serveur ou si le résultat ci-dessus ne correspond pas à votre URL, vous pouvez configurer Manifold pour qu’il pointe vers le bon emplacement.

Un fichier a été créé sur + / etc / manifold / manifold.rb + que vous utiliserez pour configurer et gérer les différents services qui composent Manifold.

Ouvrez ce fichier dans votre éditeur de texte préféré (nous utiliserons nano).

Dans ce fichier, recherchez le paramètre + external_url + situé en haut du fichier. Définissez cette option sur l’adresse IP de votre serveur ou sur le nom de domaine de votre installation Manifold.

etc / manifold / manifold.rb

Si votre site web est + example.com +, votre ligne devrait ressembler à ceci:

Si votre IP est + 192.0.2.0 +, votre ligne devrait ressembler à ceci:

Maintenant, enregistrez et quittez le fichier. Pour ce faire, appuyez sur les touches + CTRL + + + + X + , puis + y + pour confirmer que vous souhaitez l’enregistrer, puis + ENTER + `.

À ce stade, vous pouvez reconfigurer Manifold à l’aide de la commande suivante.

L’application Manifold va maintenant implémenter les modifications apportées dans ce fichier pour régénérer les nouveaux paramètres et les fichiers de configuration. Ce processus sera terminé lorsque vous recevrez une sortie similaire à celle-ci:

Vous pouvez maintenant visiter l’URL ou l’adresse IP de votre serveur. Vous devriez voir une page d’accueil Manifold vide.

image: https: //assets.digitalocean.com/articles/manifold/manifold_home_page.png [Page d’accueil du collecteur]

Avec l’application Manifold en cours de traitement, vous pouvez passer à l’étape suivante.

Tout le contenu stocké dans Manifold (y compris les textes, projets, auteurs, ressources et utilisateurs) est géré via l’interface Web d’arrière-plan de Manifold via le chemin + / backend +.

Pour accéder au backend, vous devrez créer un utilisateur administratif sur votre serveur. Vous allez appeler une commande pour créer cet utilisateur administratif via l’exécutable + manifold-api.

Pour utiliser cette commande, vous devez entrer vos propres informations, notamment votre adresse électronique, votre mot de passe, votre prénom et votre nom de famille, au format suivant:

Remplacez vos propres informations dans la commande ci-dessus, comme dans l’exemple suivant:

Une fois la commande exécutée, vous recevrez une sortie similaire à celle-ci:

Une fois que vous avez créé cet utilisateur, retournez dans votre navigateur et cliquez sur l’icône de l’avatar dans le coin supérieur droit de Manifold pour vous connecter.

image: https: //assets.digitalocean.com/articles/manifold/manifold_login.png [Connexion au manifold]

Une fois que vous avez entré vos informations d’identification et que vous vous êtes connecté avec succès, un bouton * ENTRER MODE ADMIN * apparaît dans l’en-tête.

image: https: //assets.digitalocean.com/articles/manifold/enter_admin_mode.png [Mode administrateur du manifold]

Cliquez sur ce bouton pour accéder au backend du collecteur.

À partir du backend, vous serez dirigé vers l’emplacement de vos projets futurs.

image: https: //assets.digitalocean.com/articles/manifold/projects_list.png [Liste des projets Manifold]

Pour créer un nouveau projet, cliquez sur * Projets * dans la barre de menu supérieure, puis sur le bouton * Ajouter un nouveau projet *. Vous serez invité à entrer un titre et un sous-titre et une description facultatifs. À des fins de démonstration, vous pouvez télécharger le livre électronique gratuit _https: //www.do.co/python-book [How To Code en Python 3] _, de sorte que vous puissiez entrer + How To Code in Python 3 + .

Une fois ces informations saisies, vous pouvez enregistrer le projet et appuyer sur * Continuer *.

Lorsque vous créez un nouveau projet, il est automatiquement enregistré en mode draft. Les projets qui sont des brouillons ne sont visibles que par les utilisateurs administratifs connectés. À l’aide des onglets situés à gauche de la vue détaillée de votre projet, vous pouvez ajouter une vignette, télécharger une image de héros ou une bannière pour la page de projet destinée au public, ainsi que ajouter des métadonnées et des ressources supplémentaires.

Comme Manifold vous fournit un référentiel pour les textes, la première chose que vous voudrez probablement faire est d’ajouter un texte. Pour ingérer le fichier texte dans votre projet, cliquez sur l’onglet * textes *.

image: https: //assets.digitalocean.com/articles/manifold/manifold_texts.png [Textes du projet de manifold]

Vous pouvez télécharger des fichiers EPUB, Markdown et HTML, ou Google Docs dans Manifold. Si vous envisagez de travailler avec Google Documents, vous devrez effectuer https://manifoldapp.org/docs/customizing/settings/external_services/google/index.html]. À des fins de démonstration, nous allons télécharger le fichier How To Code in Python 3 EPUB dans notre installation Manifold. Vous pouvez accéder directement à l’EPUB de l’eBook à l’aide de ce lien:

Pour importer le texte, cliquez sur le bouton * Ajouter un nouveau texte * pour commencer le processus d’ingestion.

image: https: //assets.digitalocean.com/articles/manifold/add_text.png [Ajouter du texte]

Dans notre démonstration, nous utiliserons le lien ci-dessus, mais vous pouvez également télécharger ou faire glisser un fichier sur l’icône cloud pour télécharger un fichier à partir de votre disque dur local. Une fois le fichier mis en scène, vous pouvez appuyer sur * Continuer *. L’application se connectera au Manifold Websocket, et vous pouvez maintenant cliquer sur * Ingest * pour commencer le processus de téléchargement.

Selon l’environnement d’hébergement et la taille du fichier que vous téléchargez, l’assemblage du texte peut prendre quelques minutes. Vous devriez voir un journal indiquant l’état de sortie de l’ingestion. Une fois ce processus terminé, vous verrez un bouton * Terminer * au bas de la boîte de dialogue.

image: https: //assets.digitalocean.com/articles/manifold/ingestion_complete.png [Ingestion terminée]

Une fois que vous avez appuyé sur le bouton * Terminer *, vous revenez à votre projet.

Votre texte sera ajouté sous * UNCATEGORIZED *. Utilisez la flèche vers le haut pour déplacer le fichier dans l’état * PUBLISHED *.

image: https: //assets.digitalocean.com/articles/manifold/uncategorized_text.png [Texte sans catégorie]

image: https: //assets.digitalocean.com/articles/manifold/published_text.png [Texte publié]

Cliquez sur le lien * PREVIEW * sous le titre du projet, à côté de l’icône représentant un œil, pour afficher votre projet actuel. Du côté de l’aperçu, vous devriez voir un bouton * START READING * sous le titre.

image: https: //assets.digitalocean.com/articles/manifold/start_reading.png [Bouton Démarrer la lecture]

Une fois que vous avez appuyé sur ce bouton, le texte devrait s’ouvrir dans le lecteur de manifold.

image: https: //assets.digitalocean.com/articles/manifold/manifold_reader.png [Aperçu du lecteur de manifold]

Lorsque vous êtes satisfait de votre projet, à partir de l’onglet * Général * de l’interface administrative, vous pouvez basculer la visibilité pour désactiver le * Mode brouillon *.

image: https: //assets.digitalocean.com/articles/manifold/visibility.png [Basculer la visibilité]

Maintenant, le projet devrait être disponible sur votre page principale.

image: https: //assets.digitalocean.com/articles/manifold/final_with_project.png [Collecteur final avec projet publié]

À ce stade, vous pouvez continuer à travailler sur votre projet pour ajouter des métadonnées, des images, etc.

Notez que si vous avez un domaine associé à votre page Manifold et attendez des utilisateurs qu’ils contribuent des fichiers, il est recommandé de sécuriser votre site Web et d’y accéder via le protocole HTTPS. Pour en savoir plus sur la sécurisation de Manifold avec l’autorité de certification gratuite Let’s Encrypt, lisez notre tutoriel, «https://www.digitalocean.com/community/tutorials/an-inintroduction-to-let-s-encrypt[An Introduction à Let’s Encrypt] ”

Félicitations, vous avez terminé votre installation Manifold et créé votre premier projet! Manifold devrait maintenant être installé sur votre serveur Ubuntu 18.04. Si tout se passe comme prévu, vous êtes sur la bonne voie pour construire vos propres projets et publier vos propres textes sur Manifold.

Pour en savoir plus sur le projet Manifold, son développement et les pressions de l’université qui l’utilise, consultez les liens suivants:

Si vous rencontrez des problèmes lors de l’utilisation de ce logiciel, l’équipe Manifold sera heureuse de recevoir vos commentaires. vous pouvez les contacter en consultant la section de support getting de leur docs.