first commit

docs/ruby.md

@@ -0,0 +1,68 @@
+# Ruby avec rbenv depuis SlackBuilds.org
+
+> Nécessite `sbopkg`.
+
+Slackware 15.0 fournit Ruby 3.0.7. Si vous souhaitez utiliser une version plus récente sans remplacer le paquet système, installez `rbenv` et `ruby-build` depuis SlackBuilds.org :
+
+```sh
+# sbopkg -i rbenv
+# sbopkg -i ruby-build
+```
+
+Initialisez ensuite `rbenv` pour votre shell :
+
+```sh
+$ rbenv init
+```
+
+La commande ajoute automatiquement l'initialisation nécessaire au fichier de démarrage de Bash. Déconnectez-vous puis reconnectez-vous à votre session pour prendre en compte la modification.
+
+Vérifiez que les outils sont bien disponibles :
+
+```sh
+$ rbenv --version
+$ ruby-build --version
+```
+
+Vous pouvez maintenant afficher les versions de Ruby disponibles :
+
+```sh
+$ rbenv install -l
+```
+
+Installez ensuite celle que vous souhaitez utiliser, par exemple :
+
+```sh
+$ rbenv install 4.0.7
+```
+
+Pour en faire la version par défaut pour votre utilisateur :
+
+```sh
+$ rbenv global 4.0.7
+```
+
+## Vérification
+
+Vérifiez enfin la version utilisée :
+
+```sh
+$ ruby -v
+$ command -v ruby
+```
+
+Avec `rbenv` actif, `ruby` doit normalement pointer vers :
+
+```text
+/home/<utilisateur>/.rbenv/shims/ruby
+```
+
+Le Ruby fourni par Slackware reste installé dans `/usr/bin/ruby`. `rbenv` ne remplace pas le paquet système : il place simplement ses propres *shims* en tête du `PATH` pour le shell de l'utilisateur.
+
+Pour vérifier séparément la version système :
+
+```sh
+$ /usr/bin/ruby -v
+```
+
+[Retour au guide principal](../README.md)