Comment créer un texte explicatif de commande MacOS / * nix comme celui-ci à l'aide d'un outil?

┌── ln(1) link, ln -- make links
│   ┌── Create a symbolic link.
│   │                         ┌── the optional path to the intended symlink
│   │                         │   if omitted, symlink is in . named as destination
│   │                         │   can use . or ~ or other relative paths
│   │                   ┌─────┴────────┐
ln -s /path/to/original /path/to/symlink
      └───────┬───────┘
              └── the path to the original file/folder
                  can use . or ~ or other relative paths

J'ai trouvé cette méthode utile pour expliquer les commandes Linux, mais je ne sais pas comment @grg l'a fait. Manuellement prend beaucoup de temps. Existe-t-il un outil pour faire des choses comme ça?

Source: Comment créer un lien symbolique dans Terminal?

macos terminal unix

— Hardeep Singh
source

Profil d'OP: apple.stackexchange.com/users/37797/grg

— Hardeep Singh

github.com/vain/explain

— JBis

@JBis Je recommande d'ajouter une réponse, qui sera probablement acceptée . Il serait préférable d'inclure un échantillon ou quelque chose, pour apporter une réponse substantielle.

— jpaugh

@jpaugh fera l'affaire.

— JBis

Utilisez-vous Linux sur un appareil Apple? Ces commandes fonctionnent également sur macOS (par exemple, les macOS lsproviennent de BSD Unix et non de Linux). Donc, si vous utilisez macOS ou similaire, veuillez supprimer le mot «Linux» de votre question.

— Qsigma

Réponses:

Voilà ma réponse! Je l'ai fait manuellement, mais j'ai utilisé PressAndHold.app (intégré à macOS) pour accélérer la saisie des caractères de dessin de la boîte . Le texte a été abrégé de la page de manuel manuellement.

En personnalisant les touches PressAndHold.app , essentiellement en modifiant /System/L*/Inp*/Pr*/*/P*/*/*/R*/pour ajouter des caractères de dessin de boîte, je peux taper les caractères directement dans le champ de texte, ici sur SE ou ailleurs.

Ajoutez ce qui suit au fichier de clavier de votre langue dans ce dossier, tel que «Keyboard-en.plist» pour une disposition de clavier en anglais. Ouvrez le plist avec un éditeur de texte pour coller le XML ci-dessous, ou ouvrez-le avec Xcode et créez manuellement le dictionnaire, en collant les valeurs si nécessaire. Remplacez «f» par la clé que vous souhaitez utiliser. Vous pouvez ensuite insérer des caractères de dessin de boîte en maintenant la touche enfoncée, puis en sélectionnant un nombre, ou si vous avez une barre tactile, les touches y apparaissent également avec High Sierra .

<!-- f: box drawing characters -->
<key>Roman-Accent-f</key>
<dict>
  <key>Direction</key>
  <string>right</string>
  <key>Keycaps</key>
  <string>─ │ ┌ ┐ └ ┘ ├ ┬ ┤ ┴ ┼</string>
  <key>Strings</key>
  <string>─ │ ┌ ┐ └ ┘ ├ ┬ ┤ ┴ ┼</string>
</dict>

— grg
source

A fonctionné comme un charme! Après avoir désactivé SIP sur mon MacOS Mojave en mode de récupération, j'ai pu modifier le Keyboard-en.plistfichier. Il suffit de copier les balises de chaîne et de les remplacer par le raccourci clavier pour "z" et de travailler! Merci beaucoup mec. Cela aidera beaucoup plus de gens à partir de maintenant. Vous êtes un joyau! :)

— Hardeep Singh

<string>─ │ ┌ ┐ └ ┘ ├ ┬ ┤ ┴ ┼</string>montre 11 caractères de dessin de boîte cependant, l'image de l'interface PressAndHold.app n'en montre que 9 d'entre eux. Comment accédez-vous aux deux derniers, 10 ┴et 11 ┼?

— user3439894

@ user3439894 En cliquant sur la flèche vers le bas de l'infobulle. 9 premiers: i.imgur.com/SK6I47e.png Après avoir cliqué sur la flèche vers le bas 2 derniers: i.imgur.com/yM5xoRC.png

— Hardeep Singh

@Hardeep Singh, merci pour l'information! Cela aurait été bien si la réponse originale avait inclus des informations aussi importantes.

— user3439894

@ user3439894 Je l'ai coupé de ma capture d'écran car le sélecteur de page est uniquement dans Mojave (High Sierra devrait simplement afficher toutes les clés sur une ligne) et parce que le bouton actuel dans Mojave semble incorrect (un bêta bêta, je suis sûr, sera corrigé ).

— grg

Vous souhaitez probablement utiliser asciiflow.com

Je ne peux pas vraiment ajouter plus à cette réponse;)

J'ai depuis constaté que le texte d'explication semble être tiré d' ExplainShell.com

— djsmiley2k TMW
source

Bienvenue chez AD! Tout comme une observation utile, votre réponse est susceptible de susciter un intérêt accru si vous expliquez comment la solution que vous proposez répond à la question.

— Allan

ASCII Flow a l'air bien. J'ai découvert que la solution fournie par @JBis est très pratique et j'ai plus de contrôle sur les jeux de caractères où, comme dans le flux ASCII, je ne peux utiliser que des tirets et des symboles "+".

— Hardeep Singh

Je connais un site qui fait cela et c'est https://explainshell.com/ . Soit dit en passant, je viens de réaliser que le code d'explicationShell est disponible sur GitHub:
https://github.com/idank/explainshell
Je ne sais pas comment ils finissent techniquement par le faire, mais ils utilisent un nom de projet open source "Show The Doc "disponible ici:
https://github.com/idank/showthedocs

— Kiwy
source