Sphinx拡張 コラム用マークアップ column ディレクティブ column.py

README.rst

column.py を 以下のように配置:

sphinx-project/
+- index.rst
+- conf.py
+- ext/column.py
+- _static/custom.css

conf.py に設定を追加

column.py

from docutils.parsers.rst.directives.admonitions import Admonition
from docutils import nodes


class ColumnDirective(Admonition):
    node_class = nodes.admonition
    required_arguments = 1

    def run(self):
        self.arguments[0] = u'コラム　' + self.arguments[0]
        self.options.setdefault('class', []).append(self.name)
        r = Admonition.run(self)
        r[0]['name'] = self.name
        return r


def setup(app):
    app.add_directive('column', ColumnDirective)

conf.py

import os
import sys

sys.path.insert(0, os.path.abspath('ext'))

extensions = ['column']

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

custom.css

div.admonition.column {
	background-color: #CFC;
	border-color: #AFA;
}

div.column p.admonition-title {
	display: block;
}