Open external links in new tabs of the browser in Sphinx HTML documents
If you enable sphinx_new_tab_link, external links of built HTML are opened in new tabs of your browser.
Images that link to external pages become slightly brighter when hovered or focused, making it easier to recognize that they are clickable.
The reST
External link: `Example <https://example.com/>`_is converted into
External link: <a class="reference external" href="https://example.com/" rel="noreferrer" target="_blank">Example</a>First, create your Sphinx documentation.
Then edit conf.py to use this extension.
extensions = [
"sphinx_new_tab_link",
]- Type:
bool - Default:
False
If you want to show external links with icons, set this to True in your conf.py.
new_tab_link_show_external_link_icon = True- Type:
bool - Default:
False
If you want external links without rel="noreferrer", set this to True in your conf.py.
new_tab_link_enable_referrer = TrueExternal link: :icon-link:`Example <https://example.com/>`Enjoy documentation!🙌