inklewriter

Remarque importante : la technique décrite ici ne fonctionne pas pour l’instant sur Raspberry Pi. Mais nous y travaillons !

C’est vraiment un plaisir de fournir inkwriter en tant que service pour tout le monde. En tant qu’utilisateur, c’est vraiment génial de se connecter au service et d’écrire une nouvelle histoire sans avoir à gérer tous les problèmes d’hébergement.

Et Inklewriter est tellement facile à utiliser que de nombreux enseignants l’utilisent à des fins éducatives. Et Inklewriter est absolument génial pour ça. Regarder un groupe d’enfants de 10 ans sortir de nulle part des histoires interactives folles devrait vraiment faire partie de votre TOP 100 des choses à faire dans la vie.

Mais il semble que, parfois, un service en ligne n’est pas la meilleure option. Surtout pour les enseignants.

Pour des raisons de sécurité légitimes, certaines écoles limitent l’accès à Internet, et c’est pourquoi nous souhaitons vous expliquer comment exécuter Inklewriter par vous-même.

Inklewriter est libre de fonctionner sur n’importe quel ordinateur portable ou ordinateur

Si vous pensez qu’on blague, ce n’est pas le cas.

Depuis que Inkle Studios a libéré le code, Inklewriter est un logiciel libre, ce qui signifie que vous pouvez le télécharger, l’étudier, le modifier et même le distribuer.

Maintenant, si vous êtes sur Internet depuis assez longtemps, vous savez qu’il y a un hic.

Gratuit à installer, pas toujours facile à installer.

Ce qui est en quelque sorte vrai dans le cas d’Inklewriter, car l’installation présente un certain niveau de difficulté.

Voici donc les objectifs d’apprentissage que nous détaillerons dans cet article de blog.

1. Comment exécuter Docker sous Windows
2. Comment exécuter Docker sous Linux
3. Comment exécuter Inklewriter à l’aide d’un fichier de composition
4. Comment accéder au service Inklewriter à partir d’autres ordinateurs / tablettes / etc.

1. Comment exécuter Docker sous Windows

Pour distribuer Inklewriter, nous utilisons une technologie très courante appelée « Docker ».

Docker est vraiment cool, car une fois que vous avez téléchargé une image Docker comme Inklewriter, vous n’avez plus rien à installer : votre téléchargement contient tout le code et les configurations nécessaires, prêts à être exécutés.

Pourtant, il y a un hic. Docker ne fonctionne pas très bien sous Windows.

Vous pouvez essayer d’installer Docker Desktop en utilisant la documentation officielle.

S’il s’installe bien, tant mieux pour vous !

Continuez à lire le 3ème objectif de l’article, le fonctionnement sera similaire sur Windows et Linux.

2. Comment exécuter Docker sous Linux

Généralement, le problème principal est « Comment faire fonctionner Linux ».

La solution est en fait assez simple. Vous devez l’installer.

Vous avez deux choix :

1. Installation sur le lecteur principal
2. Installation sur une clé USB

2.1 Installation de Linux sur le disque principal

L’installation de Linux est plus facile sur le disque principal d’un ordinateur, mais il nécessite que vous déléguiez entièrement un ordinateur portable (par exemple) au système Linux, à moins que vous n’utilisiez le Dual Boot si vous en avez envie.

C’est votre choix ? Super. Rendez-vous sur la page Comment installer de la dstribution grand public Ubuntu et suivez leurs instructions.

En gros, on vous indiquera comment copier un fichier ISO sur une clé USB, démarrer sur cette clé et sélectionner le disque de l’ordinateur comme cible d’installation.

2.2 Installer Linux sur une clé USB

C’est un peu plus complexe, car cela nécessite plus de connaissances, notamment pour peaufiner le menu du BIOS de l’ordinateur.

Pourtant, l’avantage est que vous pouvez conserver le système d’exploitation existant (vraisemblablement Windows) sur l’ordinateur sans le modifier.

Maintenant, le truc bizarre, c’est qu’il faut que vous utilisiez deux clés USB.

Vous préparerez la première clé comme expliqué dans le paragraphe ci-dessus, mais vous ne sélectionnerez pas le disque dur ou le SSD de l’ordinateur comme cible d’installation ! C’est la deuxième clé que vous ciblerez!

Et une fois l’installation terminée, cette deuxième clé sera bootable.

En fait, vous pourriez utiliser la capacité « Live USB » de votre clé Ubuntu, mais tout ce que vous installerez sera perdu lors de la réinitialisation, y compris vos histoires. C’est pourquoi l’installation d’un système réel est nécessaire.

Voici un article qui explique le processus. Ce n’est pas si dur.

Vous devrez maintenant installer Docker sur l’ordinateur Linux.

Docker a des pages d’aide pour cela, pour Ubuntu ou pour LinuxMint.

Ce n’est pas difficile, mais vous devez exécuter une console / un terminal – vous savez ce truc où vous tapez du texte et vous vous sentez comme un hacker – et demandez des commandes comme

sudo apt install
sudo apt installer docker.io

Comment exécuter Inklewriter à l’aide d’un fichier de composition

On touche à notre objectif principal, accrochez-vous, d’autant que maintenabt que que vous avez installé Docker, vous avez presque terminé, car il n’y a que deux choses à faire.

3.1 Télécharger le fichier docker-compose.yml Inklewriter

Le fichier peut être trouvé ici et son contenu ressemble à ceci.

version: '2'

volumes:
inkledb:
external: false

services:

db:
env_file: .env
image: postgres
volumes:
- inkledb:/opt

app:
env_file: .env
image: albancrommer/inklewriter:latest
ports:
- "3000:3000"
depends_on:
- db

Nous vous recommandons de créer un nouveau dossier et d’y copier ce fichier en utilisant le nom docker-compose.yml et pas un autre, sinon docker ne le reconnaîtra pas par défaut.

3.2 Exécutez la commande docker-compose

Utilisez un terminal et accédez au dossier contenant le fichier docker-compose.yml. Si vous utilisez Docker sous Windows, le processus est le même, mais vous devez utiliser le terminal Windows ou PowerShell.

La commande à lancer dans votre terminal est :

docker-compose up

Vous aurez besoin d’avoir accès à Internet à ce stade (et pas plus tard) car l’ordinateur téléchargera des images pour exécuter le service : une image Inklewriter avec le code et une image Postgres pour la base de données.

Une fois que c’est fait et que vous voyez des lignes avec des horodatages et des messages bizarres en anglais, le service devrait avoir démarré.

Vous pouvez utiliser votre navigateur pour y accéder sur http://localhost:3000

Et voilà ! Vous venez de voir la page d’accueil d’Inklewriter ! Bien sûr, il n’enverra aucun e-mail pour la récupération du mot de passe et des choses comme ça, mais cela devrait suffire à un enseignant pour travailler avec ses élèves.

4. Comment accéder au service Inklewriter à partir d’autres ordinateurs / tablettes / etc.

Maintenant, vous avez installé Inklewriter sur un ordinateur. Comment vos élèves y accèdent-ils depuis d’autres ordinateurs ?

Mais bien sûr ce n’est pas un problème si vous leur demandez d’utiliser directement l’ordinateur sur lequel le service est exécuté, ou si vous avez suffisamment de temps et d’ordinateurs portables pour l’installer sur chacun d’eux.

Si vous avez besoin de connecter les élèves au service Inklewriter d’un ordinateur central, il est nécessaire qu’ils soient sur le même réseau local.

Vous et vos élèves aurez donc probablement besoin de partager un réseau WIFI pour que leurs ordinateurs puissent « voir » le vôtre.

Vos élèves auront besoin de connaître l’IP de votre ordinateur pour s’y connecter. Voici comment le trouver.

Sous Windows

1. Cliquez sur Démarrer > Paramètres > Réseau et Internet > Wi-Fi, puis sélectionnez le réseau Wi-Fi auquel vous êtes connecté. Lisez l’IPv4 sous Propriétés
2. À l’aide de l’invite de commande ou de Powershell, tapez la commande ipconfig

Sous Linux, en utilisant la ligne de commande

ip -br -c un

va sortir quelque chose comme ça

lo               UNKNOWN        127.0.0.1/8 ::1/128 
wlo1             UP             192.168.1.105/24 fe80::c2a5:22df:6aea:ea3f/64 

L’adresse IP que vous recherchez est quelque chose comme 192.168.1.105 mais ce n’est qu’un exemple, et cela peut dépendre de votre réseau local.

Maintenant que vous avez l’adresse IP de votre ordinateur, il est temps pour les autres de s’y connecter

L’URL qu’ils utiliseront est simplement l’adresse IP avec le «port» spécial 3000 qui lui est attaché. Suite à notre précédent exemple Linux, ce serait :

http://192.168.1.105:3000

Si tout se passe bien, vos élèves devraient voir l’interface Inklewriter.

Hourra! Excitation! Joie! C’est parti pour de nouvelles histoires interactives !