Ajuda e suporte do IPYNB to PDF
Soluções para os problemas mais comuns ao converter um notebook Jupyter em PDF com o IPYNB to PDF. Se o seu problema não estiver aqui, escreva para o suporte e vamos verificar.
O que tentar primeiro
- Recarregue as abas do GitHub que estavam abertas antes de você instalar a extensão.
- Abra o conversor pelo ícone da barra de ferramentas e solte o arquivo .ipynb na página.
- Na janela de impressão, defina o destino como “Salvar como PDF”.
- Confira o tamanho da página, a orientação e Show code nas configurações do PDF antes de salvar.
- Se um notebook do GitHub não baixar, use “Download raw file” no GitHub e solte o arquivo.
Problemas comuns e soluções
O botão Download PDF não aparece no GitHub
Recarregue a aba do GitHub: abas abertas antes de você instalar a extensão só recebem o botão depois de recarregadas. O botão aparece apenas na página de um arquivo de notebook (um endereço com /blob/ que termina em .ipynb), ao lado de Raw, ou no canto inferior direito quando o GitHub não mostra o botão Raw.
“Notebook not found on GitHub” em um repositório privado
A extensão baixa o notebook com o seu login do GitHub, então entre no GitHub no mesmo perfil do Chrome e tente de novo. Se ainda falhar, abra o arquivo no GitHub, use “Download raw file” e solte o .ipynb na página do conversor.
Erro “This file is a Git LFS pointer”
O repositório guarda o notebook no Git LFS, então o arquivo que a extensão recebeu é só um pequeno ponteiro. No GitHub, use “Download raw file” para obter o .ipynb de verdade e solte-o na página do conversor.
“This file is not valid JSON” ou “not a Jupyter notebook”
O arquivo está danificado, incompleto ou não é um notebook. Abra-o no Jupyter, no JupyterLab ou no VS Code e salve de novo, ou baixe-o outra vez de onde veio. Um notebook precisa ser um JSON com uma lista “cells”.
Erro “Unsupported notebook version”
Só notebooks nbformat 3 e 4 são compatíveis. Abra o notebook em um Jupyter atual e salve, o que o atualiza para nbformat 4, e converta de novo.
O PDF tem a data e um endereço chrome-extension:// em cada página
Volte Margens para Padrão na janela de impressão. O conversor define tamanho da página, orientação e margens para que o Chrome não tenha espaço para os próprios cabeçalhos e rodapés; mudar as margens na janela pode trazê-los de volta, e então você também pode desmarcar Cabeçalhos e rodapés em Mais configurações.
Falta um gráfico ou widget no PDF
Um PDF não guarda saída interativa, então widgets e gráficos sem uma imagem estática salva mostram “Interactive output omitted”. Salve uma imagem estática do gráfico no notebook (por exemplo, uma exportação PNG), execute a célula, salve o notebook e converta de novo. Imagens vinculadas da web não são carregadas e mostram “External image not loaded”.
Um notebook grande demora para converter
Arquivos acima de 50 MB mostram um aviso, mas são convertidos mesmo assim, o que pode levar um tempo. Notebooks ficam grandes principalmente por causa de imagens incorporadas; limpar no Jupyter as saídas de que você não precisa deixa o arquivo menor.
Só um dos meus notebooks foi convertido
O conversor trabalha com um notebook por vez. Quando você solta vários arquivos, ele converte o primeiro e diz qual; solte o próximo arquivo depois de salvar o PDF.
Seus dados
O IPYNB to PDF guarda só as suas configurações de PDF (tamanho da página, orientação, exibição do código, números In/Out, nome do arquivo como título e o rodapé da página) no armazenamento sincronizado de extensões do Chrome, então elas acompanham você em outros computadores onde você está conectado ao Chrome com a sincronização ativada. Os notebooks nunca são salvos: são lidos na aba do conversor e somem quando você a fecha. Não há nada para fazer backup. Para redefinir as configurações, mude-as de volta no popup ou remova a extensão, o que as apaga.
Quando você escrever para nós
- A mensagem de erro exata que o conversor mostrou.
- De onde veio o notebook (seu computador, um repositório público ou privado do GitHub, Colab ou Kaggle) e o tamanho dele.
- O que está errado na prévia ou no PDF, por exemplo qual célula ou saída aparece diferente do Jupyter.
- Se puder compartilhar, um notebook pequeno que mostre o problema (opcional).
- O nome da extensão e a versão dela, vista em
chrome://extensions. - A versão do Chrome, vista em
chrome://settings/help, e o seu sistema operacional. - O que você fez, o que esperava e o que aconteceu no lugar.
- Uma captura de tela, se o problema aparecer na tela.