官方文件

在 Shioaji 有提供一份 jupyter notebook 档案，里面有相关的示范程序码。我们今天就先示范下载该文件，并说明怎麽使用。

设定虚拟环境

因为不同的python专案，会使用不用的 library，所以建议大家使用 python 的虚拟环境来区隔开，这样在开发的时候，如果要保留使用的 library 资讯，会比较简单乾净

1. 打开 miniconda 的 console
2. 切换到 python 3.8 的环境
   ps: py38 是我设的环境名称，如果你设的名称不一样，请自行替换

conda activate py38

3. 建立你要放这个专案的文件夹

mkdir AutoStock
cd AutoStock

4. 建立虚拟环境
   ps: 第一个 venv 是指令，第二个 venv 是虚拟环境名称，可以自行更改

python -m venv venv

建立完虚拟环境後，会在执行的目录下，多一个虚拟环境名称的资料夹 (ex: venv)，之後安装的套件都会在这个资料夹中。

ps: 如果要用 conda 去建立虚拟环境也可以，相关的做法就昨天有介绍过，差别在 conda 建立虚拟环境是在 conda 的目录下面，在做档案管理时没有那麽直觉，还要去 conda 目录下去找，所以在 python 版本一样的情况下，我会使用内建的 venv 功能来建立开发的虚拟目录

5. 启动虚拟环境
   启动虚拟环境，就是执行 venv 资料夹里的 activate.bat 档

venv\Scripts\activate.bat

6. 安装 shioaji

pip install shioaji

7. 安装 ipykernel (执行 jupyter notebook 内程序码时使用), pandas (python 的试算表套件)

pip install ipykernel pandas

8. 下载 shioaji_tutorial.ipynb
   点下 LAUNCH TUTORIAL
   
   会开启一个 jupyter notebook 的网页，选取 File > Download
   

9. 档案移动到专案目录下(AutoStock)，然後打开 vscode，开启目录(AutoStock)
   

10. 在左侧的档案功能栏中，打开下载的 shioaji_tutorial.ipynb
    

11. 往下拉，会看到以下的内容
    红色的区块，右下角显示 "python" 代表这一个区块是 python 的程序码，区块的左上角有一个三角形，按下去就可以直接执行这个区块的程序码
    

12. 按下执行时，vscode 可能会要你选择用哪个环境执行，因为我们相关的 library 都是安装在 venv 下，所以就选 ('venv': venv) 这个选项就可以了。
    

基本上这个教学文件的示范程序码，包含了所有的 Shioaji 的功能，如果只是要测试的话，可以直接修改程序区块的内容，按下执行就可以知道怎麽去执行，也会有结果出来，这个就是 jupyter notebook 方便的地方。明天再来带大家好好看看这个示范档吧。