ben/wiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Amélioration de la documentation de Hackademy Linux

Browse Source
This commit is contained in:
ben
2025-11-04 22:07:27 +01:00
parent 3c01244a36
commit a57fe3b041
8 changed files with 44 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
hackademy.mdwn
View File

@@ -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 ..

8
hackademy/file_transfert.mdwn
View File

@@ -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)).

5
hackademy/host_browser.mdwn
View File

@@ -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]

51
hackademy/images.mdwn
View File

@@ -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

14
hackademy/packages.mdwn
View File

@@ -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 |
"""]]

8
hackademy/url.mdwn
View File

@@ -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)

2
wiki/shell/commands/DuckDB.mdwn
View File

@@ -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:

2
wiki/shell/commands/Git.mdwn
View File

@@ -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:
```