Thumbnail image

發布你的 Jupyter Notebook 更方便分享數據分析的 Insight

  • Wed, Apr 24, 2024
  • 閱讀時間 3 分鐘

前情提要：

一直都有到國外進修資料科學領域的想法，因此也希望在台灣可以有一些數據分析的實務經驗；讓自己在國外的學習可以快速接軌，也就開始了自己的學習、撰寫履歷的旅程。

雖然說是旅程，但是我也只有得到一次面試機會 XD ; 雖然最後沒有得到一個短期的數據分析機會，但是正是這個面試機會讓我想要有這篇文章的經驗分享，也寫給以後要在美國工作的自己。

由於先前的工作經歷主要是 Java 後端工程師為主，履歷也沒有經歷太大的修改；於是被面試官非常佛心的點出在 Python 的技能樹的說服力有點不足，也讓我思考如何針對數據分析的專案以及 python 能力讓面試官更了解技術背景。

此次將介紹如何用 jupyter notebook 建立一個數據分析的作品集，同時又展現你的 Python 能力。

為什麼使用 Jupyter notebook：

選擇使用 jupyter notebook 作為數據分析專案的展示有以下幾種原因：

  • Jupyter Notebook 可以發布於網頁，非技術背景的 HR 或是 PM 都可以看懂
  • Jupyter Notebook 除了可以撰寫 markdown 格式文件，同時又支援 Python、R語言的程式碼區塊；更直觀展現自己的 coding skills
  • GitHub Repository 只有程式碼，這樣面試官很難快速了解面試者的程度

如何開始建立 Jupyter Notebook 專案?

Prequests:

  • 安裝 Anaconda 或是 mini-conda (aka. 縮小版 Anaconda)，在指令列可以用 conda 指令

打開命令列輸入以下指令，安裝 Jupyter notebook 及相關套件於環境:

  1. 更新 Conda 套件
conda update conda
  1. 建立虛擬環境 virtualEnv:
conda create -n yourenvname python=${your python ver.}
  1. 開啟已安裝的虛擬環境：
conda activate yourenvname
  1. 於虛擬環境執行以下套件:
conda install -c conda-forge jupyter-book jupyter

建立 Jupyter notebook 方法：

Jupyter notebook 是什麼？

  • 可互動式網頁介面，可以直接在筆記本上執行、編寫 Python 程式碼
  • 由 IPython(互動式 Python 片段執行) + Notebook 整合形成

以下開始敘述如何建立這樣的專案：

  1. 直接從以前的 Jupyter notebook 專案新增檔案

需要新增下列檔案：

  • 基本的 jupyter notebook 設定資訊 (_config.yml)
  • 設定 table of Content 於 jupyter notebook (_toc.yml)
  1. 利用 Jupyter book 指令建立新專案 安裝完環境後可以使用 jupyter-book 指令建立 template
jupyter-book create your_folder/

建立 jupyter notebook 專案後，其資料夾架構如下：

P.S. 可直接使用 tree 指令查看樹狀架構

$ tree your_folder
your_folder/
├── _config.yml
├── _toc.yml
├── intro.md
├── logo.png
├── markdown-notebooks.md
├── markdown.md
├── notebooks.ipynb
├── references.bib
└── requirements.txt

其中要包含 requirements.txt 以利於部署程式時安裝其相依套件

_config.yml 簡易設定：

# In _config.yml
title: My sample book
author: The Jupyter Book Community
logo: logo.png
execute:
  execute_notebooks: force

# Add a bibtex file so that we can create citations
bibtex_bibfiles:
  - references.bib

三個主要的設定

  • title: 你的 Jupyter notebook 標題 (可自訂)
  • author: 作者名稱(可自訂)
  • logo: 你的圖片 logo 名稱 詳細可以參考這邊

_toc.yml 簡易設定:

# In _toc.yml
format: jb-book
root: intro
chapters:
- file: markdown
- file: notebooks
- file: markdown-notebooks

主要設定檔

  • format: 顯示 jupyterbook 的樣式(jb-article, or jb-book)
  • root: 你的 jupyter notebook 首頁
  • chapters: 該章節可以在 yml 新增多個檔名，每個檔名代表一個 chapter (章節)

發布你的 Jupyter Notebook 到網頁上：

目前官方網站建議使用 netlify 作為部署的主要 solution，這個 Section 中介紹概略的流程如何部署完成

相關步驟如下：

  • 註冊帳戶(建議使用 github 建立)
  • 與 github 中要部署的專案連結，連結後會有 Authorization 視窗，直接點選“是”即可
  • 於部署設定要設定 build command 與 Publish directory 的選項，這樣網頁才能部署成功。 Netlify設定 官網中更詳細的設定點這邊

資料來源：

JobTech jupyter notebookData AnalysisPythonResume