W naszej pracy jako analitycy danych często tworzymy notatniki Jupyter z kodem, wykresami i analizą. Czasem chcemy je udostępnić w bardziej estetycznej formie — jako czysty plik HTML, bez kodu, zawierający jedynie wyniki i opisy. Na szczęście mamy bardzo proste narzędzie, które to umożliwia: nbconvert.
Krok 1: Instalujemy nbconvert
Na początek upewniamy się, że mamy zainstalowane narzędzie nbconvert. Jeśli nie, instalujemy je za pomocą jednej komendy:
pip install nbconvertKrok 2: Konwertujemy notatnik na HTML
Aby przekonwertować plik notatnik.ipynb na czysty HTML (bez kodu, tylko z wynikami), używamy poniższej komendy:
jupyter nbconvert --to html --TemplateExporter.exclude_input=True notatnik.ipynbPo wykonaniu tej komendy w tym samym folderze pojawia się plik notatnik.html, gotowy do publikacji.
Krok 3: Jeśli chcemy zostawić kod
Jeśli zależy nam na tym, by w pliku HTML znalazły się również komórki z kodem, po prostu pomijamy opcję --TemplateExporter.exclude_input=True:
jupyter nbconvert --to html notatnik.ipynbDzięki temu uzyskujemy wersję HTML zawierającą zarówno kod, jak i wyniki działania.
Taki plik HTML możemy wrzucić bezpośrednio na naszą stronę, dodać do bloga lub przesłać klientowi — wygląda znacznie czyściej niż surowy plik .ipynb.