変更履歴#
v0.18.0#
実装された機能拡張
計算時間の書き込みを無効にする機能を追加 #1385 (bmwiedemann)
修正されたバグ
プロジェクトメンテナンス
[pre-commit.ci] pre-commit autoupdate #1387 (pre-commit-ci[bot])
actionsグループでmamba-org/setup-micromambaを1から2に更新 #1386 (dependabot[bot])
[pre-commit.ci] pre-commit autoupdate #1380 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1379 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1378 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1377 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1376 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1375 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1373 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1372 (pre-commit-ci[bot])
v0.17.1#
修正されたバグ
ドキュメント
プロジェクトメンテナンス
[pre-commit.ci] pre-commit autoupdate #1368 (pre-commit-ci[bot])
MNT ‘examples_dirs’ と ‘gallery_dirs’ の長さが異なる場合に警告を追加 #1361 (lucyleeow)
[pre-commit.ci] pre-commit autoupdate #1357 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1351 (pre-commit-ci[bot])
v0.17.0#
このリリースでは、Python 3.8 および Sphinx 4 のサポートが終了しました。要件は Python >= 3.9 および Sphinx >= 5 になりました。
実装された機能拡張
ENH ダウンロード/ランチャーリンクを
pydata-sphinx-theme
セカンダリサイドバーに統合 #1312 (Charlie-XIAO)
修正されたバグ
ドキュメント
プロジェクトメンテナンス
[pre-commit.ci] pre-commit autoupdate #1348 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1345 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1342 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1338 (pre-commit-ci[bot])
MNT:
_fill_gallery_conf_defaults
をリファクタリング #1334 (lucyleeow)MNT:
generate_dir_rst
およびgenerate_gallery_rst
をリファクタリング #1332 (lucyleeow)[pre-commit.ci] pre-commit autoupdate #1328 (pre-commit-ci[bot])
actionsグループを5件の更新で更新 #1325 (dependabot[bot])
[pre-commit.ci] pre-commit autoupdate #1324 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1319 (pre-commit-ci[bot])
dev 依存関係を pyproject.toml に含め、要件に関するドキュメントを更新 #1317 (AlexSzatmary)
[pre-commit.ci] pre-commit autoupdate #1314 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1311 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1307 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1304 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1300 (pre-commit-ci[bot])
v0.16.0#
Sphinx 7.3.0以降では、キャッシュとシリアライズのチェックが変更されました。 sphinx_gallery_conf
で、ResetArgv()
のようなインスタンス化されたクラス、FileNameSortKey
のようなクラス、または notebook_modification_function
のような呼び出し可能なものを渡す代わりに、クラスまたは呼び出し可能なものへの完全修飾名文字列を渡す必要があります。名前文字列を使用するように変更すると、安定した__repr__
を確保するためのクラスの使用は冗長になるため、単に関数を使用できます。
詳細については、呼び出し可能オブジェクトのインポートを参照してください。
実装された機能拡張
ENH: subsection_orderとしてプレーンリストを許可し、ワイルドカードをサポート #1295 (timhoffm)
[ENH] Minigalleryは任意のファイル/グロブパターンを入力として受け取ることができる #1226 (story645)
修正されたバグ
BUG: レコメンダーでの
UnicodeDecodeError
#1244 (Charlie-XIAO)
ドキュメント
DOC
advanced.rst
のスクレーパーセクションでimage_srcset
設定について言及 #1280 (lucyleeow)BUG: ignore_repr_typesとreset_argvのサンプル使用例のエラーを修正 #1275 (speth)
fix: ダウンロードメッセージのピリオド抜けを修正 #1255 (AlejandroFernandezLuces)
プロジェクトメンテナンス
[pre-commit.ci] pre-commit autoupdate #1294 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1284 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1279 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1277 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1273 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1272 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1260 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1257 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1256 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1252 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1251 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1249 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1248 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1246 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1245 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1239 (pre-commit-ci[bot])
v0.15.0#
このリリースでPython 3.7のサポートが終了しました。要件はPython >=3.8になりました。Pillowが依存関係として追加されました。
実装された機能拡張
ENH: sg_execution_timesを常に書き込み、DataTableを作成 #1198 (larsoner)
FEA 例のレコメンダーシステムを追加 #1125 (ArturoAmorQ)
修正されたバグ
ドキュメント
プロジェクトメンテナンス
[pre-commit.ci] pre-commit autoupdate #1231 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1227 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1224 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1219 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1215 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1206 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1201 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1196 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1194 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1191 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1189 (pre-commit-ci[bot])
[pre-commit.ci] pre-commit autoupdate #1187 (pre-commit-ci[bot])
v0.14.0#
実装された機能拡張
修正されたバグ
md5sum 生成の一貫したエンコーディングを保証 #1159 (sdhiscocks)
Maint: Sphinx が pathlib を使用するようになったため、
app.builder.outdir
を修正 #1155 (lucyleeow)CSS ファイルで table.dataframe の幅を auto に設定 #1128 #1137 (photoniker)
ドキュメント
DOC:
_get_docstring_and_rest
のドキュメント文字列のタイプミスを修正 #1182 (lucyleeow)DOC:
configuration.rst
の Jupyterlite 設定例を修正 #1181 (lucyleeow)DOC: sphinxcontrib-svg2pdfconverter へのリンクを追加 #1145 (oscargus)
「誰が使っているか」リストに OpenTURNS を追加 #1133 (jschueller)
プロジェクトメンテナンス
v0.13.0#
実装された機能拡張
ENH: 不明なキーで check_jupyterlite_conf でエラーを発生させる #1119 (lesteve)
ENH: コンテンツに基づいて Jupyterlite ノートブックを変更する機能を追加 #1113 (lesteve)
修正されたバグ
ENH: sphinx_gallery_conf の早期初期化によるコードのクリーンアップ #1120 (lesteve)
デフォルトの '%matplotlib inline' 行を削除 #1099 (ArturoAmorQ)
FIX: 非 HTML 出力のみを ANSI サニタイズ #1097 (sdhiscocks)
FIX: 目次ブロックの最後に空行を追加 #1094 (sdhiscocks)
API の変更
ドキュメント
PyGMT を「Sphinx-Gallery を利用しているプロジェクト」リストに追加 #1114 (yvonnefroehlich)
DOC: JupyterLite 0.1.0b19 リリース後の JupyterLite ドキュメントを更新 #1106 (lesteve)
プロジェクトメンテナンス
v0.12.2#
修正されたバグ
FIX: 非 HTML 出力のみを ANSI サニタイズ #1097 (sdhiscocks)
v0.12.1#
修正されたバグ
FIX: 目次ブロックの最後に空行を追加 #1094 (sdhiscocks)
v0.12.0#
このリリースで、Sphinx < 4 のサポートが廃止されました。Sphinx >= 4 が必須となりました。
実装された機能拡張
高度な使用例を更新 #1045 (HealthyPear)
python_to_jupyter_cli
でsphinx_gallery_conf
を公開 #1027 (OverLordGoldDragon)[MAINT, MRG] API 使用に関するいくつかの小さな残存物 #997 (alexrockhill)
[ENH, MRG] 未使用の API エントリを孤立化 #983 (alexrockhill)
修正されたバグ
BUG: remove_config_comments=True の場合、ignore ブロックを削除 #1059 (guberti)
srcset で小数点以下2桁を許可 #1039 (OverLordGoldDragon)
「
subsection_index_toctree
が代入前に参照された」を修正 #1035 (OverLordGoldDragon)[BUG, MRG] API 使用 dict に関する問題を修正 #1033 (alexrockhill)
古いインポートを修正 #1016 (OverLordGoldDragon)
サムネイルテキストのフォーマットのバグを修正 #1005 (alexisthual)
[MAINT, MRG] API 使用の未使用オプションを追加し、デフォルトに設定 #1001 (alexrockhill)
ドキュメント
CHANGES 内の Sphinx リンクのタイプミスを修正 #996 (alexisthual)
プロジェクトメンテナンス
v0.11.1#
このリリースで、Sphinx < 3 のサポートが廃止されました。Sphinx >= 3 が必須となりました。
修正されたバグ
実装された機能拡張
v0.11.0#
このバージョンでは、コード出力に適用される「Out:」プレフィックスが、追加の実際のテキストではなく、CSS 疑似要素から作成されるようになりました。詳細については、#896 を参照してください。
実装された機能拡張
ギャラリーセクションのネスト化(つまり、ギャラリーサブフォルダ)が #904 で実装されました。この機能は、前の動作が望ましい場合、無効にできます(ドキュメントの config オプション nested_sections
を参照)(alexisthual)
ツールチップがギャラリーアイテムの上にオーバーレイされるようになりました commit 36166cd。カスタム CSS の調整が必要になる場合があります (alexisthual)。
サブギャラリーのセクションおよびサンプルタイトルのレベルの問題 #935
ネストされた
index.rst
を記述する機能を追加 #855バックリファレンス時に
module_short
の代わりにmodule
をオプションで使用可能 #950 (ExtremOPS)API リファレンスサンプルのサムネイルを共通の div に保存 #946 (alexisthual)
[MRG] ネストされたセクションに関する変更ログ #926 (alexisthual)
[MRG] ネストされた構造の処理 #904 (alexisthual)
修正されたバグ
ギャラリーアイテムの表示に float
プロパティではなく CSS グリッドを使用するようになりました #906、サムネイル用のカスタム CSS を適応させるための 移行ガイド を参照してください (alexisthual)
タイプミスを修正 #970 (tkoyama010)
sphinx_gallery.downloads の構文エラーを修正 #951 (photoniker)
サブカテゴリのインデックスと例を含む toctree を結合(...なしで)#944 (alexisthual)
[WIP] ミニギャラリーの親 div が欠落しているバグを修正 #914 (alexisthual)
show_signature を尊重 #909 (jschueller)
サムネイルに CSS グリッドを使用 #906 (alexisthual)
ドキュメントの更新
DOC: changelog の rst リンク構文を修正 #925 (GaelVaroquaux)
PyVista の例を追加! #888 (banesullivan)
v0.10.1#
このリリースでは、Python 3.6 のサポートが終了しました。要件は Python >=3.7 です。
実装された機能拡張
機能リクエスト: 各例またはすべての例の後に
reset_modules
を適用する #866reset_modules
を例の前または後、あるいは両方で実行できるようにする #870 (MatthewFlamm)
修正されたバグ
embed_code_links が <exception: list indices must be integers or slices, not str> をスローする #879
0.10.0
がsphinx_gallery.load_style
を壊す #878sphinx_gallery_conf の 'plot_gallery' にブール値を使用 #863 (timhoffm)
マージされたプルリクエスト
DOC sphinx-codeautolink への参照を追加 #874 (felix-hilden)
「Sphinx-Gallery を使用しているプロジェクト」に Neuraxle を追加 #873 (guillaume-chevalier)
v0.10.0#
このバージョンでは、デフォルトの Sphinx-Gallery .css ファイルが更新され、名前の先頭に 'sg_' が付くようになりました。詳細については、#845 を参照してください。
実装された機能拡張
画像以外のものにも image_scrapers 機能を利用できるように一般化 #833
rst 警告のみで失敗し、例を実行しないモードを追加 #751
簡単に始められるように「テンプレート」を追加 #555
ENH: matplotlib_scraper とディレクティブに hidpi オプションを追加 #808 (jklymak)
修正されたバグ
BUG Binder URL でブランチ名とファイルパスを URL エンコード #844 (sdhiscocks)
生成された reST から ANSI 文字をサニタイズ: HTML 出力から ANSI 文字 を削除 #838 (agramfort)
BUG Windows で test_minigallery_directive が失敗する問題を修正 #830 (lucyleeow)
BUG CI で LaTeX エラー: File `tgtermes.sty' not found を修正 #829 (lucyleeow)
マージされたプルリクエスト
v0.9.0#
このリリースでPython 3.5のサポートが終了しました。要件はPython >=3.6です。
実装された機能拡張
失敗した場合に例を「スキップ」するモードを追加 #789
sphinx_gallery_thumbnail_numberは負のインデックスをサポートできますか? #785
サムネイルスタイルを設定 #780
ENH: 無効なsphinx_gallery_confキーのチェック #774
DOC ダウンロードリンクの注釈を非表示にする方法を文書化 #760
DOC projects_list.rstでintersphinx参照を使用 #755
出力キャプチャを後続のコードブロックまで遅延させる #363
ENH: 表示するものがなければミニギャラリーのみを追加 #813 (NicolasHug)
sphinx_gallery_thumbnail_numberが負のインデックスをサポートできるようにする #786 (seisman)
修正されたバグ
タイトルターゲット上のスペース用のカスタムCSSがpydata-sphinx-themeと競合 #815
例がないオブジェクトに対してもミニギャラリーが生成される #812
collections.abcからのJinja2のインポートが原因でPythonナイトリーが失敗 #790
test_rebuildとtest_error_messagesがtravisで失敗 #777
アニメーションがRead the Docsで表示されない #772
BUG: 空のコードブロック出力 #765
SVGデフォルトサムネイルサポートを修正 #810 (jacobolofsson)
READMEのTravis CIバッジをAzureバッジに置き換え #783 (sdhiscocks)
マージされたプルリクエスト
DOC MakefileにSOURCEDIRを含める #814 (NicolasHug)
v0.8.2#
readthedocsでHTMLアニメーションをレンダリングできるようにします。
実装された機能拡張
例のヘッダーの注釈を無効にするオプション #757
show_signatureオプションを追加 #756 (jschueller)
生成されたrstファイルに関する警告とエラーを元のPythonファイルに関連付け/生成されたファイルの誤った書き込みを防止 #725
修正されたバグ
例のギャラリーがダウンしている #753
DOC configuration.rstのrun_stale_examplesコマンドを修正 #763 (lucyleeow)
readthedocsでHTMLアニメーションをレンダリングできるようにする #748 (sdhiscocks)
マージされたプルリクエスト
v0.8.1#
WindowsパスのBinderロゴ画像ファイルを修正。
修正されたバグ
sphinx_gallery/tests/test_full.py::test_binder_logo_existsが失敗 (パスが明らかに間違っている) #746
BUG _static BinderロゴのWindows相対パスエラー #744
マージされたプルリクエスト
v0.8.0#
設定 thumbnail_size のデフォルト値は、バージョン0.9.0で (400, 280) (CSSで指定された最大サイズの2.5倍) から (320, 224) (CSSで指定された最大サイズの2倍) に変更されます。
実装された機能拡張
コマンドライン引数を例に渡す #731
ノートブックでのrstからmdへのサポートを制限 #219
新しいmatplotlibのアニメーションでffmpegを有効にする #733 (dopplershift)
コマンドライン引数を例のスクリプトに渡すオプションを実装 #732 (mschmidt87)
ノートブックの画像リンクとデータURIのサポートを追加 #724 (sdhiscocks)
reSTからMDへの見出しをサポート #723 (sdhiscocks)
修正されたバグ
_repr_html_がRTDに表示されない #736
Binderアイコンがハードコードされているため、一部のブラウザで読み込みエラーが発生する #735
例のスクリプトを実行せずに画像をスクレイピングする方法 #728
sphinx-gallery/0.7.0: ドキュメントをビルドする際、TypeError: ‘str’ object is not callableが発生する #727
サムネイルのオーバーサンプリング #717
事前にビルドされたギャラリーの操作 #704
“plt.show()”を呼び出すと、見苦しい警告が発生する #694
ドキュメントv0.6.2 stableでの検索が機能しない #689
カスタムイメージスクレイパーの例に関するドキュメントを改善 #730 (mschmidt87)
プラットフォームの改行に依存しないmd5ハッシュを作成 #722 (sdhiscocks)
バグ: ‘capture_repr’ と ‘ignore_repr_types’ をチェック #709 (lucyleeow)
readthedocsでhtmlをレンダリングできるようにする #700 (sdhiscocks)
マージされたプルリクエスト
ギャラリー用のPlotlyの例 #718 (emmanuelle)
v0.7.0#
開発者の変更#
組み込みのエラーではなく、Sphinxのエラーを使用します。
実装された機能拡張
ミニギャラリーを挿入するためのSphinxディレクティブを提供する #683
GPUメモリログのサポート #671
機能強化: インデックス内のサムネイルのalt属性をより情報豊富にする #664
サムネイルがギャラリーページを重くし、読み込み時間が長くなる #655
メンテナンス: エラーメッセージを改善 #600
画像タグのより情報豊富な「alt」属性 #538
機能強化: “examples using my_function”への簡単なリンク #496
サブギャラリーは個別の「gallery rst」ファイルで生成する必要がある #413
matplotlibアニメーションのサポート #150
修正されたバグ
html内のnumpyデータを検索するテストの正規表現を修正 #681
check-manifestがmasterを失敗させている #675
ロガーが別のセルで作成された場合、ロガーの出力がキャプチャされない #672
バグ: Tinybuild autosummary リンクが Sphinx dev で失敗する #659
ドキュメント
ドキュメント: ドキュメントファイルのタイプミスを修正 #652 (TomDonoghue)
sphinx-gallery の設定の適用と削除に関する不整合 #665
make html-noplot
の手順が古くなっている #606
マージされたプルリクエスト
v0.6.2#
v0.6.1 で CSS ファイルが欠落していたため、パッチリリース。マニフェストチェックを CI に追加。
実装された機能拡張
修正されたバグ
マージされたプルリクエスト
v0.6.1#
開発者向けの変更#
Zenodo 統合を追加。このリリースは Zenodo が取得するためのものです。
実装された機能拡張
pathlib.Path を backreferences_dir オプションに許可 #635
ENH: backrefences_dir が pathlib オブジェクトであることを許可 #638 (lucyleeow)
修正されたバグ
マージされたプルリクエスト
v0.6.0#
開発者向けの変更#
ハード依存関係の数を減らし、dev-requirements.txt を追加。
AppVeyor を Python 3.6 から 3.7 に上げる。
CSS を分割し、CSS をロードするサブ拡張機能を作成。
実装された機能拡張
ENH: 新しいファイルベースの conf-parameter thumbnail_path #609 (prisae)
MRG, ENH: サブ拡張機能 sphinx_gallery.load_style を提供 #601 (mgeier)
特定の型の repr を無視する機能を追加 #577 (banesullivan)
修正されたバグ
URLError #569 (EtienneCmb)
API リファレンス構造の重複した doc_solver エントリを削除 #589 (kanderso-nrel)
マージされたプルリクエスト
[MRG+1] ドキュメント: スプリッターのドキュメントを改善し、IDE での使用を説明 #615 (lucyleeow)
ドキュメントで literalinclude について言及 #582 (emmanuelle)
v0.5.0#
開発者向けの変更#
マスターを追跡する「dev」ドキュメントと、リリースに従う「stable」ドキュメントを分離。
公式の jpeg サポートを追加。
互換性のない変更#
Sphinx < 1.8.3 のサポートを終了。
Python < 3.5 のサポートを終了。
capture_repr
設定が追加され、デフォルト設定は('_repr_html_', __repr__')
となりました。これにより、既存のプロジェクトで意図しない出力がキャプチャされる可能性があります。以前の動作に戻すには、capture_repr: ()
を設定してください。
実装された機能拡張
イメージスクレイパーの入力を説明 #472
JupyterのようにHTML出力をキャプチャ #396
機能リクエスト: セル区切りをカスタマイズするオプションを追加 #370
‘README’と‘readme’の両方を検索 #535 (revesansparole)
修正されたバグ
ドキュメントが現在のリリースよりも先行 #559
マージされたプルリクエスト
sphinx-galleryを使用しているプロジェクトのリスト #547 (emmanuelle)
[MRG] ドキュメントからmatplotlib aggバックエンド + plt.showの警告を削除 #521 (lesteve)
v0.4.0#
開発者向けの変更#
外部スクレイパーが文字列ベースのサポートを持つためのプライベートAPI契約が追加されました。以下を参照してください。
標準エラーがキャッチされ、標準出力と並んで表示されるようになりました。
いくつかのSphinxマークアップが、画像サムネイルのツールチップから削除されました。
互換性のない変更#
v0.4.0は、Python <= 3.4 をサポートする最後のリリースになります。
今後は、sphinx-galleryの各リリース時に、最新の2つの安定したSphinxリリースのみをサポートします。
実装された機能拡張
Dockerfileを使用したbinderの要件? #476
RTD-Binderの非互換性に関するドキュメントの注記を追加 #505 (StanczakDominik)
sphinx-galleryユーザーリストにPlasmaPyを追加 #504 (StanczakDominik)
ドキュメントにソースコードを表示するリンクを追加 #499 (sappelhoff)
外部イメージスクレイパーのリストを追加 #492 (banesullivan)
sphinx-galleryを使用しているプロジェクトの例をさらに追加 #489 (banesullivan)
修正されたバグ
「binder」のドキュメントでキーワードが間違っていたのを修正 #500 (sappelhoff)
ドキュメントを読むためのリンクを削除 #461 (GaelVaroquaux)
v0.3.1#
バグ修正リリース: パッケージの「pip install」を妨げていた欠落ファイルを追加しました。
修正されたバグ
バージョン 0.3.0 リリースは pypi で破損しています #459
v0.3.0#
互換性のない変更#
出力図の番号付けは常に 1, 2, …,
number_of_figures
です。0.2.0 では matplotlib の図番号に従っていました。sphinx-gallery で生成された図を.. figure
ディレクティブを使用して.rst
ドキュメントに明示的に含める場合、例でデフォルト以外の matplotlib 図番号を使用している場合 (例えば、plt.figure(0)
を使用している場合) は、そのパスを調整する必要があるかもしれません。詳細については、#464 <https://github.com/sphinx-gallery/sphinx-gallery/issues/464> を参照してください。
開発者向けの変更#
Sphinx <= 1.4 のサポートを終了しました。
独立した rst ファイル構築のためのリファクタリング。関数
sphinx_gallery.gen_rst.generate_file_rst
は、ソースコードの各ブロックを実行中に rst ファイルを構成しなくなりました。現在、例のスクリプトexecute_script
の実行は独立した関数であり、各ソースブロックの出力の rst 表現をリストで構造化して返します。generate_file_rst
は、必要な場合にスクリプトの実行を呼び出し、rst 出力から、例の散文、コード、および出力を含む rst ドキュメントを構成し、Binder バッジ、ダウンロードボタン、およびタイミング統計のアノテーションを含めてファイルに直接保存します。Binder リンク構成の変更。BinderHub の構成値は、より明示的にするために
url
からbinderhub_url
に変更されました。古い構成キー (url
) はバージョン v0.4.0 で非推奨になります。CircleCI などの CI サービスでビルドするのに役立つ可能性がある
'junit'
構成値を使用して、JUnit XML サマリーファイルを生成するサポート。関連する CircleCI ドキュメント および ブログ記事 を参照してください。
修正されたバグ
最初のギャラリープロットは、matplotlib のデフォルトではなく、.matplotlibrc を使用します #316
マージされたプルリクエスト
v0.2.0#
新機能#
バグ修正#
パスに ".py" が含まれるプロジェクトで、名前文字列置換が失敗する問題を修正しました。詳細については、#322 および #331 を参照してください。
セル間の __future__ インポートを修正しました。詳細については、#308 を参照してください。
ロケールが UTF-8 でない場合のエンコード関連の問題を修正しました。詳細については、#311 を参照してください。
詳細モードでは、例の出力は、最後だけではなく、例の実行中にもコンソールに出力されます。詳細については、#301 を参照してください。
sphinx 1.7 における SphinxDocLinkResolver のエラーを修正しました。詳細については、#352 を参照してください。
file_pattern
とexpected_failing_examples
の間の予期しない相互作用を修正しました。詳細は #379 および #335 を参照してください。修正: 出力にスタイルなしの pygments を使用するようにしました #384
修正: パスが '/' で終わる場合のギャラリー名を修正しました #372
タイトルの検出ロジックを修正しました。 #356
修正: sphinx 1.8dev での警告を避けるために
docutils_namespace
を使用するようにしました #387
互換性のない変更#
開発者向けの変更#
v0.1.13#
新機能#
min_reported_time
設定可能項目を追加しました。この閾値(秒単位)よりも高速に実行される例については、実行時間が報告されません。thumbnail_size オプションを追加しました #283
すべての関数参照解決に intersphinx を使用するようにしました #296
ダウンロード用の Sphinx のみディレクティブ #298
サブセクションファイルのソートを許可するようにしました #281
plot_gallery
には、Python のブール値ではなく、文字列を使用することをお勧めします。たとえば、True
の代わりに'True'
を使用します。sphinx-build
のコマンドラインスイッチ経由でこの値を制御する際の Unicode に関する警告を回避できるためです。
バグ修正#
開発者向けの変更#
v0.1.12#
新機能#
バグ修正#
ドキュメント#
v0.1.11#
ドキュメント#
よくある質問がドキュメントに追加されました。なぜ __file__ が定義されていないのか?
バグ修正#
#242 で、Sphinx app オブジェクトの属性名を変更しました
v0.1.10#
バグ修正#
#218 で導入された画像パス処理のバグを修正しました
v0.1.9#
互換性のない変更#
バグ修正#
開発者向けの変更#
テストを py.test に移行しました
ドキュメントに github リポジトリへのリンクを含めました
v0.1.8#
新機能#
コードリンクのツールチップのスタイリングを削除しました。ブラウザによって管理される title 属性に置き換えました。
リンクを埋め込むとギャラリーの出力が短くなるようにしました
Circle CI テスト
バグ修正#
v0.1.7#
バグ修正#
リリースされた Sphinx 1.5 には自動生成されたファイルに対する新しい命名規則があり、Sphinx-Gallery ドキュメントスキャナーが壊れていました。 #178 で修正され、Sphinx < 1.5 で生成されたドキュメントと 1.5 以降の新しいドキュメントへのリンクに対応しています
コードリンクのツールチップがコードと左揃えになるようにしました
新機能#
v0.1.6#
新機能#
Python スクリプトを Jupyter Notebook に変換するための実行可能スクリプト #148
バグ修正#
matplotlib バックエンドを
'agg'
に設定できない場合、Sphinx-Gallery は例外を発生させるようになりました。これは、たとえば conf.py で matplotlib.pyplot がインポートされている場合に発生する可能性があります。詳細については、#157 を参照してください。モジュールが属性なしで使用されている場合の
backreferences.identify_names
を修正しました #173。 #172 および #149 を閉じます例のギャラリーのメインディレクトリに README.txt が存在しない場合、FileNotFoundError を発生させるようにしました(#164)。 また、README.txt を読み取った後、html ファイルを正しくレンダリングするために余分な空行を含めるようにしました。(#165)
PyPI リリースにライセンスファイルを同梱するようにしました
v0.1.5#
新機能#
CSS。ソースコードブロックにツールチップが表示されるようになり、doc-resolv 機能が見つけやすくなりました。 ソースコードブロック内の関数呼び出しは、オンラインドキュメントへのハイパーリンクです。
ダウンロードボタンが、Sphinxで提供されるすべてのテーマでより見栄えが良くなりました。
開発者向け変更点#
Sphinx-Galleryドキュメントのローカルビルドでのテーマのオンザフライ変更をサポートします。makeターゲットに変数themeを渡すと、新しいテーマでドキュメントがビルドされます。すべてのSphinxテーマと、この使用例に示すように、値rtdでread the docsオンラインテーマが利用可能です。
$ make html theme=rtd
Ubuntu 14パッケージでのSphinx Galleryのサポートをテストし、Ubuntu 12のサポートを削除します。conda環境でのPython 2.6のサポートを削除します。
v0.1.4#
新機能#
ダウンロードボタンのCSSを強化
ギャラリーの最後に、すべてのPythonスクリプトまたはJupyterノートブックをzipファイルにまとめてダウンロードするためのダウンロードボタンを追加。この効果を切り替えるための新しい設定変数download_all_examples。デフォルトで有効
各ギャラリーのすべての例をPythonスクリプトとノートブックとしてまとめたダウンロード可能なzipファイル
Jupyterノートブックのテキストブロック用に、rstディレクティブからmarkdownへの変換を改善
バグ修正#
例の中でseabornがインポートされた場合、プロットスタイルの設定が、後で実行されるプロットに引き継がれます。CIは、mayavi-pandas-seabornとnomklの互換性のあるバージョンをconda環境で取得し、すべての機能を利用できるようにする方法をユーザーが追跡できるように設定されています。
インライン数式と複数行の数式について、例のrstからJupyterノートブックテキストへの数式変換を修正
v0.1.3#
新機能#
sphinxビルドの最後に、トレースバックを含む失敗した例の概要を表示。デフォルトでは、例が失敗した場合、ビルドは終了コード1で終了します。conf.pyで失敗することが予想される例のリストを定義し、終了コード0でビルドを終了させることができます。または、1つの例が失敗するとすぐにビルドを終了させることも可能です。
ビルド中に、すべての例の計算時間の集計およびソートされたリストをコンソールに出力。
複数の図を作成する例について、サムネイル画像を設定。
plot_gallery
およびabort_on_example_error
オプションは、sphinx_gallery_conf
で指定できるようになりました。ビルドオプション(sphinx-build
に渡される-D
フラグ)は、sphinx_gallery_conf
オプションよりも優先されます。
バグ修正#
失敗した例は、ビルドごとに再試行されます。
v0.1.2#
バグ修正#
if __name__ == '__main__'
ガードを使用する例が実行されるようになりましたノートブックではない例で、コード出力とコードソースの間に垂直方向のスペースを追加
v0.1.1#
バグ修正#
html-noplot機能を復元
ギャラリーのCSSで、サムネイルの幅が暗黙的に強制されるようになりました
v0.1.0#
ハイライト#
例のスクリプトをIPython Notebookとしてダウンロードできるようになりました #75
新機能#
ギャラリーのビルド中にどの例のスクリプトを実行するかを選択するための、設定可能なファイル名パターン
例のスクリプトの更新チェックは、日付ではなくmd5sumチェックによるようになりました
破損した例は、ギャラリービューに破損したサムネイルを表示し、レンダリングされた例の中にトレースバックが出力されます。ユーザーは、例が失敗するとすぐにビルドプロセスを中止するように設定することもできます。
スクリプトサイズによる例のソート
例のスタイルを改善
v0.0.11#
ハイライト#
このリリースには、PR #36によるギャラリーのノートブックスタイルの例が含まれています
互換性のない変更#
Sphinx-Galleryは、Pythonモジュール名をsphinx_galleryにリネームしました。これは#47で提起され、#66で解決された議論に従ったものです。
ギャラリー設定の辞書も、名前をsphinx_gallery_conf
に変更します
v0.0.10#
ハイライト#
このリリースでは、バックリファレンスを使用できます。この機能は、特定の関数を使用している例を一覧表示する、きめ細かい例のギャラリーを取り入れています。#26
新機能#
Sphinx-Galleryのローカルコピーをプロジェクトに配置するためのシェルスクリプト
ギャラリーでのMayaviプロットのサポート