From a57fe3b0411c0d49b45ab7de9691c715e2dce337 Mon Sep 17 00:00:00 2001 From: ben Date: Tue, 4 Nov 2025 22:07:27 +0100 Subject: [PATCH] =?UTF-8?q?Am=C3=A9lioration=20de=20la=20documentation=20d?= =?UTF-8?q?e=20Hackademy=20Linux?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- hackademy.mdwn | 14 ++++++--- hackademy/file_transfert.mdwn | 8 +++--- hackademy/host_browser.mdwn | 5 ++-- hackademy/images.mdwn | 51 ++++++--------------------------- hackademy/packages.mdwn | 14 +++++++-- hackademy/url.mdwn | 8 +++--- wiki/shell/commands/DuckDB.mdwn | 2 +- wiki/shell/commands/Git.mdwn | 2 ++ 8 files changed, 44 insertions(+), 60 deletions(-) diff --git a/hackademy.mdwn b/hackademy.mdwn index 7b68567..76ffc57 100644 --- a/hackademy.mdwn +++ b/hackademy.mdwn @@ -6,11 +6,13 @@ Basé sur un environnement Linux émulé dans le navigateur, Hackademy Linux per La plateforme est personnalisable directement via l'URL afin de s'adapter à plusieurs scénarios et cas d'usage. -[[!note "Ce projet est en cours de développement et peut être très instable."]] +[[!note "Hackademy Linux est entièrement exécuté dans le navigateur via l'émulateur [v86](https://github.com/copy/v86). Le système de fichiers de la machine virtuelle est stocké dans la mémoire vive du navigateur. Actuellement, il n'est pas possible de sauvegarder l'état de la machine virtuelle ; un rechargement de la page réinitialise l'environnement. Aucune donnée n'est envoyée sur un serveur, tout se passe en local dans votre navigateur."]] + +[[!caution "Ce projet est en cours de développement et peut être très instable."]] ## Accès -Hackademy Linux est disponible à l'URL : [linux.hackade.org](https://linux.hackade.org) +Hackademy Linux est disponible à l’adresse : [linux.hackade.org](https://linux.hackade.org) Les identifiants pour se connecter sont "__user__" comme utilisateur et "__hackademy__" comme mot de passe. @@ -27,7 +29,11 @@ Il est également possible de se connecter sans s'identifier avec l'URL: [linux. * Accès au navigateur depuis la VM avec [host_browser](host_browser). * [Gestionnaire de paquets](packages). +## Applications + +* [Lab d'utilisation de Git](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBnaXQK) +* [Lab d'utilisation de DuckDB](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBkdWNrZGIK) +* [Lab d'utilisation de GnuPG](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBnbnVwZzIK) + -## Scénarios -.. à venir .. diff --git a/hackademy/file_transfert.mdwn b/hackademy/file_transfert.mdwn index 2f6057a..8b2b984 100644 --- a/hackademy/file_transfert.mdwn +++ b/hackademy/file_transfert.mdwn @@ -1,15 +1,15 @@ # Transfert de fichiers -Zmodem et [Trzsz](https://trzsz.github.io/go) sont supporté pour échanger des fichiers avec la VM. +[Zmodem](https://en.wikipedia.org/wiki/ZMODEM) et [Trzsz](https://trzsz.github.io/go) sont supporté pour échanger des fichiers avec la machine virtuelle. ## Zmodem -Il est disponible sur toutes les images et avec tous les navigateurs, grâce aux commandes __sz__ et __rz__. +Il est disponible sur l'image __Core__ et fonctionne avec tous les navigateurs, grâce aux commandes __sz__ (send) et __rz__ (receive). ## Trzsz -L'outil est disponible à partir de l'image "Minimal" avec les commandes __trz__ et __tsz__. +L'outil est disponible à partir de l'image __Minimal__ ou avec __opkg__ avec les commandes __tsz__ (send) et __tzz__ (receive). -Il a l'avantage de fonctionner au sein de tmux et d'afficher une progression. +Il a l'avantage de fonctionner dans une console tmux et d'afficher une progression. Fonctionne qu'avec un nombre réduit de navigateurs (voir [compatibilité](https://developer.mozilla.org/en-US/docs/Web/API/Window/showOpenFilePicker#browser_compatibility)). diff --git a/hackademy/host_browser.mdwn b/hackademy/host_browser.mdwn index 69596e1..ff29c31 100644 --- a/hackademy/host_browser.mdwn +++ b/hackademy/host_browser.mdwn @@ -1,7 +1,8 @@ # host_browser -Un canal de communication existe entre la machine virtuelle et le navigateur afin que la VM puisse interagir avec le navigateur. -La virtio_console est utilisée via le périphérique /dev/hvc0. +Un canal de communication existe afin qu'il soit possible d'interagir avec le navigateur depuis le shell. + +`host_browser` est disponible dans l'image __Core__ et permet d'utiliser ce canal. ``` Usage: host_browser [-h] diff --git a/hackademy/images.mdwn b/hackademy/images.mdwn index 991f329..ad362eb 100644 --- a/hackademy/images.mdwn +++ b/hackademy/images.mdwn @@ -1,47 +1,12 @@ # Images -[[!note "Les images sont en cours développements"]] +[[!caution "Les images sont en cours développements"]] -## Core +[[!table class="table" data=""" +Nom de l'image | Paramètres URL | Taille | Contenu | +Core | [disk=core](https://linux.hackade.org/?disk=core) | bzImage: 3M, initramfs: 1,7M | util_linux, lrzsz, opkg | +Minimal | [disk=minimal](https://linux.hackade.org/?disk=minimal) | squashfs overlay: 4,5M | \+ shell config, trzsz | +Basic | [disk=basic](https://linux.hackade.org/?disk=basic) | squashfs overlay: 9,5M | \+ sudo, tmux, vim | +Normal | [disk=normal](https://linux.hackade.org/?disk=normal) | squashfs overlay: 9,7M | \+ strace | +"""]] -Accessible avec le paramètre [disk=core](https://linux.hackade.org/?disk=core) c'est l'image la plus petite possible. Elle comprends le noyau Linux (3,0M) et l'initramfs (1,7M). - -Les paquets suivants sont disponibles: - -* util_linux -* lrzsz -* opkg - -## Minimal - -Taille: 4,5M - -C'est l'image par défaut si aucune image n'est paramétrée. C'est un overlay au-dessus de Core qui ajoute les éléments suivants: - -* La configuration du shell pour les utilisateurs root et user -* l'outil trzsz - -## Basic - -Taille: 9,5M - -Accessible avec le paramètre [disk=basic](https://linux.hackade.org/?disk=basic) c'est un overlay au dessus de Core qui ajoute les éléments suivants: - -* La configuration du shell pour les utilisateurs root et user -* trzsz -* sudo -* tmux -* vim - -## Normal - -Taille: 9,7M - -Accessible avec le paramètre [disk=normal](https://linux.hackade.org/?disk=normal) c'est un overlay au dessus de Core qui ajoute les éléments suivants: - -* La configuration du shell pour les utilisateurs root et user -* trzsz -* sudo -* tmux -* vim -* strace diff --git a/hackademy/packages.mdwn b/hackademy/packages.mdwn index bbfe3c5..9fc5297 100644 --- a/hackademy/packages.mdwn +++ b/hackademy/packages.mdwn @@ -2,6 +2,16 @@ Il est possible d'ajouter des paquets avec le gestionnaire __opkg__. -[[!note "La création des paquets est en cours de développement"]] +[[!caution "La création des paquets est en cours de développement"]] -[Listes des paquets](https://linux.hackade.org/Packages.txt) +[URL de fichier Packages](https://linux.hackade.org/Packages.txt) + +[[!table class="table" data=""" +Paquet | Version | Origine | Test | +DuckDB | 1.4.1 | Custom | OK | +Trzsz | 1.1.8 | Custom | OK | +Git | 2.50.1 | Buildroot | OK | +Tmux | 3.5 | Buildroot | OK | +Vim | 9.1 | Buildroot | OK | +GnuPG | 2.4.8 | Buildroot | OK | +"""]] diff --git a/hackademy/url.mdwn b/hackademy/url.mdwn index bba41e2..dafc023 100644 --- a/hackademy/url.mdwn +++ b/hackademy/url.mdwn @@ -15,11 +15,11 @@ La sélection de l'image se fait avec le paramètre __disk__. Les images disponi ## Login automatique -Le paramètre __autoLogin__ permet de se connecter directement à la VM au lancement. Trois options sont possibles : rien, user ou root. Par défaut l'autologin n'est pas activé. +Le paramètre __autoLogin__ permet de se connecter directement à la machine virtuelle au lancement. Trois options sont possibles : rien, user ou root. Par défaut l'autologin n'est pas activé. ## Démarrage automatique -Le paramètre __autostart__ permet d'indiquer si au chargement de la page, la VM doit démarrer. Par défaut le démarrage est automatique. +Le paramètre __autostart__ permet d'indiquer si au chargement de la page, la machine virtuelle doit démarrer. Par défaut le démarrage est automatique. ## Script d'initialisation personnalisé @@ -38,10 +38,10 @@ Lorsque __custom_init__ est paramétré, __autostart__ est automatiquement désa Exemple avec le script suivant: ```sh -#!/bin/sh +#!/bin/sh -l echo "Here's an example of the custom_init functionality." opkg update && opkg install tmux ``` -[https://linux.hackade.org/?custom_init=IyEvYmluL3NoCgplY2hvI...](https://linux.hackade.org/?custom_init=IyEvYmluL3NoCgplY2hvICJIZXJlJ3MgYW4gZXhhbXBsZSBvZiB0aGUgY3VzdG9tX2luaXQgZnVuY3Rpb25hbGl0eS4iCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCB0bXV4Cg) +[https://linux.hackade.org/?custom_init=IyEvYmluL3NoCgplY2hvI...](https://linux.hackade.org/?custom_init=IyEvYmluL3NoIC1sCmVjaG8gIkhlcmUncyBhbiBleGFtcGxlIG9mIHRoZSBjdXN0b21faW5pdCBmdW5jdGlvbmFsaXR5LiIKb3BrZyB1cGRhdGUgJiYgb3BrZyBpbnN0YWxsIHRtdXgK) diff --git a/wiki/shell/commands/DuckDB.mdwn b/wiki/shell/commands/DuckDB.mdwn index 421c814..13611ba 100644 --- a/wiki/shell/commands/DuckDB.mdwn +++ b/wiki/shell/commands/DuckDB.mdwn @@ -1,6 +1,6 @@ # DuckDB dans un script shell -[Lab Hackademy Linux](https://linux.hackade.org/?custom_init=IyEvYmluL3NoCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBkdWNrZGIK) +[Expérimentez DuckDB dans votre navigateur avec Hackademy Linux](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBkdWNrZGIK) ## Créer une base de donnée: diff --git a/wiki/shell/commands/Git.mdwn b/wiki/shell/commands/Git.mdwn index eea3af8..61725fd 100644 --- a/wiki/shell/commands/Git.mdwn +++ b/wiki/shell/commands/Git.mdwn @@ -1,5 +1,7 @@ # Git +[Expérimentez Git dans votre navigateur avec Hackademy Linux](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBnaXQK) + ## Exécuter git depuis un autre répertoire que celui du dépôt: ```