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

Propaganda

Tradicionalmente, escrever é 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ê terminou. Agora é hora de mostrar ao mundo, publicar seu texto e ver o que acontece. Mas nesses tempos digitais, esse não é o único caminho para escrever.

E se fosse todos a céu aberto, o tempo todo? E se o mundo pudesse ver suas revisões e acompanhar, fazendo sugestões? Diante 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 plataforma simples de publicação on-line que faz interface com o GitHub para permitir que você edite texto online e mantenha as revisões usando Git O que é Git e por que você deve usar o controle de versão se você é um desenvolvedorComo desenvolvedores da Web, na maioria das vezes tendemos a trabalhar em sites de desenvolvimento local, depois carregamos tudo quando terminamos. Tudo bem quando é só você e as alterações são pequenas, ...

consulte Mais informação .

Começando

Para trabalhar com o Prose, você deve primeiro ter uma conta no GitHub. Supondo que você esteja logado no Git, basta clicar no botão Autorizar da Prosa:

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

Em seguida, você voltará ao Prose, consultando uma lista de todos os seus repositórios Git:

Se você gosta de mim, nenhum de seus repositórios existentes é adequado para um monte de texto. Obviamente, isso pode não ser verdade para você: por exemplo, se você estiver usando o Jekyll estrutura de publicação, você já pode ter um repositório apenas aguardando texto. De fato, grande parte do Prose parece ter sido construída com os usuários do Jekyll em mente: o Prose ainda permite que você publique no Jekyll. Dito isto, você não precisar Jekyll para usar Prosa, 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 do GitHub, você precisa voltar ao GitHub - isso não é algo que você pode fazer no Prose. A 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 no Prose:

Editando um Documento

Ao clicar no meu novo repositório de documentos, sou recebido pelo README.md padrão do GitHub. MD, nesse caso, significa Markdown - o mesmo formato simples usado por Dillinger.io Dillinger: Editar e visualizar remarcações em tempo real consulte Mais informação , TextDown TextDown: Crie um editor de remarcação no Google Chrome consulte Mais informação , WriteMonkey WriteMonkey - um editor de texto simples para os que se distraem facilmente consulte Mais informação e inúmeros outros editores. Se você compõe texto para uso on-line há algum tempo, é possível que você encontre o Markdown mais de uma vez.

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

É felizmente livre de anúncios e possui um esquema de cores suaves que é fácil para os olhos. Ele também possui destaque de sintaxe para o Markdown e, em vez de um painel de visualização instantânea (como o usado no Dillinger.io), a visualização do texto renderizado em HTML requer um rápido clique na 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 planilha 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.

Publicando (ou salvando)

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

E depois de mais alguns rabiscos rápidos, o histórico de consolidação do GitHub para o repositório ficou assim:

Muito transparente, mas também seguro: as revisões tornam quase impossível a perda do seu trabalho. Você pode salvar e remover uma grande parte do seu documento, mas sempre poderá recuperá-lo. É como um recurso de Desfazer ilimitado que continua funcionando mesmo que você desligue o computador ou mude para outro.

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

Pensamentos finais

Para mim, Prose parece mais um convite do que uma ferramenta. Um convite para pensar, compor, redigir, ao ar livre. Superar o “medo da publicação” publicando constantemente enquanto você escreve, para que não haja "Momento da verdade" - seus pensamentos estão lá fora no mundo o tempo todo, erros de digitação, inconsistências, e tudo. Existem outras maneiras de fazer isso, dos wikis aos clientes Git padrão, mas o Prose não finge ser uma idéia exclusiva - apenas empacota as coisas de maneira organizada para que o conceito se destaque. Se é o caminho certo para você escrever ou não, é uma escolha pessoal - uma opção que eu gostaria de saber, se você me contasse nos comentários.