Lines Matching refs:per
11 Il kernel Linux usa `Sphinx`_ per la generazione della documentazione a partire
23 Solitamente questi commenti sono utilizzati per descrivere le funzioni, i tipi
37 I marcatori ReST utilizzati nei file in Documentation/ sono pensati per essere
48 Un modo per evitare questo genere di problemi è quello di utilizzare una
56 #) Viene raccomandato l'uso del tema RTD per la documentazione in HTML.
71 Dopo aver eseguito ``. sphinx_2.4.4/bin/activate``, il prompt cambierà per
73 prima di generare la documentazione, dovrete rieseguire questo comando per
80 capace di gestire immagini in formato Graphviz e SVG (per maggior informazioni
99 minimo per il funzionamento di ``XeLaTeX``.
108 sarà in grado di darvi dei suggerimenti su come procedere per completare
123 L'impostazione predefinita prevede il controllo dei requisiti per la generazione
124 di documenti html e PDF, includendo anche il supporto per le immagini, le
126 ambiente virtuale per Python. I requisiti per generare i documenti html
132 Disabilita i controlli per la generazione di PDF;
136 l'ambiente virtuale per Python;
144 in cui è possibile generare la documentazione; per maggiori informazioni
149 Ovviamente, per generare la documentazione, Sphinx (``sphinx-build``)
150 dev'essere installato. Se disponibile, il tema *Read the Docs* per Sphinx
151 verrà utilizzato per ottenere una documentazione HTML più gradevole.
175 Questo, di solito, è sufficiente per la documentazione più semplice (come
176 quella che state leggendo ora), ma per una documentazione più elaborata è
183 Consultate la documentazione di `Sphinx`_ e `reStructuredText`_ per maggiori
187 `costruttori specifici per Sphinx`_.
190 .. _`costruttori specifici per Sphinx`: http://www.sphinx-doc.org/en/stable/markup/index.html
192 Guide linea per la documentazione del kernel
195 In questa sezione troverete alcune linee guida specifiche per la documentazione
211 1. ``=`` con una linea superiore per il titolo del documento::
217 2. ``=`` per i capitoli::
222 3. ``-`` per le sezioni::
227 4. ``~`` per le sottosezioni::
239 evidenziare la sintassi, specialmente per piccoli frammenti; invece,
240 utilizzate ``.. code-block:: <language>`` per blocchi più lunghi che
255 Il dominio C per kernel-doc ha delle funzionalità aggiuntive. Per esempio,
264 Il nome della funzione (per esempio ioctl) rimane nel testo ma il nome del suo
268 Notate che per una funzione non c'è bisogno di usare ``c:func:`` per generarne
294 * auto-span: la cella più a destra viene estesa verso destra per compensare
315 ( ``..`` ) ed i *collegamenti* (per esempio, un riferimento a
381 Vedere :doc:`il mio testo per il collegamento <sphinx>`.
389 kernel-doc per funzioni o tipi, consultate
397 e ``kernel-image``. Per esempio, per inserire una figura di un'immagine in
412 Le direttive del kernel per figure ed immagini supportano il formato **DOT**,
413 per maggiori informazioni