Directiva: codeblock

La directiva codeblock se utiliza para mostrar porciones de código fuente coloreando la sintáxis.

Esta directiva requiere tener instalada la biblioteca pygments, cosa que puedes hacer usando un comando cómo:

sudo easy_install pygments

Luego, para usar la directiva solo tienes que indicar el lenguaje de programación:

.. code-block:: python

    import os

    print os.path.join('usr', 'share')

Lo que producirá un código coloreado y mas fácil de leer:

import os

print os.path.join('usr', 'share')

Ten en cuenta que si quieres colorear código en lenguaje php tienes que usar los símbolos <?php y ?> al principio y al final del código, por ejemplo:

.. code-block:: php

    <?php
    echo "Hola mundo";
    ?>