SVG

aasvg

aasvg est un outil en ligne de commande qui convertit des dessins en ASCII art (faits avec des caractères texte) en images vectorielles SVG, permettant de visualiser ou intégrer facilement des schémas simples dans des documents ou sur le web.

---

🛠️ Installation de aasvg

sudo apt install aasvg

Cela installera aussi les dépendances nécessaires, notamment Node.js.

---

🖼️ Utilisation de base

aasvg prend un fichier texte contenant un dessin en ASCII et le convertit en SVG :

aasvg < dessin.txt > dessin.svg

Tu peux ensuite ouvrir le fichier SVG dans un navigateur ou un éditeur d’images vectorielles comme Inkscape.

---

⚙️ Options expliquées simplement

Voici les principales options que tu peux utiliser :

Option	Description simple
--stretch	Étire le dessin pour qu’il remplisse mieux l’espace du SVG.
--fill	Supprime les dimensions fixes (width et height) du SVG.
--spaces=<n>	Sépare les blocs de texte après n espaces (par défaut 2). 0 = chaque caractère.
--grid	Ajoute une grille pour t’aider à visualiser l’alignement (utile pour le debug).
--backdrop	Ajoute un fond blanc derrière le dessin.
--source	Superpose le texte source sur le SVG.
--disable-text	Désactive le rendu du texte brut.
--width=<n>	Définit la largeur du SVG en nombre de caractères.
--height=<n>	Définit la hauteur du SVG en nombre de caractères.
--<attr>=<value>	Permet de définir un attribut SVG personnalisé.

---

💡 Exemple complet

Fichier schema.txt :

+-------+
| Hello |
+-------+

Commande :

aasvg --stretch --fill < schema.txt > schema.svg

Cela génère un SVG sans dimensions fixes, avec un rendu plus fluide du dessin ASCII.

a2s

Le package a2s (issu de github.com/asciitosvg/asciitosvg/cmd/a2s) est un outil en ligne de commande qui permet de :

✨ Convertir du texte ASCII en SVG

Autrement dit, il prend des diagrammes ASCII (comme ceux qu’on écrit dans les fichiers Markdown ou dans les commentaires de code) et les transforme en images vectorielles SVG.

---

🔧 Utilité principale

• Documentation technique : convertir des schémas ASCII en images lisibles pour les inclure dans des pages web ou des PDF.
• Automatisation : intégrer dans des scripts pour générer des visuels à partir de diagrammes textuels.
• Visualisation rapide : utile pour les développeurs qui utilisent des diagrammes ASCII dans leurs outils ou leurs README.

---

✅ Étapes d’installation

1. Installer Go

Si Go n’est pas encore installé :

sudo apt update
sudo apt install golang-go

Vérifie l’installation avec go version.

---

2. Installer le package a2s

Utilise la commande suivante pour installer le binaire dans le répertoire Go par défaut ($HOME/go/bin) :

go install github.com/asciitosvg/asciitosvg/cmd/a2s@latest

Cela crée un exécutable nommé a2s dans ~/go/bin.

---

3. Déplacer l’exécutable dans un répertoire global

Pour le rendre accessible à tous les utilisateurs :

sudo mv ~/go/bin/a2s /usr/local/bin/

/usr/local/bin est généralement dans le PATH de tous les utilisateurs.

---

4. Vérification

Teste l’installation :

a2s --help

Autres Ressources

Pour convertir facilement des images en SVG
github.com/martinthomson/aasvg