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

私は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
追加された 編集された
ビュー: 2
源
ru fr es pt de ar
私は上手く理解できていない気がします。 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
追加された
源