Zenn
Open5

Sphinxの拡張パッケージ

Sphinx
shotakahashotakaha

myst-parser

https://pypi.org/project/myst-parser/

  • SphinxでMarkdownするための必須パッケージ
  • MySTはMarkdownの方言の一つ
    • CommonMarkのsupersetに、reST記法（ロールとディレクティブの概念）をとりんだもの
    • Markdownがシンプルな故に不便だった部分が、解消されている感じがする
shotakahashotakaha

myst-nb

https://github.com/executablebooks/MyST-NB

  • .ipynb形式をSphinxのページとして使えるようになる
  • PyPIにあるバージョンは、依存パッケージのバージョン上限がついているので、新しめのmyst_parserなどが使えない。そのため、GitHubを指定してpoetry addした。
$ poetry add --group=docs git+https://github.com/executablebooks/MyST-NB.git
  • myst_nbを使う場合はmyst_parserをコメントアウトする
    • myst_nbをロードするとmyst_parserもロードされるため
    • 両方をextensionsに書くと、変数が二重に定義されたりしてエラーがでる
extensions = [
    ...,
    # "myst_parser",
    "myst_nb",
    ...,
]


- ``myst-parser``とdoujini