il tutorial è molto semplice nei passi da seguire, partendo innanzitutto da questo video:
Clicca questo link per il plug-in da installare su Google Docs, oppure in un documento Google:
- Sul menu "componenti aggiuntivi" clicca “Installa componenti aggiuntivi”
- Nel box di ricerca edita
GGeditor
, e clicca sull'icona diGGeditor
per installare.
L'editor GG parte da uno scenario composto da 2 situazioni:
- Tu già hai un repository di progetto su Github,
- Tu già hai un progetto su Readthedocs.org che è in diretta relazione al repository su Github.
Github e Readthedocs accettano formati RST o Markup. Hai bisogno di costruire la documentazione in uno di questi due formati.
Questo è il flusso di lavoro con GGeditor
per costruire la documentazione su Github:
La sequenza di azioni che vengono effettuate da GGeditor su Google Doc nel processo che esso stesso gestisce. Ecco le fasi:
iniziare creando un nuovo documento su Google Docs.
Il nuovo file sarà nominato "Tutorial" (come nel caso di questa pagina che state leggendo). Il file contiene un'intestazione, un'immagine e una nota creata dal sidebar di
GGeditor
.Il nuovo file sarà compilato da
GGeditor
sul repository del progetto Github.Siccome questo è un file nuovo, un processo sarà avviato per costruire il legame agli altri documenti (es. index) nel repository Github. Il processo avviato include:
- log-in all'account Github che ospita il progetto su Github,
- azioni di navigazione dentro Github,
- creazione di un nuovo file
- e l'attività di compilazione (commit di Github).
Important
- Quando nomini il tuo documento Google Doc, il nome del documento non necessita del suffisso
.rst
. - Per legare il file del Google Doc sul repository del progetto (Github), Github ha bisogno del suffisso
.rst
. Il suffisso sarà automaticamente creato da GGeditor. Se nomini manualmente tu il file su Github allora aggiungi il suffisso.rst
(sulla directorydocs
di Github).
Tip
Il contenuto di questa pagina che stai leggendo è in questo Google Doc
Please enable JavaScript to view the comments powered by Disqus.