Sur le Chrome Web StoreIPYNB to PDF : aide et assistance
Les solutions aux problèmes les plus fréquents quand vous convertissez un notebook Jupyter en PDF avec IPYNB to PDF. Si votre problème n’y figure pas, écrivez à l’assistance et nous l’examinerons.
À essayer en premier
- Rechargez tout onglet GitHub ouvert avant l’installation de l’extension.
- Ouvrez le convertisseur depuis l’icône de la barre d’outils et déposez le fichier .ipynb sur la page.
- Dans la boîte de dialogue d’impression, choisissez la destination « Enregistrer au format PDF ».
- Vérifiez le format de page, l’orientation et Show code dans les réglages PDF avant d’enregistrer.
- Si un notebook GitHub ne se télécharge pas, utilisez « Download raw file » sur GitHub et déposez plutôt le fichier.
Problèmes fréquents et solutions
Le bouton Download PDF n’apparaît pas sur GitHub
Rechargez l’onglet GitHub : les onglets ouverts avant l’installation de l’extension n’ont le bouton qu’après rechargement. Le bouton n’apparaît que sur la page d’un fichier notebook (une adresse avec /blob/ qui se termine par .ipynb), à côté de Raw, ou en bas à droite quand GitHub n’affiche pas de bouton Raw.
« Notebook not found on GitHub » pour un dépôt privé
L’extension télécharge le notebook avec votre connexion GitHub : connectez-vous à GitHub dans le même profil Chrome et réessayez. Si cela échoue encore, ouvrez le fichier sur GitHub, utilisez « Download raw file » et déposez le .ipynb sur la page du convertisseur.
Erreur « This file is a Git LFS pointer »
Le dépôt stocke le notebook dans Git LFS : le fichier reçu par l’extension n’est qu’un petit pointeur. Sur GitHub, utilisez « Download raw file » pour obtenir le vrai .ipynb, puis déposez-le sur la page du convertisseur.
« This file is not valid JSON » ou « not a Jupyter notebook »
Le fichier est endommagé, tronqué ou n’est pas un notebook. Ouvrez-le dans Jupyter, JupyterLab ou VS Code et enregistrez-le de nouveau, ou téléchargez-le à nouveau depuis sa source. Un notebook doit être un JSON avec une liste « cells ».
Erreur « Unsupported notebook version »
Seuls les notebooks nbformat 3 et 4 sont pris en charge. Ouvrez le notebook dans une version récente de Jupyter et enregistrez-le, ce qui le passe en nbformat 4, puis convertissez-le de nouveau.
Le PDF affiche la date et une adresse chrome-extension:// sur chaque page
Remettez Marges sur Par défaut dans la boîte de dialogue d’impression. Le convertisseur règle le format de page, l’orientation et les marges pour que Chrome n’ait pas de place pour ses propres en-têtes et pieds de page ; modifier les marges dans la boîte de dialogue peut les faire revenir, et vous pouvez alors aussi décocher En-têtes et pieds de page sous Plus de paramètres.
Un graphique ou un widget manque dans le PDF
Un PDF ne peut pas contenir de sortie interactive : les widgets et graphiques sans image statique enregistrée affichent « Interactive output omitted ». Enregistrez une image statique du graphique dans le notebook (par exemple un export PNG), exécutez la cellule, enregistrez le notebook et convertissez-le de nouveau. Les images liées depuis le web ne sont pas chargées et affichent « External image not loaded ».
Un gros notebook est lent à convertir
Les fichiers de plus de 50 Mo affichent un avertissement mais sont tout de même convertis, ce qui peut prendre un moment. Les notebooks sont surtout lourds à cause des images intégrées ; effacer dans Jupyter les sorties inutiles réduit la taille du fichier.
Un seul de mes notebooks a été converti
Le convertisseur traite un notebook à la fois. Si vous déposez plusieurs fichiers, il convertit le premier et indique lequel ; déposez le fichier suivant après avoir enregistré le PDF.
Vos données
IPYNB to PDF conserve uniquement vos réglages PDF (format de page, orientation, affichage du code, numéros In/Out, nom de fichier comme titre et pied de page) dans le stockage synchronisé des extensions de Chrome : ils vous suivent sur les autres ordinateurs où vous êtes connecté à Chrome avec la synchronisation activée. Les notebooks ne sont jamais enregistrés : ils sont lus dans l’onglet du convertisseur et disparaissent quand vous le fermez. Il n’y a rien à sauvegarder. Pour réinitialiser les réglages, remettez-les dans la fenêtre de l’extension, ou supprimez l’extension, ce qui les efface.
Quand vous nous écrivez
- Le message d’erreur exact affiché par le convertisseur.
- La provenance du notebook (votre ordinateur, un dépôt GitHub public ou privé, Colab ou Kaggle) et sa taille.
- Ce qui ne va pas dans l’aperçu ou le PDF, par exemple quelle cellule ou sortie diffère de Jupyter.
- Si vous pouvez le partager, un petit notebook qui montre le problème (facultatif).
- Le nom de l’extension et sa version, visible dans
chrome://extensions. - Votre version de Chrome, visible dans
chrome://settings/help, et votre système d’exploitation. - Ce que vous avez fait, ce que vous attendiez et ce qui s’est passé à la place.
- Une capture d’écran, si le problème est visible à l’écran.