uranusjr · October 16, 2017 08:00 · Oct 11, 2017 · Oct 9, 2017 · Oct 9, 2017 · Oct 9, 2017
diff --git a/snafu-tutorial-chinese.md b/snafu-tutorial-chinese.md
@@ -1,3 +1,5 @@
+**注意：指令在後續版本略有修改，建議閱讀專案 README。**
+
 # SNAFU 使用教學（暫定）
 
 這篇文章會簡單描述如何使用 [SNAFU Python installer manager](https://github.com/uranusjr/snafu)。

diff --git a/snafu-tutorial.md → snafu-tutorial-chinese.md b/snafu-tutorial.md → snafu-tutorial-chinese.md
diff --git a/snafu-tutorial.md b/snafu-tutorial.md
@@ -38,7 +38,7 @@ snafu activate 3.6
 
 這會讓 `python3` 指令指向 Python 3.6，並讓 Python 3.6 相關的指令（例如 `pip3`、`pip3.6` 等等）可被執行。
 
-> **註：**\ 為了避免混淆，SNAFU 不提供沒有版本號的 `python` 與 `pip` 指令。請使用帶版本號的 `python3`/`python2`、`pip3`/`pip2`。  
+> 註：為了避免混淆，SNAFU 不提供沒有版本號的 `python` 與 `pip` 指令。請使用帶版本號的 `python3`/`python2`、`pip3`/`pip2`。  
 
 安裝套件：
 

diff --git a/snafu-tutorial.md b/snafu-tutorial.md
@@ -38,7 +38,7 @@ snafu activate 3.6
 
 這會讓 `python3` 指令指向 Python 3.6，並讓 Python 3.6 相關的指令（例如 `pip3`、`pip3.6` 等等）可被執行。
 
-> **註：**為了避免混淆，SNAFU 不提供沒有版本號的 `python` 與 `pip` 指令。請使用帶版本號的 `python3`/`python2`、`pip3`/`pip2`。  
+> **註：**\ 為了避免混淆，SNAFU 不提供沒有版本號的 `python` 與 `pip` 指令。請使用帶版本號的 `python3`/`python2`、`pip3`/`pip2`。  
 
 安裝套件：
 

diff --git a/snafu-tutorial.md b/snafu-tutorial.md
@@ -46,10 +46,10 @@ snafu activate 3.6
 pip3.6 install ipython
 ```
 
-把安裝的指令（例如 `ipython.exe` 同步到 `PATH` 中）：
+把安裝的指令同步到 `PATH` 中：
 
 ```
-snafu activate
+snafu link ipython
 ```
 
 就可以執行

diff --git a/snafu-tutorial.md b/snafu-tutorial.md
@@ -74,19 +74,28 @@ ipython
 
 ### 安裝後無法執行 `snafu` 指令
 
-試著執行
+先嘗試**重新開機**後**重新安裝 SNAFU**。
+
+如果上面的方法無法解決，可以試著執行下面的指令：
 
 ```
 %LOCALAPPDATA%\Programs\SNAFU\cmd\snafu
 ```
 
-如果可以正常啟動，請試著**重新開機**。
+如果可以成功執行（會顯示指令說明），則可以手動在 `PATH` 環境變數中添加下面兩個路徑：
+
+* `%LOCALAPPDATA%\Programs\SNAFU\cmd`
+* `%LOCALAPPDATA%\Programs\SNAFU\scripts`
+
+重開 command prompt 後就可以正常使用。
+
+### 執行時跳出缺少 DLL 錯誤
 
 如果出現下面的錯誤：
 
-![Windows CRT Runtime error](http://d.pr/i/L28ljA+)
+![Windows CRT Runtime error](https://d.pr/i/L28ljA+)
 
-代表你的系統太舊。請照下列步驟解決：
+代表你的系統太舊，且 SNAFU 無法自動為你下載 Windows 更新。請照下列步驟解決：
 
 1. 根據你的系統下載 [Universal C Runtime 更新](https://support.microsoft.com/zh-tw/help/2999226/update-for-universal-c-runtime-in-windows)。
 2. 安裝 Universal C Runtime。

diff --git a/snafu-tutorial.md b/snafu-tutorial.md
@@ -38,7 +38,7 @@ snafu activate 3.6
 
 這會讓 `python3` 指令指向 Python 3.6，並讓 Python 3.6 相關的指令（例如 `pip3`、`pip3.6` 等等）可被執行。
 
-> **註：**如果為了避免混淆，SNAFU 不提供沒有版本號的 `python` 與 `pip` 指令。請使用帶版本號的 `python3`/`python2`、`pip3`/`pip2`。  
+> **註：**為了避免混淆，SNAFU 不提供沒有版本號的 `python` 與 `pip` 指令。請使用帶版本號的 `python3`/`python2`、`pip3`/`pip2`。  
 
 安裝套件：
 

diff --git a/snafu-tutorial.md b/snafu-tutorial.md
@@ -2,7 +2,7 @@
 
 這篇文章會簡單描述如何使用 [SNAFU Python installer manager](https://github.com/uranusjr/snafu)。
 
-這個專案源自我對社群不懂 Windows 又愛亂教的不滿。如果有興趣讀相關故事，以及一些背後邏輯，可以參考我在碼天狗上的抱怨文。
+這個專案源自我對社群不懂 Windows 又愛亂教的不滿。如果有興趣讀相關故事，以及一些背後邏輯，可以參考我[在碼天狗上的抱怨文](https://weekly.codetengu.com/issues/101#w1ctkwH)。
 
 
 ## 特點

diff --git a/snafu-tutorial.md b/snafu-tutorial.md
@@ -0,0 +1,97 @@
+# SNAFU 使用教學（暫定）
+
+這篇文章會簡單描述如何使用 [SNAFU Python installer manager](https://github.com/uranusjr/snafu)。
+
+這個專案源自我對社群不懂 Windows 又愛亂教的不滿。如果有興趣讀相關故事，以及一些背後邏輯，可以參考我在碼天狗上的抱怨文。
+
+
+## 特點
+
+* 使用 CPython 官方釋出的安裝檔，不另行編譯
+* 直接整合官方安裝，即使不是用 SNAFU 安裝的 Python 版本，也可以輕鬆移到 SNAFU 管理
+    * 僅限 CPython 官方安裝，不包含 PyPy、Anaconda 等第三方發行版
+* 統一處理 `PATH` 環境變數，免除手動管理
+
+
+## 安裝
+
+根據作業系統[下載安裝檔](https://github.com/uranusjr/snafu/releases)並執行。
+
+安裝完成後，應該會得到一個 `snafu` 指令（錯誤排除參考下面 FAQ）。
+
+
+## 基本使用
+
+安裝 Python 3.6：
+
+```
+snafu install 3.6
+```
+
+這會得到一個 `python3.6` 指令。
+
+讓 Python 3.6 成為預設：
+
+```
+snafu activate 3.6
+```
+
+這會讓 `python3` 指令指向 Python 3.6，並讓 Python 3.6 相關的指令（例如 `pip3`、`pip3.6` 等等）可被執行。
+
+> **註：**如果為了避免混淆，SNAFU 不提供沒有版本號的 `python` 與 `pip` 指令。請使用帶版本號的 `python3`/`python2`、`pip3`/`pip2`。  
+
+安裝套件：
+
+```
+pip3.6 install ipython
+```
+
+把安裝的指令（例如 `ipython.exe` 同步到 `PATH` 中）：
+
+```
+snafu activate
+```
+
+就可以執行
+
+```
+ipython
+```
+
+
+## 其他指令
+
+可以從 `snafu --help` 獲得可用的指令列表，並用 `snafu <command> --help` 獲得指令說明。
+
+* `uninstall`：反安裝 Python 版本。
+* `list`：列出已安裝的 Python 版本。
+* `list --all`：列出所有可安裝的 Python 版本。
+* `activate`：啟用某 Python 版本的相關指令。
+* `where`：顯示某 Python 版本的 `python.exe` 位置。
+
+
+## FAQ
+
+### 安裝後無法執行 `snafu` 指令
+
+試著執行
+
+```
+%LOCALAPPDATA%\Programs\SNAFU\cmd\snafu
+```
+
+如果可以正常啟動，請試著**重新開機**。
+
+如果出現下面的錯誤：
+
+![Windows CRT Runtime error](http://d.pr/i/L28ljA+)
+
+代表你的系統太舊。請照下列步驟解決：
+
+1. 根據你的系統下載 [Universal C Runtime 更新](https://support.microsoft.com/zh-tw/help/2999226/update-for-universal-c-runtime-in-windows)。
+2. 安裝 Universal C Runtime。
+3. **重新安裝 SNAFU**。
+
+### 我有其他問題
+
+可以到 <https://github.com/uranusjr/snafu/issues> 反應。
No results found