日本語対応にする（日本語拡張の導入）

日本語の文章を HTML に変換すると、文書の途中に不自然なタイミングで空白が挿入される場合があります。この事象の対応策として日本語拡張を導入します。

事象の詳細

Sphinxの日本ユーザ会の下記ページを参照ください。

日本語拡張の導入手順

重要

この手順は文書ごとに必要です。

  1. ブラウザーで https://github.com/sphinxjp/goodies を開く

    ../_images/2020-10-17_17h47_12.png

  2. Code をクリック　→　Download ZIP をクリック

    ../_images/2020-10-17_17h47_26.png

  3. ZIP ファイルのダウンロード終了　→　・・・ をクリック　→　フォルダーに表示(S) をクリック

    ../_images/2020-10-17_17h47_55.png

  4. ダウンロードした ZIP ファイルを確認　→　展開

    ../_images/2020-10-17_17h49_59.png

  5. 展開後のファイルを確認

    ユーザー名が user の場合、次のフォルダーにファイルがあります。

    C:¥Users¥user¥Downloads¥goodies-master¥goodies-master¥exts¥japanesesupport
    ../_images/2020-10-17_17h50_42.png

  6. 展開後の "japanesesupport.py" ファイルを "conf.py" ファイルと同じフォルダーに保存

    ../_images/2020-10-17_17h55_36.png

    ↓

    ../_images/2020-10-17_17h55_46.png

  7. テキストエディターで "conf.py" ファイルを開く

    ../_images/2020-03-01_11h48_34.png

  8. 2 箇所修正　→　保存

    注釈

    Sphinx のバージョンにより行位置が異なります。

    13 行目

    • 修正前　# import os

    • 修正後　import os

    14 行目

    • 修正前　# import sys

    • 修正後　import sys

    15 行目

    • 修正前　# sys.path.insert(0, os.path.abspath('.'))

    • 修正後　sys.path.insert(0, os.path.abspath('.'))

    32 行目

    • 修正前　extensions = [

    • 修正後　extensions = ['japanesesupport'

    ../_images/2020-03-01_13h28_11.png

  9. 導入終了