Dove è (e qual è) l'istruzione da dare su Github per fare aprire su RTD i link in una pagina esterna?

A cura di Ciro Spataro  | issue #116 | guida/e Gianni Vitrano

Obiettivo

Sui progetti di documentazione esposti su Read the Docs ad un determinato link voglio far aprire la pagina correlata in una pagina diversa da quella che sto leggendo.

Soluzione

Bisogna dare un istruzione sul file conf.py per fare aprire su RTD i link in una pagina esterna. L’istruzione è la seguente:

html_theme_options = {
    'style_external_links': True
}

Se si vogliono forzare tutte le pagine ad aprirsi in una nuova finestra, uno script su stackoverflow.com soddisfa l’esigenza. Basta aggiungere questo script nel file layout.html, prima della chiusara del blocco finale:

<!-- Adds target=_blank to external links -->
<script type="text/javascript">
   $(document).ready(function () {
      $('a[href^="http://"], a[href^="https://"]').not('a[class*=internal]').attr('target', '_blank'); });
</script>