, belirli bir başlığa sahip genel sfenks uyarıları için işaret tanımlayın

Question

Bir Python programı için HTML belgeleri oluşturmak üzere Sphinx kullanıyorum.

I fakat, kutu, örneğin note yönergesi, oluşturulacak içerik gibi, örneğin, tanımlamam bir şekilde o kadar işaretlenmiş spesifik bir başlık ile genel admonition yönergesi (bakınız http://docutils.sourceforge.net/docs/ref/rst/directives.html#generic-admonition) kullanın ve istiyorum Farklı bir renk (çoğu uyarı özellikle özel değil, bkz. http://sphinx.pocoo.org/rest.html?highlight=admonition).

Bunun için en iyi şekilde nasıl giderim?

Answer 1

Sorunuzu doğru bir şekilde anladıysam, bildirime bir Custon CSS stili uygulamak istersiniz. Bunu bir: class: attibute ile yapabilirsiniz.

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

    this is the admonition text 

aşağıdaki Örneğin

, sonra kendi stil sayfası eklemek

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

olarak vermektedir. Örneğin, _ şablonlarına özel bir layout.html ederek kaynak dizinde dizini:

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

Sonra için uyarlanmış bir seçici kullanarak stil sayfasında CSS stilleri ile oynayabilir myownstyleconf.py eklemek bu daha sonra, daha kolay css dosyaları eklemek _static klasöre koyun ve için

Answer 2

sınıfı:

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