Modo literal

Literal não é bruto. A pontuação falada e os comandos de símbolos continuam valendo, porque “dash dash force” é como se diz --force, e sem comandos um terminal fica inutilizável pela voz. Os termos do dicionário e os nomes de arquivo do seu projeto continuam sendo resolvidos, porque um nome de arquivo mal ouvido é um erro de reconhecimento, não uma reescrita. O que o modo literal desliga é o julgamento: nada de maiúscula na primeira palavra, nada de aspas curvas, nada de ponto final, nada de remoção de vícios de fala que possa engolir uma flag, e nada de tom.

Um botão que você precisa lembrar é um botão que você vai esquecer, e o preço do esquecimento é um comando quebrado. Vincular o modo ao app em primeiro plano elimina a decisão: Terminal, iTerm, Warp, Xcode, VS Code, Cursor e parentes ficam em literal; Mail e Mensagens não. O caso de fronteira que sobra é um campo de texto corrido dentro de um editor de código, como uma mensagem de commit ou a descrição de um PR, em que algumas pessoas querem a formatação de volta, e ali a resposta certa é uma exceção por app.

No primeiro dia de qualquer período de teste, dite num terminal um comando com um traço duplo, uma string entre aspas e um caminho, e confira caractere por caractere. Depois dite a mesma coisa num app de notas e confirme que foi pontuado. Uma ferramenta que passa nos dois está usando o contexto como sinal. Uma ferramenta que coloca maiúscula no seu comando não tem um modo literal digno do nome, diga o que disser a tela de ajustes.

O Ditado integrado da Apple não tem uma opção de modo literal, mas você chega perto desativando o seu único comportamento automático e falando cada símbolo. É lento, e mostra claramente o trabalho que um modo literal automático poupa você de fazer.

Um detalhe importa nos comandos. Na lista de comandos da Apple, “hífen” insere o hífen curto que as flags usam, enquanto “travessão” insere um traço mais longo, que um shell não aceita como flag.

1. 01 Escolha menu Apple → Ajustes do Sistema, clique em Teclado na barra lateral e vá até Ditado.
2. 02 Desative a Pontuação automática, para que nenhuma vírgula, ponto final ou ponto de interrogação seja inserido por você.
3. 03 Clique no seu terminal ou editor e comece a ditar.
4. 04 Diga “hífen” para cada hífen de uma flag. Para um hífen duplo, diga duas vezes.
5. 05 Diga “ligar sem espaçamento” antes de um trecho que não pode ter espaços, como um caminho, e “desligar sem espaçamento” depois dele.
6. 06 Diga os nomes dos símbolos onde precisar deles: “barra”, “sublinhar”, “barra vertical”, “barra invertida”, “asterisco”.
7. 07 Releia a linha caractere por caractere antes de pressionar Retorno.

Por causa de um ajuste de texto do macOS, não necessariamente da sua ferramenta de ditado. O macOS tem um ajuste chamado “Usar aspas e hifens inteligentes” que troca as aspas retas pelas tipográficas enquanto o texto é digitado. Isso é correto num texto corrido e errado num comando ou numa string de código.

O ajuste fica em Ajustes do Sistema → Teclado → Entrada de Texto. Clique em Editar e desative “Usar aspas e hifens inteligentes”. A Apple observa que aspas e hifens inteligentes não estão disponíveis em todos os apps, então o efeito varia de um app para outro. Muitos apps também têm um menu Editar → Substituições, onde você vê quais substituições estão ativas naquele app.

O Controle por Voz da Apple tem um modo para texto que precisa ser exato, e ele funciona de um jeito diferente do modo literal. O modo literal continua recebendo palavras inteiras e as deixa como estão. O modo Soletrado recebe um caractere de cada vez. A Apple o descreve como útil quando você precisa inserir uma senha, um endereço da web ou outra sequência de caracteres.

O Controle por Voz fica em Ajustes do Sistema → Acessibilidade → Controle por Voz. Com ele ativado, diga “modo Soletrado” para mudar e “modo de Ditado” para voltar ao ditado palavra por palavra. O Ditado padrão não está disponível enquanto o Controle por Voz está ativado.

Use o modo Soletrado para uma sequência curta e exata, como um identificador ou um endereço. Para um comando inteiro ou uma linha de texto corrido ele é lento demais, e o ditado literal por palavras é a melhor opção.