Como criar um texto explicativo de comandos no MacOS / * nix como este usando uma ferramenta?

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

Encontrei este método útil para explicar os comandos do Linux, mas não faço ideia de como o @grg fez isso. Manualmente consome muito tempo. Existe uma ferramenta para fazer coisas assim?

Fonte: Como posso criar um link simbólico no Terminal?

macos terminal unix

— Hardeep Singh
fonte

Perfil do OP: apple.stackexchange.com/users/37797/grg

— Hardeep Singh

github.com/vain/explain

— JBis

@JBis Eu recomendo adicionar uma resposta, que provavelmente será aceita . Seria melhor incluir uma amostra ou algo assim, para dar uma resposta substancial.

— jpaugh

@jpaugh Vai fazer.

— JBis

Você está executando o Linux em um dispositivo Apple? Esses comandos também funcionam no macOS (por exemplo, o macOS lsvem do BSD Unix e não do Linux). Portanto, se você usa o macOS ou similar, remova a palavra 'Linux' da sua pergunta.

— Qsigma 26/07/19

Respostas:

Essa é a minha resposta! Fiz isso manualmente, mas usei o PressAndHold.app (incorporado no macOS) para acelerar a inserção dos caracteres de desenho da caixa . O texto foi resumido da página de manual manualmente.

Ao personalizar as teclas PressAndHold.app , basicamente editando /System/L*/Inp*/Pr*/*/P*/*/*/R*/para adicionar caracteres de desenho de caixa, eu posso digitar os caracteres diretamente no campo de texto, seja aqui no SE ou em outro lugar.

Adicione o seguinte ao arquivo de teclado do seu idioma nessa pasta, como 'Keyboard-en.plist' para um layout de teclado em inglês. Abra o plist com um editor de texto para colar o XML abaixo ou abra com o Xcode e crie manualmente o dicionário, colando os valores conforme necessário. Substitua 'f' pela chave que deseja usar. Você pode inserir caracteres de desenho de caixa mantendo pressionada a tecla e selecionando um número ou, se tiver uma barra de toque, as teclas também aparecerão com o 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
fonte

Funcionou como um encanto! Depois de desativar o SIP no meu MacOS Mojave no modo de recuperação, consegui editar o Keyboard-en.plistarquivo. Simplesmente copiei as tags de string e as substitui pela tecla de atalho para "z" e trabalhei! Valeu mesmo, cara. Ajudará muito mais pessoas a partir de agora. Você é uma jóia! :)

— Hardeep Singh

<string>─ │ ┌ ┐ └ ┘ ├ ┬ ┤ ┴ ┼</string>mostra 11 caracteres de desenho de caixa, no entanto, a imagem da interface PressAndHold.app mostra apenas 9 deles. Como você acessa os dois últimos, 10 ┴e 11 ┼?

— user3439894

@ user3439894 Clicando na seta para baixo na dica de ferramenta. Primeiro 9: i.imgur.com/SK6I47e.png Depois de clicar na seta para baixo Última 2: i.imgur.com/yM5xoRC.png

— Hardeep Singh

@Hardeep Singh, obrigado pela informação! Teria sido bom se a resposta original tivesse incluído informações tão importantes.

— user3439894

@ user3439894 Cortei-o da minha captura de tela porque o alternador de páginas está apenas no Mojave (o High Sierra deve mostrar todas as chaves de uma linha) e porque o botão atual no Mojave parece errado (um bug beta, com certeza, será corrigido )

— grg

Você provavelmente deseja usar asciiflow.com

Eu realmente não posso adicionar mais a esta resposta;)

Desde então, descobri que o texto da explicação parece ter sido retirado do ExplainShell.com

— djsmiley2k TMW
fonte

Bem-vindo ao AD! Apenas como uma observação útil, sua resposta provavelmente suscitará maior interesse se você explicar como a solução que você propõe responde à pergunta.

— Allan

O fluxo ASCII parece bom. Descobri que a solução fornecida pelo @JBis é muito conveniente e tenho mais controle sobre os conjuntos de caracteres, onde, como no fluxo ASCII, só posso usar hífens e símbolos "+".

— Hardeep Singh

Eu conheço um site que faz isso e é https://explainshell.com/ . Pelo jeito que eu acabei de perceber que o código explainShell está disponível no GitHub:
https://github.com/idank/explainshell
eu não sei como eles tecnicamente acabar fazendo isso, mas eles estão usando um nome do projeto opensource "Show A Doc "disponível aqui:
https://github.com/idank/showthedocs

— Kiwy
fonte