Come gli Scrittori Possono Usare GitHub per Memorizzare il Loro Lavoro

Ci sono molti modi per gestire e memorizzare i vostri progetti di scrittura. Alcune persone preferiscono i servizi di cloud storage (Dropbox) o editor online (come Google Docs), mentre altri utilizzano le applicazioni desktop (come Microsoft Word). Io uso qualcosa chiamato GitHub.

GitHub: È per Oltre il Codice

Io uso Git e GitHub per memorizzare e accedere a tutti la mia scrittura. Git è un efficace strumento che è possibile utilizzare per tenere traccia delle modifiche apportate a un documento, in più si possono caricare su GitHub super-veloce. È anche semplice e veloce per scaricare il lavoro su un secondo o terzo dispositivo.

Se non hai mai sentito parlare di GitHub, è la più popolare destinazione per memorizzare e mantenere il codice open-source. Che potrebbe suonare come un pazzo per la scrittura, ma non è così! Dopo tutto, il codice è solo righe e righe di testo, come il tuo articolo, la storia, o tesi di laurea.

Il 2013, GitHub cominciato a incoraggiare le persone a creare repository per tutti i tipi di informazioni, non solo il codice. GitHub mai veramente lasciato la sua codificazione radici, ma alcune persone ancora utilizzano per memorizzare la scrittura e altri non-coding progetti. Per esempio, una persona Git e GitHub per scrivere un libro didattico, mentre un altro ha scritto un romanzo. Poke in giro su Google e troverete tutti i tipi di pazzi utilizza per GitHub.

Quali Sono Git e GitHub?

La sezione informativa di un repository GitHub.

Git è un programma open-source creato da Linus Torvalds, di Linux fame. Git tiene traccia delle modifiche apportate ai documenti e rende più facile per più persone di lavorare sullo stesso documento in remoto. In tech-parlare, si chiama un controllo di versione distribuito (o distribuito VCS). Git non arbitrariamente salvare le versioni dei documenti a intervalli prestabiliti. Invece, memorizza le modifiche apportate ai documenti solo quando gli si dice di.

I documenti formare un repository (o pct), che è un termine di fantasia per la cartella di progetto. La cartella Documenti in Windows, per esempio, sarebbe un repository, se hai usato Git gestione (ma non lo faccio).

Quando si salvano le modifiche apportate ai documenti in Git, si chiama “commit.” Un commit è solo un record delle più recenti modifiche apportate a un documento. Ogni commit viene assegnata una lunga stringa di numeri e lettere, come il suo ID.

Se si richiama un passato che si impegnano per il suo ID, non vedi l’intero progetto, come si fa in Word del documento di storia. Si vedono solo le modifiche più recenti che commettono quando è stata fatta. Tuttavia, questo non significa che l’intero progetto non è stato registrato. È possibile eliminare tutti i tuoi scrittura da una cartella di progetto e ancora ottenere la versione più recente indietro con un paio di comandi git. Si può anche andare indietro e vedere come il progetto sembrava una settimana fa, o sei mesi fa.

È inoltre possibile includere messaggi di commit, che è molto utile. Per esempio, se si scrive qualcosa, ma non sono sicuro che si desidera mantenere, basta fare un commit. La sezione quindi sopravvive nel commettere storia, anche se si elimina dal progetto in un secondo momento.

Git funziona meglio con la riga di comando, che è un grande vantaggio, ma ha anche i suoi lati negativi. La riga di comando è bene per creare impegna e caricare le modifiche. Tuttavia, se si desidera visualizzare un commit storia, non è l’ideale.

Questo è il motivo per cui molte persone come GitHub—popolare servizio online che offre una interfaccia web per il tuo repository Git. Su GitHub, è possibile visualizzare facilmente il passato si impegna, così come scaricare la tua scrittura a più Pc.

Insieme, Git e GitHub mi permetta di controllare la mia versione della storia a livello granulare. Ed è facile per ottenere il mio scrivere su qualsiasi PC che è possibile eseguire una riga di comando Bash che, in questi giorni, include Windows, Mac, Linux e Chrome OS macchine.

File Di Testo Semplice Rendere Le Cose Facili

Git può aiutare a salvare la tua scrittura, ma non può fare una migliore scrittore.

Git e GitHub fare il commit su praticamente qualsiasi tipo di file per la scrittura, anche se funziona meglio con il testo normale. Se si scrive in Microsoft Word, funzionerà, ma non sarà in grado di vedere il passato si impegna sulla riga di comando o in GitHub. Invece, è necessario richiamare un passato commit sulla riga di comando (denominato “cassa”), e quindi aprire il file di Word. Il file di Word, quindi, sembra proprio come ha fatto quando hai fatto l’originale commit, e si può tornare alla versione corrente con un altro comando rapido.

Se si utilizza Scrivener, che funziona, anche. Scrivener salva il file come file di testo, in modo che mostra anche in passato si impegna su GitHub e la linea di comando. Ma Scrivener, inoltre, consente di salvare i dati importanti per il programma, ma non a te. In ogni commit, vi ritroverete con un sacco di spazzatura che rende difficile la lettura.

Io uso normale file di testo, perché tutto ciò che hai bisogno di stringa insieme le parole, in modo particolare nelle prime bozze.

Iniziare con Git

Entriamo nei dettagli tecnici di come tutto questo funziona. Iniziamo con il PC, e poi passare al cloud con GitHub.

Per iniziare, è necessario che il programma di terminale sul macOS o Linux. Se il computer esegue Windows 10, è necessario installare Ubuntu o un’altra distribuzione Linux tramite il Sottosistema di Windows per Linux (WSL), che è abbastanza facile. È possibile controllare il nostro tutorial su come installare Linux shell Bash su Windows 10. O, se si utilizza una versione precedente di Windows, è possibile utilizzare Cygwin per ottenere una shell Bash.

Aprire il terminale e passare alla cartella che si desidera utilizzare come un repository Git. Per i nostri scopi, diciamo di avere una cartella chiamata “MyNovel” nella cartella Documenti. Nota che non c’è spazio tra le parole del nostro repository Git. Avrete la possibilità di rendere la tua vita più facile se lo fai in questo modo, come Bash non come gli spazi, e trattare con loro diventa confuso.

Successivamente, passare alla MyNovel cartella nel terminale. Per fare questo in Windows 10, il comando è:

cd /mnt/c:/Users/[nome utente]/Documenti/MyNovel

Qualsiasi WSL comando che interagisce con i file salvati in Windows, è necessario utilizzare /mnt/. Si noti, inoltre, che le minuscole “c” indica l’unità in su. Se i file sono su un “D:/” in auto, quindi si utilizza l’opzione /d/.

Per macOS e Linux il comando è molto più semplice:

cd ~/Documenti/MyNovel

Da qui, i comandi sono gli stessi.

Ora, dobbiamo inizializzare il MyNovel cartella di repository Git. Questo comando funziona se si sta appena iniziando un romanzo fresco o già alcuni file salvati all’interno.

git init

La cartella è ora un repository Git. Non mi credete? Tipo questo:

ls-a

Il comando chiede al computer di elenco tutto il contenuto della cartella corrente, tra cui oggetti nascosti. Si dovrebbe vedere qualcosa elencate verso l’alto chiamato “.git” (nota il periodo). Il nascosto “.git” la cartella è dove la vostra cronologia delle versioni del documento viene salvato. Non si dovrebbe mai bisogno di aprire questo, ma deve essere lì.

Il Primo Commit

Prima facciamo il nostro primo commit Git vuole sapere il tuo nome e indirizzo email. Git utilizza queste informazioni per identificare chi ha effettuato il commit, e che l’informazione è inclusa nel log del commit. Ai fini pratici, questo non importa, dal momento che gli scrittori sono in genere di volare da solo, ma Git ancora lo richiede.

Per impostare la tua email e gli indirizzi seguenti:

git config –global utente.e-mail “[la Tua email]”

git config –global utente.nome “[Tuo nome]”

Che è. Ora il primo commit.

Supponiamo ci sono tre documenti in “MyNovel” cartella denominata: “Chapter1,” “Chapter2,” e “Capitolo 3.” Per salvare le modifiche, dobbiamo dire Git per tenere traccia di questi file. Per fare questo, digitare:

git add .

Il periodo dice a Git per monitorare tutti untracked file nella cartella (ad es. file per cui si desidera creare storie). Questo comando dice anche Git per la preparazione è attualmente rilevati file che sono stati modificati. Questo processo è chiamato stadiazione file per il commit.

Per i nostri scopi, la messa in scena non è così importante, ma può essere utile. Se si apportano modifiche al Capitolo 2 e Capitolo 3, ma solo voglia di eseguire il commit delle modifiche nel Capitolo 2, è in scena il Capitolo 2 in questo modo:

git add Chapter2.doc

Questo dice a Git si desidera ottenere i cambiamenti nel Capitolo 2 pronto per il commit, ma non il Capitolo 3.

Ora, è tempo per il primo commit:

Git commit -m “Questo è il mio primo commit.”

La “m” è chiamato una bandiera, e dice a Git si vuole fare un commit e virare su un messaggio che potete vedere tra le virgolette. Mi piace usare i miei messaggi di commit a mark parola conta. Anche io li uso per nota speciale per le informazioni, come ad esempio: “Questo commit include un’intervista con il CEO di Acme Widget.”

Se sto scrivendo una storia, che potrebbe includere un messaggio che dice: “Questo commit è la nuova scena in cui il cane corre via.” Messaggi utili a rendere più semplice per trovare il tuo commette più tardi.

Ora che abbiamo iniziato a monitorare i nostri documenti, è tempo di mettere la nostra scrittura nel cloud con GitHub. Io uso GitHub come un backup, un posto sicuro a guardare le mie modifiche del documento, e un modo per accedere a la mia roba su più Pc.

Iniziare con GitHub

Si compila il modulo per creare un nuovo repository GitHub.

Innanzitutto, è necessario registrarsi per un account gratuito su GitHub (non hai bisogno di un account a pagamento per creare quelli privati). Tuttavia, si può solo collaborare con un massimo di tre persone su un privato repo. Se si dispone di un team di cinque o più di lavoro su un articolo, è necessario registrarsi per un account Pro (7 dollari al mese, alla stesura di questo documento).

Dopo aver creato il tuo account, facciamo un nuovo repo. Accedi al tuo account e vai alla https://github.com/new.

La prima cosa che dobbiamo fare è il nome del repository. È possibile utilizzare lo stesso nome utilizzato per la cartella sul tuo PC. Sotto “Nome Repository,” type “MyNovel.”

La “Descrizione” è opzionale, ma mi piace usarlo. È possibile digitare qualcosa come “il Mio favoloso nuovo romanzo parla di un ragazzo, una ragazza, e il loro cane”, etc.

Avanti, selezionare il pulsante di opzione”, ma non selezionare la casella “Inizializzare il repository con un README.” Non vogliamo farlo, perché abbiamo già un repository sul nostro PC. Se si crea un file README in questo momento, rende le cose più difficili.

Avanti, fare clic su “Crea Archivio.” Sotto, “Quick setup—se hai fatto una cosa del genere prima,” copia URL. Dovrebbe essere qualcosa come questo:

https://github.com/[il Tuo GitHub Nome Utente]/MyNovel.git

Adesso, si torna al desktop e la nostra amata riga di comando.

Spingere il Vostro Repository Desktop al Cloud

Utilizzando Git sulla riga di comando.

La prima volta che si collega un repo su GitHub, è necessario utilizzare alcuni comandi specializzati. Il primo è:

git remote add origine https://github.com/[il Tuo GitHub Nome Utente]/MyNovel.git

Questo dice a Git un repository remoto è l’origine di “MyNovel.” L’URL, quindi i punti di Git verso la remota origine. Non ottenere troppo appeso il termine “origine” è solo una convenzione. Si può chiamare “soffici”, se si desidera di origine è più semplice in quanto è il modo più comune per utilizzare Git.

Quando si carica nuove modifiche con Git, si chiama “push”. Quando si scarica modifiche, si chiama “tirare” o “fetch.” Ora, è il momento di spingere il vostro primo commit su GitHub. Ecco cosa dovete fare:

git push origin master u

Ti verrà chiesto di digitare il GitHub nome utente e la password. Se si digita correttamente le credenziali, tutto upload, e si sta bene ad andare.

Se vuoi più sicurezza per i vostri GitHub upload, è possibile utilizzare una chiave SSH. Questo permette di utilizzare una sola password per la chiave SSH per caricare, quindi, non è necessario digitare il proprio GitHub credenziali ogni volta. Inoltre, solo qualcuno con la chiave SSH possibile caricare le modifiche ai file.

Se volete maggiori informazioni su chiavi SSH, GitHub ha le istruzioni complete su come usarli. È inoltre possibile salvare il Git credenziali sul tuo PC.

Ecco!!! Ora, quando si desidera eseguire il commit delle modifiche ai file, è possibile farlo con questi tre comandi (dopo aver individuare il “MyNovel” cartella):

git add .

Traduzione: “Ehi, Git palco per commettere tutti i file non tracciati, così come le nuove modifiche al file che si sta già di monitoraggio.”

git commit -m “1000 parole sul nuovo iPhone di revisione”.

Traduzione: “Ehi, Git, salvare le modifiche al fianco di questo messaggio.”

git push origin master

Traduzione: “Ehi, Git, caricare le modifiche all’origine la versione di questo progetto su GitHub il mio maestro copia sul PC.”

Git e GitHub Bonus Suggerimenti

Questo è molto bello, ma qui ci sono un paio di suggerimenti per rendere la vostra esperienza con Git e GitHub ancora meglio:

Vista In Passato Si Impegna

Si può usare GitHub per vedere il passato si impegna.

Per visualizzare passato si impegna, vai al tuo MyNovel repository su GitHub. Verso la parte superiore della pagina principale, ai sensi del “Codice < >” scheda, è una sezione che dice: “[X] commette.”

Fare clic su di esso e vedrete un elenco di tutte le commette. Fare clic su commit che si desidera, e il testo (se l’hai scritto in testo normale e non di Parola, che è). Tutto ciò evidenziato in verde è il nuovo testo quando il commit è stato creato, tutto in rosso è stato eliminato.

Utilizzare il Comando Pull

E ‘ facile prendere un nuovo repository su una macchina diversa. Basta selezionare dove si desidera salvare il repo sulla nuova macchina, come i cd ~/Documenti. Quindi, digitare:

git pull https://github.com/[il Tuo GitHub Nome Utente]/MyNovel.git

Digitare le proprie credenziali, se richiesto, e in pochi secondi sarete pronti ad andare. Ora, impegnare nuove modifiche, e quindi inviare di nuovo a GitHub via git push origin master. Quando si arriva di nuovo al PC dove è di solito di lavoro, basta aprire la riga di comando, passare alla cartella del progetto, e il tipo in git pull. Le nuove modifiche si scarica, e proprio come il vostro progetto di scrittura è aggiornato su tutti i dispositivi.

Non Attraversare corsi

La maggior parte del tempo a scrivere non è un lavoro di squadra, e riguarda una sola persona. A causa di ciò, questo articolo utilizza Git in un modo che avrebbe funzionato per un multi-persona di progetto. In particolare, abbiamo fatto modifiche direttamente al master versione del nostro romanzo, invece di creare i cosiddetti “rami”. Un ramo è una pratica versione del romanzo, in cui è possibile apportare modifiche senza alterare l’originale. È come avere due diverse copie del proprio romanzo esistenti in parallelo senza influenzare l’altro. Se ti piacciono i cambiamenti nella pratica ramo è possibile unirli in versione master (o ramo master). Se non si desidera farlo, è troppo bella. Basta buttare via la pratica ramo.

I rami sono molto potenti, e il loro utilizzo sarebbe il principale flusso di lavoro con diversi scrittori su un singolo progetto. Solo gli scrittori non si ha realmente bisogno di utilizzare rami, a mio parere, a patto di non fare diverse modifiche al ramo master contemporaneamente su più Pc.

Per esempio, si dovrebbe completare il vostro lavoro sul vostro desktop, fare il commit, e quindi inserire le modifiche al GitHub. Poi vai al tuo portatile e tirare tutte le nuove modifiche prima di apportare eventuali ulteriori modifiche. Se non lo fai, si potrebbe finire con quello Git chiama “i conflitti.” Che quando Git dice, “Hey, ci sono cambiamenti in GitHub e su questo PC che non corrispondono. Mi aiuti a capire.”

Ordinamento il vostro modo di un conflitto può essere un dolore, quindi è meglio evitare, ogni volta che è possibile.

Una volta che si ottiene iniziato con Git, ci sono tonnellate di cose che si possono imparare, come ramificazione, la differenza tra un recupero e un pull, cosa GitHub tirare le richieste sono, e come affrontare il temuto conflitto.

Git può sembrare complicato per i nuovi arrivati, ma una volta a ottenere il blocco di esso, è un potente strumento che è possibile utilizzare per gestire e memorizzare la vostra scrittura.

CONTINUA A LEGGERE

• “Come Riciclare la Vecchia Elettronica non È Possibile Vendere
• “Come Controllare se Il Chromecast È Ancora Ottenere gli Aggiornamenti
• “Come Giocare Adobe Flash SWF File al di Fuori del Tuo Browser Web
• “Linee Di Comando: Perché La Gente Ancora Perdere Tempo Con Loro?
• “Cosa Fare Quando il Tuo Mac non si spegne