.. _h6c52547a65c33747d33332d693a6f49:

Tutorial sull'uso di ``GGeditor``
#################################

il tutorial è molto semplice nei passi da seguire, partendo innanzitutto da questo video:

|REPLACE1|

|

.. _h2f2b30171b482c554fb1c779f4372:

Come installare ``GGeditor``
============================

\ |LINK1|\ , oppure in un documento Google:

#. Sul menu "componenti aggiuntivi" clicca “Installa componenti aggiuntivi”

#. Nel box di ricerca edita ``GGeditor``, e clicca sull'icona di ``GGeditor`` per installare.

L'editor GG parte da uno scenario composto da 2 situazioni:

#. Tu già hai un repository di progetto su \ |STYLE0|\ , 

#. Tu già hai un progetto su \ |STYLE1|\  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. 

|

.. _h121e9641f422b72296c432f68601738:

Il flusso di lavoro del processo che gestisce ``GGeditor``
==========================================================

Questo è il flusso di lavoro con ``GGeditor`` per costruire la documentazione su Github:

\ |IMG1|\ 

|

.. _h654f3f505b234d7f635423f1be7b1c:

Le azioni svolte da ``GGeditor``
================================

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 directory ``docs`` di Github).

|


..  Tip:: 

    Il contenuto di questa pagina che stai leggendo è in \ |LINK2|\ 

|


|REPLACE2|


.. bottom of content


.. |STYLE0| replace:: **Github**

.. |STYLE1| replace:: **Readthedocs.org**


.. |REPLACE1| raw:: html

    <iframe width="100%" height="500" src="https://www.youtube.com/embed/PUswAbvpE7c" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
.. |REPLACE2| raw:: html

    <script id="dsq-count-scr" src="//guida-readthedocs.disqus.com/count.js" async></script>
    
    <div id="disqus_thread"></div>
    <script>
    
    /**
    *  RECOMMENDED CONFIGURATION VARIABLES: EDIT AND UNCOMMENT THE SECTION BELOW TO INSERT DYNAMIC VALUES FROM YOUR PLATFORM OR CMS.
    *  LEARN WHY DEFINING THESE VARIABLES IS IMPORTANT: https://disqus.com/admin/universalcode/#configuration-variables*/
    /*
    
    var disqus_config = function () {
    this.page.url = PAGE_URL;  // Replace PAGE_URL with your page's canonical URL variable
    this.page.identifier = PAGE_IDENTIFIER; // Replace PAGE_IDENTIFIER with your page's unique identifier variable
    };
    */
    (function() { // DON'T EDIT BELOW THIS LINE
    var d = document, s = d.createElement('script');
    s.src = 'https://guida-readthedocs.disqus.com/embed.js';
    s.setAttribute('data-timestamp', +new Date());
    (d.head || d.body).appendChild(s);
    })();
    </script>
    <noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>

.. |LINK1| raw:: html

    <a href="https://chrome.google.com/webstore/detail/ggeditor/piedgdbcihbejidgkpabjhppneghbcnp" target="_blank">Clicca questo link per il plug-in da installare su Google Docs</a>

.. |LINK2| raw:: html

    <a href="https://docs.google.com/document/d/1K-DgqG44wYnkti_tG1ULCx5utpDcWuTVeAI4158nXhQ" target="_blank">questo Google Doc</a>


.. |IMG1| image:: static/tutorial_1.png
   :height: 406 px
   :width: 601 px