PIB

Sphinx で html や latex を出力してみると、段落の1行目行頭のインデントが入らない。
「sphinx 段落 1行目 字下げ」とか
「sphinx 段落 行頭」とかでググってみたがめぼしい情報にありつけない。

そう言えば、sphinx で出版やってた人がいなかったか？と思い
「sphinx 出版」でググってみると、

• slideshare / shimizukawa / 2014-12-06: 執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話

が見つかったのだが、スライド中のサンプルを見ると、段落行頭の字下げがない。

これ、みんな気にならんのか？

気を取り直して「sphinx paragraph first-line indent」でググってみると以下のページを見つけた。

• StackExchange / {TeX} / 2013-07-15: How to remove the indentation from the first line of a paragraph

曰く、

p {text-indent: 1em;}

みたいな内容で

• _static/custom.css

を作って、

• conf.py

に

html_css_files = ['custom.css']

を追加をしなさいとの事。

LaTeX の方は、キーワードに latex を追加したりしてみても芳しい結果が得られなかったのだが、
「sphinx paragraph first-line indent latex conf.py」でググってみると、公式ページの

• Sphinx / Documentation / LaTeX customization

が引っかかって、どうやら、 conf.py の latex_elements.preamble に .tex に取り込ませる preamble を直接書けるっぽいことが分かった。
という事で、conf.py に以下の記述を追加することで、字下げ出来た。

latex_elements = {
    'preamble': r'''
\setlength{\parindent}{1em}
''',

• Sphinx