Lines Matching +full:lo +full:- +full:x2 +full:- +full:en
1 .. include:: ../disclaimer-ita.rst
4 :ref:`Documentation/doc-guide/index.rst <doc_guide>`
18 .. _Sphinx: http://www.sphinx-doc.org/
22 includere i commenti di documentazione, o di tipo kernel-doc, dai file
25 e l'architettura del codice. I commenti di tipo kernel-doc hanno una struttura
42 consultate :ref:`it_sphinx-pre-install`.
52 ``virtualenv-3`` o ``virtualenv`` a seconda di come Python 3 è stato
70 (sphinx_2.4.4) $ pip install -r Documentation/sphinx/requirements.txt
78 ----------------------
90 --------------------------
102 .. _it_sphinx-pre-install:
105 -------------------------------
108 Sphinx. Se lo script riesce a riconoscere la vostra distribuzione, allora
112 $ ./scripts/sphinx-pre-install
114 Warning: better to also install "texlive-luatex85".
117 sudo dnf install -y texlive-luatex85
120 pip install -r Documentation/sphinx/requirements.txt
122 Can't build as 1 mandatory dependency is missing at ./scripts/sphinx-pre-install line 468.
132 ``--no-pdf``
135 ``--no-virtualenv``
150 Ovviamente, per generare la documentazione, Sphinx (``sphinx-build``)
160 la generazione potete usare il seguente comando ``make SPHINXOPTS=-v htmldocs``.
177 .. _TOC tree: http://www.sphinx-doc.org/en/stable/markup/toctree.html
193 .. _`manuale introduttivo a reStructuredText`: http://www.sphinx-doc.org/en/stable/rest.html
194 .. _`costruttori specifici per Sphinx`: http://www.sphinx-doc.org/en/stable/markup/index.html
197 --------------------------------------------
226 3. ``-`` per le sezioni::
229 -------
244 utilizzate ``.. code-block:: <language>`` per blocchi più lunghi che
250 ------------
255 .. code-block:: rst
259 Il dominio C per kernel-doc ha delle funzionalità aggiuntive. Per esempio,
263 .. code-block:: rst
281 ---------------
283 Il formato ``list-table`` può essere utile per tutte quelle tabelle che non
284 possono essere facilmente scritte usando il formato ASCII-art di Sphinx. Però,
289 La ``flat-table`` è anch'essa una lista di liste simile alle ``list-table``
292 * column-span: col ruolo ``cspan`` una cella può essere estesa attraverso
295 * raw-span: col ruolo ``rspan`` una cella può essere estesa attraverso
298 * auto-span: la cella più a destra viene estesa verso destra per compensare
299 la mancanza di celle. Con l'opzione ``:fill-cells:`` questo comportamento
300 può essere cambiato da *auto-span* ad *auto-fill*, il quale inserisce
305 * ``:header-rows:`` [int] conta le righe di intestazione
306 * ``:stub-columns:`` [int] conta le colonne di stub
308 * ``:fill-cells:`` invece di estendere automaticamente una cella su quelle
322 .. code-block:: rst
324 .. flat-table:: table title
327 * - head col 1
328 - head col 2
329 - head col 3
330 - head col 4
332 * - row 1
333 - field 1.1
334 - field 1.2 with autospan
336 * - row 2
337 - field 2.1
338 - :rspan:`1` :cspan:`1` field 2.2 - 3.3
342 - row 3
346 .. flat-table:: table title
349 * - head col 1
350 - head col 2
351 - head col 3
352 - head col 4
354 * - row 1
355 - field 1.1
356 - field 1.2 with autospan
358 * - row 2
359 - field 2.1
360 - :rspan:`1` :cspan:`1` field 2.2 - 3.3
364 - row 3
367 ----------------------
377 Vedere Documentation/doc-guide/sphinx.rst. Questo funziona sempre
393 kernel-doc per funzioni o tipi, consultate
400 Se volete aggiungere un'immagine, utilizzate le direttive ``kernel-figure``
401 e ``kernel-image``. Per esempio, per inserire una figura di un'immagine in
404 .. kernel-figure:: ../../../doc-guide/svg_image.svg
411 .. kernel-figure:: ../../../doc-guide/svg_image.svg
420 * Graphviz: http://www.graphviz.org/content/dot-language
424 .. kernel-figure:: ../../../doc-guide/hello.dot
431 .. kernel-figure:: ../../../doc-guide/hello.dot
436 Tramite la direttiva ``kernel-render`` è possibile aggiungere codice specifico;
439 .. kernel-render:: DOT
444 "bar" -> "baz";
453 .. kernel-render:: DOT
458 "bar" -> "baz";
469 .. kernel-render:: SVG
471 :alt: so-nw-arrow
473 <?xml version="1.0" encoding="UTF-8"?>
480 .. kernel-render:: SVG
482 :alt: so-nw-arrow
484 <?xml version="1.0" encoding="UTF-8"?>
487 <line x1="180" y1="370" x2="500" y2="50" stroke="black" stroke-width="15px"/>