Escreva e deixe o mundo revisar seu trabalho com Prose.io para o GitHub

Propaganda

Tradicionalmente, a escrita é um assunto solitário. É só você e a tela, ou um pedaço de papel. Homem versus texto em uma batalha de vontades, inteligência e emoção, até que de repente - você está feito. Agora é hora de mostrar ao mundo, colocar seu texto lá fora e observar o que acontece. Mas nesses tempos digitais, essa não é a única maneira de escrever.

E se tudo estivesse ao ar livre o tempo todo? E se o mundo pudesse ver suas revisões e seguir adiante, fazendo sugestões? Em face disso, isso pode parecer uma idéia horrível - mas para alguns tipos de textos (e para certos escritores), essa colaboração aberta pode ser um benefício. Prosa é uma simples plataforma de publicação on-line que interage com o GitHub para permitir que você edite texto on-line e mantenha revisões usando o Git O que é o Git e por que você deve usar o controle de versão se você for um desenvolvedor Como desenvolvedores web, na maior parte do tempo, tendemos a trabalhar em sites de desenvolvimento local e depois carregamos tudo quando terminamos. Isso é bom quando é só você e as mudanças são pequenas, ... Leia Mais.

Começando

Para trabalhar com Prosa, primeiro você deve ter uma conta do GitHub. Assumindo que você está logado no Git, simplesmente clique no botão Autorizar Prosa:

O Git perguntará se você tem certeza de que deseja autorizar Prose. A prosa requer algumas permissões, mas todas elas fazem sentido:

Em seguida, você se encontrará em Prosa, olhando para uma lista de todos os seus repositórios Git:

Se você é como eu, nenhum de seus repositórios existentes é adequado para um monte de texto. Naturalmente, isso pode não ser verdade para você: Por exemplo, se você estiver usando a estrutura de publicação do Jekyll, talvez já tenha um repositório aguardando o texto. De fato, grande parte da Prose parece ser construída com os usuários do Jekyll em mente: Prose ainda permite que você publique no Jekyll. Dito isso, você não precisa que Jekyll use Prose, e eu olhei para ele sem conectá-lo a qualquer outra coisa.

Então, para começar, vamos criar um novo lar para o nosso texto.

Criando um novo repositório GitHub

Para criar um novo repositório GitHub, você teria que voltar ao GitHub em si - isso não é algo que você pode fazer em Prosa. Prosa sugere nomear seu novo repositório como "documentos", e foi isso que eu fiz.

Imediatamente após a criação do repositório, ele apareceu dentro da Prosa:

Editando um Documento

Clicando em meu novo repositório Documents, sou saudado pelo README.md padrão do GitHub. MD, neste caso, significa Markdown - o mesmo formato simples usado por Dillinger.io, TextDown, WriteMonkey e inúmeros outros editores. Se você estiver escrevendo textos para uso on-line por qualquer período de tempo, é provável que você tenha encontrado o Markdown mais de uma vez.

Clicando no documento, surgiu uma simples interface de edição:

É felizmente livre de quaisquer anúncios e tem um esquema de cores suaves que é fácil para os olhos. Ele também tem realce de sintaxe para Markdown e, em vez de um painel de visualização instantânea (como o usado em Dillinger.io), a visualização do texto renderizado em HTML requer uma rápida barra de ferramentas:

Você pode acessar a tela de visualização usando Ctrl + Shift + seta para a direita. Ctrl + Shift + seta para a esquerda leva você a uma folha de dicas do Markdown, caso deseje atualizar sua memória.

O editor é de bom gosto, mas não oferece um recurso de contagem de palavras ao vivo, algo que eu esperaria de qualquer ferramenta destinada a escritores. Ele também desativa o verificador ortográfico interno do Chrome, tornando seu texto muito mais propenso a erros de digitação.

Publicação (ou salvar)

A menos que você esteja usando o Jekyll, publicar e salvar é praticamente a mesma coisa: assim que você salva, seu texto é enviado para um repositório do GitHub. A menos que você seja um usuário pagante do GitHub e tenha optado por um repositório privado, isso significa que todos agora podem ver seu texto. O primeiro commit ficou assim:

E depois de mais alguns rabiscos, o histórico de commit do GitHub para o repositório ficou assim:

Muito transparente, mas também seguro: as revisões tornam quase impossível perder o seu trabalho. Você pode salvar e remover um grande pedaço do seu documento, mas você sempre poderá recuperá-lo. É como um recurso de desfazer ilimitado que continua funcionando mesmo se você desligar o computador ou mudar para um diferente.

Isso está longe de ser tudo o que a Prosa pode fazer: por exemplo, você pode usar Prosa para editar o documento de outra pessoa e enviar uma solicitação de recebimento para que ela aceite suas revisões - assim como os programadores fazem. Há muitas outras coisas que você poderia fazer com Prosa, mas seu princípio central permanece o mesmo: Git por escrever.

Pensamentos finais

Para mim, Prose parece mais um convite do que uma ferramenta. Um convite para pensar, redigir, esboçar, em campo aberto. Para superar o “medo da publicação” publicando constantemente enquanto você escreve, para que não haja um único “momento da verdade” - seus pensamentos estiveram lá no mundo o tempo todo, erros de digitação, inconsistências e tudo mais. Existem outras maneiras de fazer isso, desde wikis até clientes padrão do Git, mas o Prose não pretende ser uma idéia exclusiva - ele apenas empacota as coisas de forma que o conceito se destaque. Se é ou não o jeito certo para você escrever é uma escolha pessoal - uma escolha que eu estaria curiosa para ouvir, se você me dissesse nos comentários.