.. _h317c7246b4714a387ea464e255c65: Le funzioni su Google doc ************************* .. _h236ac45675e486e35e3a5f48334c: Uno strumento per i principianti dei file ‘rST’ =============================================== Se sei all’inizio della conoscenza dei file con sintassi RST (reStructuredText) e ti senti un po confuso sul come inserire i tuoi documenti sul portale di Read the Docs, questo strumento fa sicuramente per te. Con il componente aggiuntivo ``GGeditor`` per Google doc e questo piccolo tutorial tradotto in italiano dal tutorial originale, spero che potrai essere assistito nel realizzare il tuo lavoro in maniera facile e veloce. Se dopo averlo letto ti è rimasto qualche dubbio, beh.. contattami: \ |LINK1|\ . | .. _h69720e657d494a1e311319c6d5a9: Il plug-in di Google Doc, ``GGeditor`` ====================================== Per prima cosa da Google Doc si va su "Componenti aggiuntivi", si cerca e si installa il plug-in ``GGeditor`` \ |IMG1|\ così si può cominciare ad usare il set di strumenti del menu che appare se clicchiamo su "componenti aggiuntivi", poi su ``GGeditor`` e poi ancora su "Show Markup Panel". | .. _h493657176f3a69a446e5e556f6275: I settings dell’account Github ============================== \ |IMG2|\ Dalla finestra “settings” è possibile agganciare il proprio account Github al plugin ``GGeditor`` in maniera tale che ogni volta che vogliamo commissionare un Google Doc su Gihub, cliccando su “Commit to Github” è possibile visualizzare l’elenco dei nostri repository su Github. Si seleziona quel repository che ci interessa sul quale intendiamo lavorare e si procede con l’azione di Commit del Google Doc. L’operazione è molto semplice e alla portata di tutti perché non richiede particolari conoscenze specifiche. | .. _h601f746f763ac7b685709473b411e: Il ‘Markup Panel’ e le relative funzioni ======================================== Cliccando su su "Show Markup Panel" viene visualizzato questo pannello. \ |IMG3|\ che ci consente di inserire sul documento in Google Doc: * Note colorate, personalizzabili nel titolo; * Codice da illustrare in una pagina HTML; * Tabella dell'indice dei contenuti (cioè il titolo delle pagine che compongono l'indice dei contenuti). | .. _h4e3124764f272f2e5140635c69434d1a: La costruzione dell’indice del documento ======================================== Dal Markup Panel di ``GGeditor`` è possibile costruire l’\ |STYLE0|\ del documento da visionare sulle pagine HTML del progetto su Read the Docs. Una volta inserita la maschera come di seguito rappresentato, basta editare il titolo delle altre pagine Google Doc che avete creato dentro la stessa directory di Google Drive. Sul file ``.rst`` che ``GGeditor`` crea verrà creato un indice che a sua volta verrà visualizzato su Read the Docs. La procedura è di estrema facilità. Dopo ``:caption:`` è possibile scrivere il nome che si vuole dare all’\ |STYLE1|\ , o semplicemente scrivere “indice”. Ogni volta che si crea un nuovo Google Doc da agganciare all’indice basta riportare il titolo del Google Doc in questa maschera. \ |IMG4|\ la sintassi da editare per creare l’indice è la seguente .. code:: .. toctree:: :maxdepth: 3 :caption: Indice gdocs-rtd tutorial come-usarlo lavoro-github lavoro-rtd user-guide hypothesis-partecipazione pubblicare-su-docs-italia sintassi-rst tabelle licenza | .. _h462161427c28784e5856261530654d2a: Inline Markups - Marcatori in linea =================================== Some inline reStructuredText markups can be used directly in the document. The table below shows the usage example of these inline markups. +---------------------------+-----------------------+ |In Google Docs document |Rendered in HTML page | +===========================+=======================+ |A \`single back-quote\` |A `single back-quote` | +---------------------------+-----------------------+ |A \`\`double back-quote\`\`|A ``double back-quote``| +---------------------------+-----------------------+ |A \|replacement\| markup |A |replacement| markup | +---------------------------+-----------------------+ That is converted from the source content in document: |REPLACE1| Please noted that if you manually put a substitution markup, you got to provide correct replacement markup manually too. Otherwise, the sphinx parser will raise exception. | .. _he522c10014793d3628295910674be: Inserimento di blocchi di codice ================================ | .. _h6232322f402c4424411c44237b365b1f: blocco di codice senza righe numerate ------------------------------------- .. code:: #!/usr/bin/env python """ Twisted moved the C{twisted} hierarchy to the C{src} hierarchy, but C{git} doesn't know how to track moves of directories, only files. Therefore any files added in branches after this move will be added into ./twisted/ and need to be moved over into """ import os from twisted.python.filepath import FilePath here = FilePath(__file__).parent().parent() fromPath = here.child("twisted") toPath = here.child("src") for fn in fromPath.walk(): if fn.isfile(): os.system("git mv {it} src/{it}" .format(it="/".join(fn.segmentsFrom(here)))) os.system('git clean -fd') def outer(x): def indent_start(x): go start start go start end def end(y): go end start go end end | .. _h1947453a6f5842371b415a43c152270: blocco di codice con righe numerate ----------------------------------- .. code-block:: python :linenos: #!/usr/bin/env python """ Twisted moved the C{twisted} hierarchy to the C{src} hierarchy, but C{git} doesn't know how to track moves of directories, only files. Therefore any files added in branches after this move will be added into ./twisted/ and need to be moved over into """ import os from twisted.python.filepath import FilePath here = FilePath(__file__).parent().parent() fromPath = here.child("twisted") toPath = here.child("src") for fn in fromPath.walk(): if fn.isfile(): os.system("git mv {it} src/{it}" .format(it="/".join(fn.segmentsFrom(here)))) os.system('git clean -fd') def outer(x): def indent_start(x): go start start go start end def end(y): go end start go end end | .. _hd7c7684b1f6f6938346a47481f335a: Visualizzazione di messaggi di errore: ‘undefined’ o messaggio ‘in lingua taiwanese’. Come risolverli. ====================================================================================================== Se durante la procedura di commit dal Google doc a Github viene visualizzato ripetutamente un messaggio di “\ |STYLE2|\ ” o un \ |STYLE3|\ , che non permette di portare a termine il commit, l’azione da compiere è la seguente: andare in “\ |STYLE4|\ ”, poi “\ |STYLE5|\ ” e quindi su “\ |STYLE6|\ ” dove si trova un tasto rosso di “\ |STYLE7|\ ” che cancella tutte le informazioni di collegamento agli account Github e ai relativi file nel repository. In effetti quello che avviene è una pulizia della cache, è come se si fosse appena installato il componente aggiuntivo ``GGeditor`` sul Google doc. In \ |LINK2|\ vengono illustrati anche i messaggi che possono apparire nel caso descritto. | .. _h2d563d172468654f422b2867379527c: Inserire note colorate di vario tipo ==================================== Attraverso il tasto ‘Show markup panel’ è possibile inserire nel doc, e quindi nel progetto “read the docs” alcuni box per attirare l’attenzione del lettore su alcuni contenuti della pubblicazione. Eccoli di seguito elencati. .. Attention:: (content of Attention) .. Caution:: (content of Caution) .. Warning:: (content of Warning) .. Danger:: (content of Danger) .. Error:: (content of Error) .. Hint:: (content of Hint) .. Important:: (content of Important) .. Tip:: (content of Tip) .. Note:: (content of Note) .. seealso:: (content of See also) .. admonition:: Change-me (content of Change-me) | .. _h707a11392e79362d3f1b15163c78603: Inserire in alcune pagine la possibilità di far lasciare commenti ================================================================= In alcune pagine HTML del progetto Read the Docs, l’editore del documento da pubblicare online potrebbe avere l’esigenza di raccogliere commenti. In questo caso, cioè solo quando questa esigenza dei commenti è relativa ad alcune pagine HTML del documento e non in tutte, viene in aiuto il servizio online di \ |LINK3|\ . Si procede innanzitutto creando un account in questo servizio e successivamente si crea un progetto, fornendo un URL a cui agganciare il servizio di Disqus. Lo stesso Disqus fornisce un codice HTML che bisogna copiare e incollare dentro un box HTML all’interno del Google doc nel quale si desidera far lasciare commenti. Il codice Disqus di questa pagina ad esempio è il seguente ed è editato alla fine di questo Google doc che genera la pagina HTML sul progetto di Read the Docs: .. code::
| .. _h3a59e6864f77431c1e4a2506018a: Altre (tante) utili funzioni di ``GGeditor`` ============================================ \ |IMG5|\ Inline Markups, Table, Image, Conversion. \ |LINK4|\ e \ |LINK5|\ sono descritte molte funzioni che possono essere attivate con ``GGeditor``, quale per esempio quella della \ |STYLE8|\ , quindi con la sintassi tipica di questo linguaggio. | .. _h5e47743d14d4a78484827c42059: Conversione di testo da Google doc a file .RST per il download ============================================================== Il componente aggiuntivo ``GGeditor`` permette anche la funzione di conversione del testo in linguaggio .RST (vedi \ |LINK6|\ per le funzioni complete di conversione). Praticamente è possibile, tramite una finestra dedicata, far convertire a GGeditor testo direttamente in linguaggio .RST. Si può convertire tutto il testo, una parte, o ad esempio una tabella. Ci sono delle regole di conversione già illustrate nella stessa finestra denominata “Conversion”. Una volta convertito il testo appare un messaggio di avvenuta conversione ed è possibile effettuare il download del testo convertito in formato .RST oppure selezionarlo e copiarlo in un editor testuale per un ulteriore riuso. \ |IMG6|\ .. bottom of content .. |STYLE0| replace:: **indice** .. |STYLE1| replace:: **indice** .. |STYLE2| replace:: **undefined** .. |STYLE3| replace:: **messaggio di error in lingua taiwanese** .. |STYLE4| replace:: **Componenti aggiuntivi** .. |STYLE5| replace:: **GGeditor** .. |STYLE6| replace:: **Setting** .. |STYLE7| replace:: **Reset** .. |STYLE8| replace:: **conversione del contenuto del nostro Google Doc in un file formato RST** .. |REPLACE1| raw:: html .. |LINK1| raw:: html cirospat@gmail.com .. |LINK2| raw:: html questa parte del tutorial .. |LINK3| raw:: html Disqus .. |LINK4| raw:: html Qui .. |LINK5| raw:: html qui (esempi) .. |LINK6| raw:: html link .. |IMG1| image:: static/come-usarlo_1.png :height: 109 px :width: 485 px .. |IMG2| image:: static/come-usarlo_2.png :height: 213 px :width: 601 px .. |IMG3| image:: static/come-usarlo_3.png :height: 496 px :width: 292 px .. |IMG4| image:: static/come-usarlo_4.png :height: 269 px :width: 276 px .. |IMG5| image:: static/come-usarlo_5.png :height: 294 px :width: 290 px .. |IMG6| image:: static/come-usarlo_6.png :height: 274 px :width: 601 px