# Python 初學者使用手冊
---
Author : 蘇奕翰
[e-mail] <br>

:::info
**早安 這是 python 的使用手冊**
**下面會有安裝教學 以及一些簡單的入門教學**
**總之 加油www**
:::
---
[toc]

# 初始安裝 (for Windows)
## 必要軟體
### miniconda
:::warning
**這個是 anaconda 的輕量化版本
大部分要用的 package 都要自己安裝
而好用的軟體 spyder, jupyter 也是要自己安裝**
\
**這是一個可以安裝 python 以及 python 套件(package) 的平台**
:::

---
1. 由以下網址下載 **miniconda** 64位元版(除非系統僅支援32位元)
https://docs.conda.io/en/latest/miniconda.html
下載 python 第幾版皆可 可以先上網尋找各版本的差異
基本上不選擇 2.7版
python2與python3差異大且不相容

2. 雙擊後就可以開始安裝 一路按 `next`
若須更改安裝位置 如下圖
3. 到這邊時 **務必務必** 要把上面那個勾勾按下去
要把 `conda` 設定為 **系統環境變數**
不然就要手動加入 [超麻煩](https://bmtnote.blogspot.com/2019/05/windowsanacondapath.html)
4. 安裝完成後 跑出下面的選項 那只是引導你去看他們的網站而已 有沒有勾都沒差

## 非必要軟體
### notepad++
:::warning
**notepad++(npp) 是一個記事本 只是他是一個很厲害很厲害的記事本
基本上他很適合拿來打 code
也支援許多語言的 [語法高亮](https://zh.wikipedia.org/wiki/%E8%AA%9E%E6%B3%95%E7%AA%81%E9%A1%AF)**
\
**本身有許許多多的外掛套件可以使用 有的用來執行程式 有的方便程式碼的構築
只是在調整成你想要的形狀以前 他都非常陽春
需要花時間去理解去更改他的樣子
基本上 裡面看到的所有顏色都可以調整**
:::

---
1. 由以下網址下載 建議下載 32位元版 有較多外掛套件支援
https://notepad-plus-plus.org/downloads/
2. 因為有很多東西可以調整 這邊只介紹幾個簡單的東西
* 語言 這邊指的是程式語言 不同的程式語言有不同的語法高亮
* 設定>>程式語言格式 可以調整語法高亮的顏色以及背景色 或是加入關鍵字
* 設定>>管理快捷鍵...
因為有很多的外掛會需要用到快捷鍵 這邊可以編輯快捷鍵 避免外掛與原生指令衝突
* 外掛>>外掛模組管理 下載安裝各種外掛的地方
3. 常用外掛模組介紹
* Light Explorer
輕量化的檔案瀏覽
* NppFTP
可以連線至其他主機 且可以將檔案下載更改後自行上傳
* QuickText
辨認特定文字(Tags)後 自動完成一行至多行的文字(Substitution Text)
* PyNPP
用來跑 python 的外掛 需要在 Options 中設定好 python.exe 的路徑
* TagsView
可以瞬移到某個 function 或 class 對於大型的code而言很方便
* Quick Color Picker +
我覺得最最最炫砲的外掛 挑選色碼的福音
這個外掛只需要雙擊色碼就可以叫出選顏色的小視窗
甚至可以挑選螢幕上的其他顏色

### VS code, Sublime
:::warning
**這些都是用來打 code 非常方便的軟體
網路上也有許多教學文章
也很推薦大家嘗試看看**
:::

### Windows Terminal
:::warning
**與命令提示字元(cmd)是一樣的東西
只是介面更改的彈性較大
使用起來也較為方便 甚至可以開啟分頁進行多工處理
這是他們的[官網](https://docs.microsoft.com/zh-tw/windows/terminal/get-started)**
:::

---
1. 在 Microsoft Store 中下載
2. 搜尋 Windows Terminal 即可
3. 隨便在某個資料夾的路徑欄中打 `wt -d.` 即可在該位置開啟 windows terminal

# 從 conda 開始
:::warning
**如同前面的介紹 這是一個可以用來管理 python 套件的平台
無論是要新增虛擬環境或是安裝套件都可以使用
conda 僅能安裝 2~3成的套件 剩下的都只能使用 pip進行安裝 (詳見[好文推薦 : conda vs pip](#好文推薦))
不過大部分會用到的套件都可以使用 conda 安裝 所以也不用太過於擔心XD**
:::

---
## 檔案下載
1. [於此連結下載必要檔案](https://drive.google.com/file/d/1Pbf6LyyfUDABVX_VmojkegUoN4TfR2Uh/view?usp=sharing)
2. 在桌面解壓縮 內含 `install.txt` 以及 `test.py`

---
## 進行測試
1. 開啟你的 命令提示字元
* `window + R` 後輸入 `cmd`
* 在路徑欄輸入 `wt`
2. 輸入 `cd %USERPROFILE%\Desktop` ==移動至桌面==
3. 輸入 `conda -V` 確認 conda 的版本
* 若此時無法使用 可能是 conda 尚未加入系統環境變數 詳見[此篇](https://bmtnote.blogspot.com/2019/05/windowsanacondapath.html)
4. 輸入 `python` 確認 python 可以開啟
* 若此時無法使用 可能是 conda 尚未加入系統環境變數 詳見[此篇](https://bmtnote.blogspot.com/2019/05/windowsanacondapath.html)
5. `ctrl + Z` 然後按下 `enter` 離開 pyhton
6. 輸入 `conda update conda -y` 更新 conda 至最新版
7. 輸入 `conda install -c conda-forge --file install.txt -y` 安裝套件
8. 輸入 `python test.py`
* 若套件安裝成功 會跑出一些話以及一張圖 別擔心 圖3秒鐘就會消失
* 安裝失敗的話 我也不確定出了哪些問題 要看到跑出來的 error 才能確定
9. 關掉 命令提示字元
10. 在搜尋中打 `spyder` 並開啟
* 理論上他是打得開的 如果無法開啟 則嘗試重新開機後再繼續
還是不行就 試試看在命令提示字元中輸入 `conda update spyder`
11. 上面都完成後 就已經準備好可以開始寫 python 了 加油www

---
### 簡單介紹 spyder
:::warning
**spyder 功能太方便 太強大 可以自動debug 自動補完 自動找尋相關程式碼
還可以在右下角即時看到程式碼運行狀況 或是右上角的變數表以及即時確認資料視覺化的成果 可以很方便地確認資料是否正確
好好的使用可以節省你不少時間
\
不過我跟 spyder 不是很熟悉
下面也只有很簡單的說明文
是真的很簡單的那種 真的有問題還是請大家自己找找
\
[第一篇](https://medium.com/%E8%AA%A4%E9%97%96%E6%95%B8%E6%93%9A%E5%8F%A2%E6%9E%97%E7%9A%84%E5%95%86%E7%AE%A1%E4%BA%BAzino/%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8Bpython%E9%96%8B%E7%99%BC%E7%92%B0%E5%A2%83spyder-%E9%87%8D%E9%BB%9E%E5%8A%9F%E8%83%BD%E8%A7%A3%E6%9E%90-%E5%90%AB%E6%95%99%E5%AD%B8%E5%BD%B1%E7%89%87-%E5%85%A5%E9%96%80%E7%B3%BB%E5%88%97-b9b0e9630a69)
[第二篇](https://www.pressplay.cc/project/vippPage/51Python%E8%99%95%E7%90%86%E8%B3%87%E6%96%99%E5%B0%88%E5%B1%AC~/542246CF7419EC458723F613BE316184)**
:::

# 開始 python 人生

## 下載檔案
1. 確認你要下載的 modual 名稱 (pandas, matplotlib etc.)
2. google `conda modual名稱`
* 以 [matplotlib](https://anaconda.org/conda-forge/matplotlib) 為例
* 複製第一行即可
3. 開啟你的 命令提示字元
* `window + R` 後輸入 `cmd`
4. 貼上指令
5. 會出現確認的頁面 直接 enter 即可

# 好文推薦
[你的第一次接觸 python](https://www.1989wolfe.com/2019/07/miniCONDAwithPython.html)
[conda vs pip](https://medium.com/ai%E5%8F%8D%E6%96%97%E5%9F%8E/anaconda-miniconda-conda-pip%E7%9A%84%E7%9B%B8%E4%BA%92%E9%97%9C%E4%BF%82-%E8%BD%89%E8%BC%89-a0536f3a257)