definire markup per ammonizioni generiche di sfinge con un titolo specifico

Question

Sto usando Sphinx per generare documentazione HTML per un programma Python.

Vorrei utilizzare la direttiva generica admonition (cfr http://docutils.sourceforge.net/docs/ref/rst/directives.html#generic-admonition) con un titolo specifico e lo hanno segnato in un modo posso definire, ad esempio, come il contenuto generato con la direttiva note, vale a dire, in scatola, ma con un colore diverso (la maggior parte delle avvertenze non ha uno stile particolare, vedi http://sphinx.pocoo.org/rest.html?highlight=admonition).

Come posso fare meglio?

Answer 1

Se ho capito correttamente la tua domanda, ti piacerebbe applicare uno stile CSS custon per l'ammonizione. Puoi farlo con un: class: attibute.

Ad esempio, il seguente

.. admonition:: my title goes here 
    :class: myOwnStyle 

    this is the admonition text 

rende come

<div class="myownstyle admonition"> 
    <p class="first admonition-title">my title goes here</p> 
    <p class="last">this is the admonition text</p> 
</div> 

È quindi aggiungere il proprio foglio di stile. Ad esempio, una consuetudine layout.html nelle _ modelli directory nel fonte directory:

{% extends "!layout.html" %} 
{% set css_files = css_files + ["_static/customstyle.css"] %} 

Poi si può giocare con gli stili CSS nel foglio di stile utilizzando un selettore per la myownstyle classe

Answer 2

per aggiungere file css più facilmente, li ha messi nella cartella _static e quindi aggiungere questo al conf.py:

def setup(app): 
    app.add_stylesheet('custom.css')