Как создать текстовый пояснитель команд MacOS / * nix, используя этот инструмент?

┌── 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

Нашел этот полезный метод для объяснения команд Linux, но понятия не имею, как это сделал @grg . Вручную очень много времени. Есть ли инструмент для таких вещей?

Источник: Как я могу создать символическую ссылку в Терминале?

macos terminal unix Хардип Сингх
источник

Профиль ОП: apple.stackexchange.com/users/37797/grg

Хардип Сингх,

github.com/vain/explain

JBis

@JBis Я рекомендую добавить ответ, который, скорее всего, будет принят . Было бы лучше включить образец или что-то, чтобы сделать существенный ответ.

jpaugh

@jpaugh Подойдет.

JBis

Вы используете Linux на устройстве Apple? Эти команды работают и на macOS (например, macOS lsпроисходит от BSD Unix, а не Linux). Поэтому, если вы используете macOS или подобное, удалите слово «Linux» из вашего вопроса.

Qsigma

Ответы:

Это мой ответ! Я сделал это вручную, но использовал PressAndHold.app (встроенный в macOS), чтобы ускорить ввод символов рисования поля . Текст был сокращен со страницы руководства вручную.

Настраивая клавиши PressAndHold.app , в основном редактируя /System/L*/Inp*/Pr*/*/P*/*/*/R*/их, добавляя символы рисования в рамке, я могу вводить символы непосредственно в текстовое поле, будь то в SE или где-либо еще.

Добавьте следующее в файл клавиатуры вашего языка в этой папке, например, «Keyboard-en.plist» для английской раскладки клавиатуры. Откройте список с помощью текстового редактора, чтобы вставить приведенный ниже XML, или откройте с помощью XCode и вручную создайте словарь, вставляя значения по мере необходимости. Замените «f» ключом, который вы хотите использовать. Затем можно вставить символы рисования в поле, удерживая нажатой клавишу, а затем выбрав число, или, если у вас есть сенсорная панель, там также отображаются клавиши с 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
источник

Работал как шарм! После отключения SIP на моем MacOS Mojave в режиме восстановления я смог отредактировать Keyboard-en.plistфайл. Просто скопировал строковые теги и заменил их связыванием клавиш для «z», и все заработало! Большое спасибо, мужчина. Теперь это поможет гораздо большему количеству людей. Вы драгоценный камень! :)

Хардип Сингх

<string>─ │ ┌ ┐ └ ┘ ├ ┬ ┤ ┴ ┼</string>показывает 11 символов рисования прямоугольника, однако, изображение интерфейса PressAndHold.app показывает только 9 из них. Как вы получаете доступ к последним двум, 10 ┴и 11 ┼?

user3439894

@ user3439894 Нажав стрелку вниз на всплывающей подсказке. Первые 9: i.imgur.com/SK6I47e.png После нажатия стрелки вниз. Последние 2: i.imgur.com/yM5xoRC.png

Хардип Сингх,

@ Хардип Сингх, спасибо за информацию! Было бы неплохо, если бы в первоначальном ответе содержалась такая важная информация.

user3439894

@ user3439894 Я вырезал его из своего скриншота, потому что переключатель страниц находится только в Мохаве (High Sierra должен просто показать все ключи в строке) и потому что текущая кнопка в Мохаве выглядит неправильно (бета-ошибка, я уверен, будет исправлена ).

grg

Вы, вероятно, хотите использовать asciiflow.com

Я не могу больше добавить к этому ответу;)

С тех пор я обнаружил, что текст объяснения, кажется, взят с ExplainShell.com

djsmiley2k TMW
источник

Добро пожаловать в AD! Точно так же, как полезное замечание, ваш ответ, скорее всего, вызовет повышенный интерес, если вы объясните, как решение, которое вы предлагаете, отвечает на вопрос.

Аллан

ASCII Flow выглядит хорошо. Я обнаружил, что решение, предоставляемое @JBis, очень удобно, и у меня больше контроля над наборами символов, где, как и в потоке ASCII, я могу использовать только дефисы и символы "+".

Хардип Сингх

Я знаю один сайт, который делает это, и это https://explainshell.com/ . Между прочим, я только что понял, что код объяснения Shell доступен на GitHub:
https://github.com/idank/explainshell.
Я не знаю, как они в конечном итоге технически это делают, но они используют имя проекта с открытым исходным кодом "Показать Док "доступен здесь:
https://github.com/idank/showthedocs

Kiwy
источник