1 min de leitura ·

[PITCH] Verbalize - editor de texto com auxílio de escrita

Prezados :)

Sou linguista e atuo como escritor técnico (tech writer, dev writer, documentador, redator técnico etc) e sempre usei o Hemingway como auxílio na escrita em inglês. O problema foi que eu nunca conheci um editor que indicasse do mesmo possíveis melhorias em um texto em português brasileiro.

Passam os anos e essa semana eu tive tempo de tirar do papel um fork do Techscriptor com algumas melhorias de interface e adaptado ao português brasileiro. Foi assim que nasceu a versão 0.1 do Verbalize.

O que ele faz?

De forma básica e resumida: você pode carregar um arquivo do seu computador (em md ou txt, por enquanto) e o editor vai, além de permitir que você edite de fato, dar instruções de possíveis melhorias no texto (frases longas, palavras complexas, jargões, adjetivos entre outras coisas que devemos evitar em textos, principalmente técnicos).

Depois de editado, você ainda pode baixar o arquivo em formato md.

Acesso

O aplicativo pode ser instalado (Electron), acessado via web ou você pode baixar o código no GitHub e rodar ele localmente no browser.

Melhorias

Eu tenho alguns "próximos passos" que eu mapeei já:

Possibilidade de conectar com Google Drive/Onedrive.
Possibilidade de realizar upload de um arquivo de regras personalizado.
Possibilitar que ele seja usado offline.
Melhorar a interface.

Feedback são muito bem vindos :D

Agradecido :)

Fonte: https://github.com/mtgr18977/Verbalize

gpoleszuk

1 mês atrás

mtgr18977, que ferramenta útil!!! Baixei a versão que você adaptou, rodei localmente e vi que faltava algumas dependências:

Baixei todas elas para deixar tudo local. Agora, tudo funcionando (offline) apenas sobre o apache sem precisar do Node!

Outras ideias para expandir essa ferramenta que achei muito útil:

um botão para limpar o textarea de entrada;
modo escuro ou a possibilidade de alterar as cores, padrões de fundo dos painéis;
opção para ocultar as mensagens da lateral, se desejar, para aumentar a área na tela de edição e exibição;
incluir um corretor ortográfico, marcando as palavras que estejam fora de um dicionário definido num JSON;
suporte a outros elementos do markdown como equações $LaTeX$ ;

Copiei um dos artigos aqui do Tabnews só para testar a ferramenta e gostei do resultado. A ferramenta indicou as sentenças e termos muito longos para melhoria, sinalizando as seções que mereciam um retoque. Não tem problemas por ser limitada! Pode ser aperfeiçoada com acesso ao código fonte. O que faltaria para se tornar um "Gramm arly" offline?

PS: Alguém com mais experiência consegue explicar porque essa dependência é um CSS e recebe parâmetros na linha de endereço? Para funcionar sem problema, precisei baixá-la e incluir a estensão .css para o navegador não reclamar do mime-type

https://fonts.googleapis.com/css2?family=Roboto:wght@400;500&display=swap

mtgr18977

Autor

1 mês atrás

Muito obrigado :)
Quem bom que você conseguiu resolver a questão de rodar offline. Eu sou tentar reproduzir aqui e se ficar OK eu vou colocar na documentação do readme.

Sobre as ideias de melhorias:

Outras ideias para expandir essa ferramenta que achei muito útil:

um botão para limpar o textarea de entrada;

Não tinha pensado nisso, é relativamente fácil de fazer.

modo escuro ou a possibilidade de alterar as cores, padrões de fundo dos painéis;

Essa eu tinha pensado, mas esbarrou na falta de conhecimento técnico do programador aqui haha

opção para ocultar as mensagens da lateral, se desejar, para aumentar a área na tela de edição e exibição;

Outra que nem tinha me passado pela cabeça, teoricamente fácil de implementar também.

incluir um corretor ortográfico, marcando as palavras que estejam fora de um dicionário definido num JSON;

Essa, depois de postar em vários locais, eu descobri que é algo que deve ser feito. A maioria das pessoas pediu essa feature. Não sei como implementar isso ainda, mas se tornou minha prioridade pra melhorar o app.

suporte a outros elementos do markdown como equações LaTeX;

Eu andei dando uma olhada nessa questão. Acredito que seria apenas colocar o Katex como dependência, adicionar/baixar as dependências de CSS/min.js no index e criar um renderMathInElement na função de updateView do script principal.

Copiei um dos artigos aqui do Tabnews só para testar a ferramenta e gostei do resultado. A ferramenta indicou as sentenças e termos muito longos para melhoria, sinalizando as seções que mereciam um retoque. Não tem problemas por ser limitada! Pode ser aperfeiçoada com acesso ao código fonte. O que faltaria para se tornar um "Gramm arly" offline?

Acho que o principal seria poder criar um dicionário personalizado (botão direito > adicionar ao dicionário) que seria salvo em um arquivo json. Indicar os índices de leiturabilitade (flesh etc). E, finalmente, ter um dicionário (aquele json você citou). Para dar dicar para melhorar eu realmente não faço a menor ideia de como eu faria.

PS: Alguém com mais experiência consegue explicar porque essa dependência é um CSS e recebe parâmetros na linha de endereço? Para funcionar sem problema, precisei baixá-la e incluir a estensão .css para o navegador não reclamar do mime-type. https://fonts.googleapis.com/css2?family=Roboto:wght@400;500&display=swap

Meu chute: como é um CSS dinâmico que retorna um CSS gerado pelo Google Fonts. Passando o os parametros (family e display e wght) ele gera o CSS e o retorna. Acredito que você precisou baixá-lo porque quando ele é acessado diretamente o Google Fonts retorna o arquivo corretamente (text/css) mas quando ele é baixado, isso não ocorre de forma transparente e o arquivo interpreta de outra maneira, gerando erros de mime-type.