.. _package/docu/contenuto: Immagini, Allegati e Link ========================= Il DOCU permette l'inserimento di contenuti in linguaggio RST. Il RST è un markup language, un linguaggio di marcatura, che permette di descrivere i dati e le istruzioni attraverso una formattazione specifica che utilizza i cosiddetti tag, cioè dei marcatori. Per un approfondimento sul linguaggio RST si invita a consultare il seguente link: https://googledocs.readthedocs.io/it/latest/sintassi-rst.html In questa sezione ci concentreremo più che altro sull'inserimento di immagini, video e allegati. Cliccando sulla linguetta a destra della schermata è possibile aprire l'interfaccia di gestione di **snippet** e **attachment**. .. image:: /_static/images/docu/attachments.png :width: 280px :align: center :height: 250px Inserire uno snippet -------------------- Lo snippet è una stringa di codice a piacimento, può essere un frammento di RST, python o html, o anche solo semplicemente testo che è possibile copiare nella form con un semplice trascinamento. In questo Documentatore per esempio abbiamo creato due snippet: 1) "section" permette di ricopiare il comando RST per creare una sezione 2) "video" permette di copiare il codice html per l'embed di un video. Trattandosi semplicemente di un blocco di caratteri, è possibile sbizzarrirsi nella creazione a proprio piacimento, a seconda dell'utilizzo che si fa maggiormente nella redazione della propria Documentazione Inserire immagini e allegati ---------------------------- L'altro tab dell'interfaccia ci consente invece di gestire l'area degli allegati. Per il caricamento all'interno del DOCU è sufficiente trascinare immagini e documenti all'interno di quest'area. Se si vuole poi visualizzare un'immagine all'interno del testo si può procedere con un'ulteriore operazione di trascinamento da questa interfaccia alla nostra form. Noteremo che l'immagine verrà "tradotta" in qualche riga di codice contenente il riferimento al file e le dimensioni. Sarà quindi sufficiente sostituire le dimensioni con quelle desiderate. Se invece si vuole utilizzare un allegato come documento disponibile per lo scaricamento a pié di pagina (come gli allegati del nostro :ref:`Tutorial: Costruiamo un'applicazione di fatturazione` ), allora non dovremo trascinare nulla ma flaggare la checkbox DL (Download). In questo caso stiamo attenti al nome del file perché sarà quello utilizzato anche nel documento pubblicato. .. image:: /_static/images/docu/allegati-dl.png :width: 299 :align: center :height: 259px Link ---- Ancora una volta grazie alla sua natura di table gerarchica, è possibile trascinare un ramo della tabella direttamente nella form per creare un link. In caso di spostamento della voce di documentazione questo link verrà aggiornato di conseguenza, agevolandoci il lavoro di continuo aggiornamento della nostra documentazione. .. sectionauthor:: Davide Paci