特定のタイトルを持つ一般的なスフィンクス勧告のマークアップを定義する

私はSphinxを使ってPythonプログラムのHTMLドキュメントを生成しています。

私は、一般的な admonition 指令(cf. http ://docutils.sourceforge.net/docs/ref/rst/directives.html#generic-admonition )を特定のタイトルで作成し、定義できるようにマークアップします。たとえば、 note ディレクティブ(boxed)ですが、色は異なります(ほとんどの警告は特にスタイル指定されていません、cf. http://sphinx.pocoo.org/rest.html?highlight=admonition )。

これについてはどうしたらいいですか?

14
私は上手く理解できていない気がします。 admonition ディレクティブを note ディレクティブのように正確に表示しますか?どうして? 「特定のスフィンクス勧告」とはどういう意味ですか?
追加された 著者 mzjn,
トピックディレクティブの使用はどうですか?
追加された 著者 crayzeewulf,
Okie dokie。私は、PDFとHTMLの両方の出力に似たものが欲しいと思っていました。そしてトピックは私のために仕事をしました。
追加された 著者 crayzeewulf,
@ mzjn:それを明確にするために質問を編集しました。
追加された 著者 equaeghe,
@crayzeewulf:いいえ、私はそれが admonition であることを意味的に望みます。バッドの答えは完璧です。
追加された 著者 equaeghe,

2 答え

私があなたの質問を正しく理解していれば、あなたはCuston CSSスタイルを警告に適用したいと思います。これを行うには、class:attibuteを使用します。

例えば、以下の

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

   this is the admonition text

レンダリングする

<div class="myownstyle admonition">
  

my title goes here

this is the admonition text

</div>

次に、独自のスタイルシートを追加します。たとえば、ソースディレクトリの_ テンプレートディレクトリのカスタム layout.html

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

次に、 myownstyle クラスのセレクタを使用して、スタイルシート内のCSSスタイルを使用して遊ぶことができます

12
追加された
Googleに正しく問題を表現していなかったので、これを理解するまで何時間もかかりました。あなたの答えは徹底的で、私が得ることができるよりも有用な情報が含まれています。
追加された 著者 Mad Physicist,

cssファイルを簡単に追加するには、それらを _static フォルダに置き、 conf.py に追加します。

def setup(app):
    app.add_stylesheet('custom.css')
3
追加された