`sphinx-new-tab-link` 使い方ガイド¶

sphinx-new-tab-link はSphinx拡張です。
ソースからビルドしたHTMLで、 外部リンクをブラウザの新しいタブで開く ように自動で設定します✨
このドキュメントで使い方を示します（なんと、このドキュメントはドッグフーディングにもなっているんですよ！🐶）

Here is English version of this guide: Guide of sphinx-new-tab-link

リンク集¶

sphinx-new-tab-link はPyPIからインストールできます。

$ pip install sphinx-new-tab-link

あなたのSphinxプロジェクトの conf.py でこの拡張を有効にしてください。

conf.py¶

extensions = [
    "sphinx_new_tab_link",
]

これだけです！

HTML中の外部リンクが、ブラウザの新しいタブで開かれるようになります。

reSTで可能なさまざまな記法による外部リンクをサポートしています。

✅直接URLだけを書いた行

✅インラインで書いたURL（「リンク集」の PyPI 参照）

✅外部ハイパーリンクターゲットを定義し、それを参照：公開版ガイド

.. _公開版ガイド: https://ftnext.github.io/sphinx-new-tab-link/guide.html

外部ハイパーリンクターゲットを定義し、それを参照： `公開版ガイド`_

✅匿名ハイパーリンク記法：公開版ガイド（匿名記法）

.. __: https://ftnext.github.io/sphinx-new-tab-link/guide.html

匿名ハイパーリンク記法： `公開版ガイド（匿名記法）`__

`GitHub Repository（ターゲット定義なし） <https://github.com/ftnext/sphinx-new-tab-link>`__

✅アンダースコア1つの埋め込みURLによって定義したターゲット（リンク集の GitHub Repository）を再度参照： GitHub Repository

`GitHub Repository <https://github.com/ftnext/sphinx-new-tab-link>`_

再度 `GitHub Repository`_ を参照できる

✅ :target: オプションを指定した image ディレクティブ

.. image:: _static/breakfast.jpg
    :target: https://www.flickr.com/photos/pyconjp/48818171768/in/album-72157710870622516/

✅ :target: オプションを指定した figure ディレクティブ

.. figure:: _static/pyconjp2019.jpg
    :target: https://www.flickr.com/photos/pyconjp/48743997848/in/album-72157710870622516/

注釈

sphinx.ext.autodoc にも対応しています！

URLを含んだdocstringからビルドしたHTMLでも、URLはブラウザの新しいタブで開きます。 sphinx-new-tab-link の API のドキュメントは、その例になっているんですよ！🐶

Enjoy documentation!🙌