J'utilise des ancres HTML dans mes blocs-notes Jupyter pour fournir des liens internes tels que ceux utilisés dans une table des matières et des "Retour en haut". Cela fonctionne très bien sur mon ordinateur. Cependant, lorsque je télécharge mes blocs-notes sur GitHub, les ancres invisibles deviennent visibles et les liens ne peuvent plus fonctionner. Comment résoudre ce problème?
Voici quelques blocs-notes sur GitHub qui ont ce problème:
https://github.com/mathyingzhou/boston -crime / blob / master / Boston% 20Crime.ipynb
3 Réponses :
Je ne pense pas que vous puissiez faire grand-chose à ce sujet selon github:
Quelques conseils à ce sujet, à partir du 18/06/2020.
Dans votre
I want to refer to my [heading](#headingid) now
vous avez un espace avant et après le '='. J'ai testé cela et ça va localement (c'est invisible), mais GitHub s'arrête lors de l'analyse et le rend visible.
Vous semblez avoir adopté le astuce pour placer la balise d'ancrage dans une cellule de démarquage vide au-dessus de celle avec le contenu. Je trouve que ce n'est pas nécessaire. Je n'ai pas pu reproduire le problème de Sebastian avec l'aperçu avant impression ou le "téléchargement au format" HTML. Le comportement de Jupyter a peut-être changé (il y a six ans, il a publié cet article!). Vous devriez constater que la démarque
# A content heading<a id='headingid'></a>
fonctionne. Ceci est invisible à la fois localement et sur GitHub lorsque je le teste. Vous pouvez également créer un lien vers celui-ci en utilisant un markdown tel que
<a id = "1"></a>
et cela fonctionne comme un lien cliquable localement dans votre bloc-notes. Il ne fonctionne pas comme un lien cliquable dans le propre moteur de rendu de Github. Il fonctionne comme un lien cliquable lorsque vous collez l'URL du bloc-notes dans nbviewer . J'ai également essayé, localement, File | Télécharger comme | html, pour obtenir une version html de ipynb et mon navigateur le rend comme prévu et les liens sont cliquables et fonctionnent.
C'est quelque chose que j'ai regardé récemment et ce qui précède est actuellement mon meilleur travail approche, c'est-à-dire ajouter la balise d'ancrage au texte de démarque souhaité, ne pas laisser d'espace avant / après le signe égal. Cela semblera correct dans GitHub, vous n'aurez tout simplement pas de liens cliquables. Je ne suis pas sûr qu'il y ait de toute façon autour de cela en utilisant GitHub.
Si quelqu'un trouve cette réponse utile, j'apprécierais les votes positifs car c'est quelque chose sur lequel je travaille et je cherche des moyens d'automatiser. Les votes positifs m'encouragent et je suis ouvert aux commentaires qui me donnent des idées de fonctionnalités à inclure dans tout ce que j'écris pour automatiser cela.
Vous pouvez utiliser "nbviewer" pour rendre et servir votre notebook, au lieu du moteur de rendu de GitHub. Donc, vous fourniriez un lien vers votre notebook, dans le fichier ReadMe.md de votre référentiel, par exemple, comme ceci:
https://nbviewer/github/<mygithubprofile>/<link2mynotebook>
Regardez la réponse fournie par @ martijn-pieters sur ce post : Ancres HTML dans un bloc-notes Jupyter sur Github
Cela a résolu le problème pour moi.
Il peut être utile de publier un lien vers votre exemple dans github ou d'afficher un exemple de code
@pistolpete Bien sûr! C'est fait!