| Name | sphinx-new-tab-link JSON |
| Version |
0.8.1
JSON |
| download |
| home_page | None |
| Summary | Open external links in new tabs of the browser in Sphinx HTML documents |
| upload_time | 2025-10-12 14:50:27 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT License |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# sphinx-new-tab-link
[](https://badge.fury.io/py/sphinx-new-tab-link)
[](https://pypi.org/project/sphinx-new-tab-link/)
Open external links in new tabs of the browser in Sphinx HTML documents
## Overview
If you enable `sphinx_new_tab_link`, external links of built HTML are opened in new tabs of your browser.
The reST
```rst
External link: `Example <https://example.com/>`_
```
is converted into
```html
External link: <a class="reference external" href="https://example.com/" rel="noreferrer" target="_blank">Example</a>
```
## Usage
First, create your Sphinx documentation.
Then edit `conf.py` to use this extension.
```python
extensions = [
"sphinx_new_tab_link",
]
```
## Configuration
### `new_tab_link_show_external_link_icon`
* Type: `bool`
* Default: `False`
If you want to show external links with icons, set this to `True` in your `conf.py`.
```python
new_tab_link_show_external_link_icon = True
```
### `new_tab_link_enable_referrer`
* Type: `bool`
* Default: `False`
If you want external links without `rel="noreferrer"`, set this to `True` in your `conf.py`.
```python
new_tab_link_enable_referrer = True
```
## Roles
### External link with icon (Experimental)
```rst
External link: :icon-link:`Example <https://example.com/>`
```
Enjoy documentation!🙌
Raw data
{
"_id": null,
"home_page": null,
"name": "sphinx-new-tab-link",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "nikkie <takuyafjp+develop@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/be/06/a407a7bcaf4c8109b0be8a584084c5bd0975422b862043b4f58a7378dbab/sphinx_new_tab_link-0.8.1.tar.gz",
"platform": null,
"description": "# sphinx-new-tab-link\n\n[](https://badge.fury.io/py/sphinx-new-tab-link)\n[](https://pypi.org/project/sphinx-new-tab-link/)\n\nOpen external links in new tabs of the browser in Sphinx HTML documents\n\n## Overview\n\nIf you enable `sphinx_new_tab_link`, external links of built HTML are opened in new tabs of your browser.\n\nThe reST\n\n```rst\nExternal link: `Example <https://example.com/>`_\n```\n\nis converted into\n\n```html\nExternal link: <a class=\"reference external\" href=\"https://example.com/\" rel=\"noreferrer\" target=\"_blank\">Example</a>\n```\n\n## Usage\n\nFirst, create your Sphinx documentation.\n\nThen edit `conf.py` to use this extension.\n\n```python\nextensions = [\n \"sphinx_new_tab_link\",\n]\n```\n\n## Configuration\n\n### `new_tab_link_show_external_link_icon`\n\n* Type: `bool`\n* Default: `False`\n\nIf you want to show external links with icons, set this to `True` in your `conf.py`.\n\n```python\nnew_tab_link_show_external_link_icon = True\n```\n\n### `new_tab_link_enable_referrer`\n\n* Type: `bool`\n* Default: `False`\n\nIf you want external links without `rel=\"noreferrer\"`, set this to `True` in your `conf.py`.\n\n```python\nnew_tab_link_enable_referrer = True\n```\n\n## Roles\n\n### External link with icon (Experimental)\n\n```rst\nExternal link: :icon-link:`Example <https://example.com/>`\n```\n\nEnjoy documentation!\ud83d\ude4c\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Open external links in new tabs of the browser in Sphinx HTML documents",
"version": "0.8.1",
"project_urls": {
"Bug Tracker": "https://github.com/ftnext/sphinx-new-tab-link/issues",
"Guide": "https://ftnext.github.io/sphinx-new-tab-link/guide.en.html",
"Homepage": "https://github.com/ftnext/sphinx-new-tab-link"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ba2e5f42ac3e8e68b3878fed18a986160a97b671e7c44bdb4c99c963618ebeb7",
"md5": "83a8717d55c3cc6b467d6e15ab279659",
"sha256": "fd88be77deaab982b5fdd0be9ef63cfa93f14deab775ab423b6c856402a57ebd"
},
"downloads": -1,
"filename": "sphinx_new_tab_link-0.8.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "83a8717d55c3cc6b467d6e15ab279659",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 5624,
"upload_time": "2025-10-12T14:50:25",
"upload_time_iso_8601": "2025-10-12T14:50:25.718991Z",
"url": "https://files.pythonhosted.org/packages/ba/2e/5f42ac3e8e68b3878fed18a986160a97b671e7c44bdb4c99c963618ebeb7/sphinx_new_tab_link-0.8.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "be06a407a7bcaf4c8109b0be8a584084c5bd0975422b862043b4f58a7378dbab",
"md5": "fb21dd20f8c1be12fc2215b11baeedc9",
"sha256": "f8b3b369b660824664fd51bacf126deb8f800364dae17b7142b5d0e17385f77f"
},
"downloads": -1,
"filename": "sphinx_new_tab_link-0.8.1.tar.gz",
"has_sig": false,
"md5_digest": "fb21dd20f8c1be12fc2215b11baeedc9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 6624,
"upload_time": "2025-10-12T14:50:27",
"upload_time_iso_8601": "2025-10-12T14:50:27.000200Z",
"url": "https://files.pythonhosted.org/packages/be/06/a407a7bcaf4c8109b0be8a584084c5bd0975422b862043b4f58a7378dbab/sphinx_new_tab_link-0.8.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-12 14:50:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ftnext",
"github_project": "sphinx-new-tab-link",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sphinx-new-tab-link"
}
