diff --git a/README.rst b/README.rst index b150cb44..ca5ce09b 100644 --- a/README.rst +++ b/README.rst @@ -96,7 +96,8 @@ file of this repository, and can be defined in your project's ``conf.py`` via 'includehidden': True 'logo_only': 'display_version': True - 'prev_next_buttons_location': bottom + 'prev_next_buttons_location': bottom, + 'style_external_links': False } The following options are available: @@ -107,6 +108,7 @@ The following options are available: * ``includehidden`` Specifies if the global toctree includes toctrees marked with the `:hidden:` option * ``prev_next_buttons_location`` can take the value ``bottom``, ``top``, ``both`` , or ``None`` and will display the "Next" and "Previous" buttons accordingly +* ``style_external_links`` Add an icon next to external links. Defaults to ``False``. Page-level configuration ------------------------ diff --git a/sass/_theme_rst.sass b/sass/_theme_rst.sass index fb807e82..85b6ef54 100644 --- a/sass/_theme_rst.sass +++ b/sass/_theme_rst.sass @@ -33,13 +33,15 @@ // Usually it's a good idea to give images some space. .section > img, .section > a > img margin-bottom: $base-line-height - // Questionable whether this is nice or not. It styles eternal links, but comes with some baggage. - // a.reference.external:after - // font-family: FontAwesome - // content: " \f08e " - // color: $text-light - // vertical-align: super - // font-size: 60% + + // Style external links + &.style-external-links a.reference.external:after + font-family: FontAwesome + content: "\f08e" + color: $text-light + vertical-align: super + font-size: 60% + margin: 0 0.2em // For the most part, its safe to assume that sphinx wants you to use a blockquote as an indent. It gets // used in many different ways, so don't assume you can apply some fancy style, just leave it be. diff --git a/sphinx_rtd_theme/layout.html b/sphinx_rtd_theme/layout.html index 7b7ed013..e9a956f9 100644 --- a/sphinx_rtd_theme/layout.html +++ b/sphinx_rtd_theme/layout.html @@ -159,7 +159,11 @@ {# PAGE CONTENT #}