Como os escritores podem usar o GitHub para armazenar seu trabalho
Existem várias maneiras de gerenciar e armazenar seus projetos de escrita. Algumas pessoas preferem serviços de armazenamento em nuvem (como o Dropbox) ou editores online (como o Google Docs), enquanto outros usam aplicativos de desktop (como o Microsoft Word). Eu uso algo chamado GitHub.
GitHub: É mais do que apenas código
Uso o Git e o GitHub para armazenar e acessar toda a minha escrita.O Git é uma ferramenta eficaz que você pode usar para rastrear alterações de documentos, além de fazer o upload para o GitHub super rápido. Também é rápido e simples baixar o seu trabalho para um segundo ou terceiro dispositivo.
Se você nunca ouviu falar do GitHub, é o destino mais popular do mundo para armazenar e manter o código-fonte aberto. Pode parecer um lugar louco para hospedar sua escrita, mas não é!Afinal, o código é apenas linhas e linhas de texto, como seu artigo, história ou dissertação.
Por volta de 2013, o GitHub começou a incentivar as pessoas a criar repositórios para todos os tipos de informações, não apenas o código.O GitHub nunca deixou suas raízes de codificação, mas algumas pessoas ainda o usam para armazenar projetos de escrita e outros que não são de codificação. Por exemplo, uma pessoa usou o Git e o GitHub para escrever um livro de instruções, enquanto outra escreveu um romance.Dê uma olhada no Google e você encontrará todos os tipos de usos malucos do GitHub.
O que são o Git e o GitHub?
Git é um programa de código aberto criado por Linus Torvalds, famoso no Linux.O Git rastreia alterações nos documentos e facilita para várias pessoas trabalharem remotamente no mesmo documento. No tech-speak, é chamado de sistema de controle de versão distribuído (ou VCS distribuído).O Git não salva arbitrariamente versões dos seus documentos em intervalos definidos. Em vez disso, ele armazena as alterações nos seus documentos somente quando você solicita.
Seus documentos formam um repositório (ou repositório), que é apenas um termo sofisticado para a pasta do projeto. Sua pasta Documents no Windows, por exemplo, seria um repositório se você usasse o Git para gerenciá-lo (mas não faça isso).
Quando você armazena alterações em seus documentos no Git, ele é #8217; é chamado de “ commit. ”Uma confirmação é apenas um registro das alterações mais recentes que você fez em um documento. Cada confirmação é atribuída a uma longa sequência de números e letras como seu ID.
Se você chamar um commit passado por seu ID, não verá o projeto inteiro como no Word ’ s histórico do documento. Você só vê as alterações mais recentes quando esse commit foi feito. No entanto, isso não significa que todo o projeto não foi gravado. Você pode excluir toda a sua gravação de uma pasta do projeto e ainda obter a versão mais recente de volta com alguns comandos git. Você pode até voltar e ver a aparência do projeto há uma semana ou seis meses.
Você também pode incluir mensagens para cada confirmação, o que é muito útil. Por exemplo, se você escrever algo, mas não tiver certeza de que deseja mantê-lo, faça um commit.A seção sobrevive no seu histórico de consolidação, mesmo que você a exclua do projeto posteriormente.
O Git funciona melhor na linha de comando, o que é uma grande vantagem, mas também tem suas desvantagens.A linha de comando é boa para criar confirmações e fazer upload de alterações. No entanto, se você deseja visualizar um histórico de consolidação, não é o ideal.
É por isso que muitas pessoas gostam do GitHub, um serviço online popular que oferece uma interface da web para seus repositórios Git. No GitHub, você pode visualizar facilmente confirmações passadas e fazer o download da sua gravação para vários PCs.
Juntos, o Git e o GitHub me permitem controlar meu histórico de versões em um nível granular.E é fácil escrever em qualquer PC que possa executar uma linha de comando do Bash que atualmente inclui máquinas com Windows, Mac, Linux e Chrome OS.
Arquivos de texto simples facilitam as coisas
O Git e o GitHub confirmam praticamente qualquer tipo de arquivo para gravação, embora funcione melhor com texto sem formatação. Se você escrever no Microsoft Word, funcionará, mas não poderá ver seus commit anteriores na linha de comando ou no GitHub. Em vez disso, você deve chamar um commit passado na linha de comando (chamada de 'checkout') e, em seguida, abrir o arquivo do Word.O arquivo do Word fica exatamente como era quando você fez o commit original, e você pode voltar à sua versão atual com outro comando rápido.
Se você usa o Scrivener, isso também funciona.O Scrivener salva os arquivos como texto, e também exibe confirmações anteriores no GitHub e na linha de comando. Mas o Scrivener também salva dados que são importantes para o programa, mas não para você. Em cada confirmação, você terá muito lixo que dificulta a leitura.
Uso arquivos de texto sem formatação porque é tudo o que você precisa para reunir as palavras, especialmente nos seus primeiros rascunhos.
Introdução ao Git
Vamos entrar nos detalhes técnicos decomo isso tudo funciona. Começaremos com o PC e, em seguida, subiremos para a nuvem com o GitHub.
Para começar, você precisa do programa de terminal no macOS ou Linux. Se o seu computador executar o Windows 10, você deverá instalar o Ubuntu ou outra distribuição Linux através do Windows Subsystem for Linux (WSL), o que é bastante fácil. Você pode conferir nosso tutorial sobre como instalar o shell Linux Bash no Windows 10. Ou, se você usa uma versão mais antiga do Windows, pode usar o Cygwin para obter um shell Bash.
Abra o terminal enavegue até a pasta que deseja usar como repositório Git. Para nossos propósitos, digamos que temos uma pasta chamada "MyNovel" ”na pasta Documentos. Observe que não há espaço entre as palavras do nosso repositório Git. Você facilitará sua vida se fizer dessa maneira, pois o Bash não gosta de espaços e lidar com eles fica confuso.
Em seguida, navegue até a pasta MyNovel no terminal. Para fazer isso no Windows 10, o comando é:
cd / mnt / c / Users / [YourUserName] / Documents / MyNovel
Qualquer comando WSL que interaja com arquivossalvo nas necessidades do Windows deve usar / mnt /. Observe também que as letras minúsculas “ c ”indica a unidade em que você está. Se os seus arquivos estiverem em um “ D: / ”na unidade, use / d /.
Para macOS e Linux, o comando é muito mais simples:
cd ~ / Documents / MyNovel
aqui, os comandos são os mesmos.
Agora, precisamos inicializar a pasta MyNovel como um repositório Git. Este comando funciona se você está apenas começando um novo romance ou se já possui alguns arquivos salvos.
git init
Sua pasta agora é um repositório Git.Não acredita em mim?Digite isso em:
ls -a
Esse comando solicita ao computador que liste tudo na pasta atual, incluindo itens ocultos. Você deve ver algo listado na parte superior chamada "“ . git" ”(observe o período).O “ . git oculto ”pasta é onde o histórico da versão do documento é salvo. Você nunca precisa abrir isso, mas deve estar lá.
O primeiro commit
Antes de fazermos nosso primeiro commit, o Git quer saber seu nome e endereço de email.O Git usa essas informações para identificar quem fez a confirmação e essas informações são incluídas no log de confirmação. Para fins práticos, isso não importa, pois os escritores normalmente estão voando sozinhos, mas o Git ainda exige.
Para definir seu email e endereço, faça o seguinte:
git config --global user. email "[Seu email]" git config --global user. name "[Seu nome]"
É isso aí. Agora, vamos ao primeiro commit.
Vamos assumir que existem três documentos no “ MyNovel ”pasta chamada: “ Chapter1, ”“ Capítulo2 & ”e “ Capítulo 3. & & 8221;Para salvar as alterações, precisamos dizer ao Git para rastrear esses arquivos. Para fazer isso, digite:
git add.
O período diz ao Git para monitorar todos os arquivos não rastreados na pasta (ou seja, arquivos para os quais você deseja criar históricos). Este comando também diz ao Git para preparar todos os arquivos rastreados no momento que foram alterados. Esse processo é chamado de arquivos temporários para confirmação.
Para nossos propósitos, o preparo não é tão importante, mas pode ser útil. Se você fizer alterações no Capítulo 2 e no Capítulo 3, mas apenas desejar confirmar as alterações no Capítulo 2, seria o estágio 2 do seguinte modo:
git add Chapter2. doc
Isso diz ao Git que você deseja que as alterações no Capítulo 2 estejam prontas para confirmação, mas não no Capítulo 3.
Agora, é hora do primeiro commit:
Gitcommit -m "Este é o meu primeiro commit".
O "-m" é chamado de flag e indica ao Git que você deseja fazer um commit e colar uma mensagem, que você vê entre as aspasmarcas. Eu gosto de usar minhas mensagens de confirmação para marcar a contagem de palavras. Também os uso para anotar informações especiais, como: "Este compromisso inclui uma entrevista com o CEO da Acme Widgets." ”
Se estou escrevendo uma história,pode incluir uma mensagem que diz: "Este commit tem a nova cena em que o cão foge". As mensagens úteis tornam mais fácil encontrar seus commits mais tarde.
Agora que começamos a rastrear nossos documentos, é hora de colocar nossa escrita na nuvem com o GitHub. Eu uso o GitHub como um backup extra, um local confiável para examinar minhas alterações de documentos e uma maneira de acessar minhas coisas em vários PCs.
Introdução ao GitHub
Primeiro, você precisa se inscrever em uma conta gratuita no GitHub (você não precisa de uma conta paga para criar repositórios privados). No entanto, você só pode colaborar com até três pessoas em um repositório particular. Se você tem uma equipe de cinco ou mais pessoas trabalhando em um artigo, precisa se inscrever em uma conta Pro (US $ 7 por mês, neste momento).
Depois de criar sua conta, vamos criar uma novarepo. Entre na sua conta e acesse https://github. com/new.
A primeira coisa que precisamos fazer é nomear o repositório. Você pode usar o mesmo nome usado para a pasta no seu PC. Sob “ Nome do Repositório, ”digite “ MyNovel. ”
A “ Descrição ”é opcional, mas eu gosto de usá-lo. Você pode digitar algo como "Meu fabuloso romance sobre um garoto, uma garota e seu cachorro", ”etc
Em seguida, selecione a opção "Private" (Privada) ”botão de opção, mas não marque a caixa chamada "“ Inicialize este repositório com um README".Não queremos fazer isso, porque já temos um repositório em nosso PC. Se criarmos um arquivo README no momento, isso tornará as coisas mais difíceis.
Em seguida, clique em "Criar Repositório". ”Em "Configuração rápida", se você já fez esse tipo de coisa antes, ”copie o URL. Ele deve ficar assim:
https://github. com/ [Seu nome de usuário no GitHub] /MyNovel. git
Agora, está de voltana área de trabalho e na nossa amada linha de comando.
Envie o repositório da área de trabalho para a nuvem
Na primeira vez em que você conecta um repositório ao GitHub, você tempara usar alguns comandos especializados.O primeiro é:
git remote add origin https://github. com/[Seu nome de usuário do GitHub] /MyNovel. git
Isso informa ao Git um repositório remotoé a origem do “ MyNovel. ”O URL aponta o Git para essa origem remota.Não fique muito preocupado com o termo "origem"; ”é apenas uma convenção. Você pode chamá-lo de 'fofo' ”se você quiser a origem é apenas mais fácil, pois é a maneira mais comum de usar o Git.
Quando você carrega novas alterações com o Git, ele é chamado de "push".”Quando você faz o download das alterações, ele é chamado de "pull" ”ou 'buscar'. ”Agora, é hora de enviar seu primeiro commit ao GitHub. Aqui está o que você faz:
git push -u origin master
Você será solicitado a digitar seu nome de usuário e senha do GitHub. Se você digitar suas credenciais corretamente, tudo será enviado e você estará pronto.
Se você deseja mais segurança para os envios do GitHub, pode usar uma chave SSH. Isso permite que você use uma única senha para o upload da chave SSH, para que você não precise digitar todas as suas credenciais do GitHub todas as vezes. Além disso, apenas alguém com a chave SSH pode fazer upload de alterações de arquivos.
Se você quiser obter mais informações sobre chaves SSH, o GitHub tem instruções completas sobre como usá-las. Você também pode salvar suas credenciais do Git no seu PC.
É isso!Agora, quando você deseja confirmar alterações em seus arquivos, pode fazê-lo com estes três comandos breves (depois de navegar para a pasta “MyNovel”):
git add.
Tradução: “ Ei, estágio Git para confirmar todos os arquivos não rastreados, bem como novas alterações nos arquivos que você já está rastreando. ”
git commit -m"1.000 palavras na nova revisão do iPhone."
Tradução: Hey Git, salve essas alterações ao lado desta mensagem. ”
origem do push do gitmaster
Tradução: "Hey Git, faça o upload das alterações para a versão de origem deste projeto no GitHub da minha cópia principal neste PC." ”
Git eDicas de bônus do GitHub
É praticamente isso, mas aqui estão algumas dicas extras para tornar sua experiência com o Git e o GitHub ainda melhor:
Exibir confirmações anteriores
Para visualizar confirmações anteriores, acesse o repositório MyNovel no GitHub. No topo da página principal, sob o "Código" <> ”Na guia, você verá uma seção que diz: "[X] confirma." ”
Clique nele e uma lista de todos os seus confirmamentos. Clique no commit que você deseja e verá seu texto (se você o digitou em texto sem formatação e não no Word, isto é). Tudo destacado em verde era novo texto quando o commit foi criado;tudo em vermelho foi excluído.
Use o comando Pull
É fácil pegar um novo repositório em uma máquina diferente. Basta navegar para onde deseja salvar o repositório na nova máquina, como cd ~ / Documents. Em seguida, digite:
git pull https://github. com/[Seu nome de usuário do GitHub] /MyNovel. git
Digite suas credenciais, se solicitado, e emalguns segundos, você estará pronto para começar. Agora, confirme novas alterações e envie-as de volta ao GitHub via mestre de origem do git push. Quando você voltar ao PC onde costuma trabalhar, basta abrir a linha de comando, navegar até a pasta do projeto e digitar git pull. As novas alterações serão baixadas e, assim, seu projeto de escrita estará atualizado em todos os seus dispositivos.
Não atravessa fluxos
Na maioria das vezes, a escrita não é ’ um esforço de equipe e envolve apenas uma pessoa. Por esse motivo, este artigo usa o Git de uma maneira que não funcionaria em um projeto para várias pessoas. Especificamente, fizemos edições diretamente na versão mestra de nosso romance, em vez de criar o que é chamado de "ramos". Uma ramificação é uma versão prática do romance, na qual é possível fazer alterações sem afetar o mestre original.É como ter duas cópias diferentes do seu romance existindo em paralelo, sem afetar o outro. Se você gosta das alterações no ramo de prática, pode mesclá-las na versão principal (ou ramo principal). Se você não quer fazer isso, isso também está bem. Basta jogar fora o ramo de prática.
Os ramos são muito poderosos, e usá-los seria o fluxo de trabalho principal com vários escritores em um único projeto. Escritores solo realmente não precisam usar ramificações, na minha opinião, desde que você não faça alterações diferentes na ramificação principal ao mesmo tempo em vários PCs.
Por exemplo, você deve concluir seu trabalho na área de trabalho, fazer suas confirmações e depois enviar as alterações para o GitHub. Em seguida, vá para o seu laptop e puxe todas as novas alterações para baixo antes de fazer outras edições. Caso contrário, você pode acabar com o que o Git chama de 'conflitos'. ”É quando o Git diz: 'Ei, há mudanças no GitHub e neste PC que não correspondem. Ajude-me a descobrir isso. ”
Escolher um caminho para sair de um conflito pode ser uma dor, por isso é melhor evitá-lo sempre que possível.
Depois de começarGit, há muitas coisas que você pode aprender, como ramificação, a diferença entre uma busca e uma atração, quais são as solicitações de atração do GitHub e como lidar com o temido conflito.
O Git pode parecer complicadopara os recém-chegados, mas, depois de entender o que é, é uma ferramenta poderosa que você pode usar para gerenciar e armazenar sua escrita.
Via: How to Geek
Veja Também:
Nenhum comentário