diff --git a/guide/source/0setup-devel-env.rst b/guide/source/0setup-devel-env.rst index 1ad68d1..2737e57 100644 --- a/guide/source/0setup-devel-env.rst +++ b/guide/source/0setup-devel-env.rst @@ -34,12 +34,14 @@ Windows10 用户可以通过系统内置的 **WSL2** 虚拟机（请不要使用 2. 接收 `第一个实验练习 setup-env-run-os1 的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第一个实验练习 setup-env-run-os1 的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第一个实验练习的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. **重要：** 在vscode的 `console` 中执行 `make setupclassroom_testX` （该命令仅执行一次，X的范围为 1-8）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 + .. note:: diff --git a/guide/source/chapter1/0intro.rst b/guide/source/chapter1/0intro.rst index 4298f90..51b948d 100644 --- a/guide/source/chapter1/0intro.rst +++ b/guide/source/chapter1/0intro.rst @@ -47,12 +47,13 @@ 2. 接收 `第一个实验练习 setup-env-run-os1 的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第一个实验练习 setup-env-run-os1 的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第一个实验练习的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. 在vscode的 `console` 中执行 `make setupclassroom_test1` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 本章一步步实现了支持打印字符串的简单操作系统。 diff --git a/guide/source/chapter2/0intro.rst b/guide/source/chapter2/0intro.rst index e7df06f..3b16be1 100644 --- a/guide/source/chapter2/0intro.rst +++ b/guide/source/chapter2/0intro.rst @@ -30,13 +30,14 @@ 2. 接收 `第二个实验练习的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第二个实验练习的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第二个实验练习的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. 在vscode的 `console` 中执行 `make setupclassroom_test2` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 - + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 + 本章我们引入了用户程序。 .. code-block:: console diff --git a/guide/source/chapter3/0intro.rst b/guide/source/chapter3/0intro.rst index 5b9b663..a33dd5c 100644 --- a/guide/source/chapter3/0intro.rst +++ b/guide/source/chapter3/0intro.rst @@ -26,12 +26,14 @@ 2. 接收 `第一个实验(os3)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第一个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第一个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. 在vscode的 `console` 中执行 `make setupclassroom_test3` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 + .. code-block:: console $ git clone https://github.com/LearningOS/rust-based-os-comp2022.git diff --git a/guide/source/chapter4/0intro.rst b/guide/source/chapter4/0intro.rst index 0f445de..f71c110 100644 --- a/guide/source/chapter4/0intro.rst +++ b/guide/source/chapter4/0intro.rst @@ -20,12 +20,14 @@ 2. 接收 `第二个实验(os4)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第二个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第二个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. 在vscode的 `console` 中执行 `make setupclassroom_test4` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 + 本章应用运行起来效果与上一章基本一致。 获取本章代码： diff --git a/guide/source/chapter5/0intro.rst b/guide/source/chapter5/0intro.rst index 84027be..354881d 100644 --- a/guide/source/chapter5/0intro.rst +++ b/guide/source/chapter5/0intro.rst @@ -14,12 +14,14 @@ 2. 接收 `第三个实验(os5)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第三个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第三个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. 在vscode的 `console` 中执行 `make setupclassroom_test5` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 + 我们将开发一个用户 **终端** (Terminal) 或 **命令行** (Command Line Application, 俗称 **Shell** ) ， 形成用户与操作系统进行交互的命令行界面 (Command Line Interface)。 diff --git a/guide/source/chapter6/0intro.rst b/guide/source/chapter6/0intro.rst index aabc249..149ab9a 100644 --- a/guide/source/chapter6/0intro.rst +++ b/guide/source/chapter6/0intro.rst @@ -19,13 +19,14 @@ 2. 接收 `第四个实验(os6)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第四个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第四个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. 在vscode的 `console` 中执行 `make setupclassroom_test6` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 - + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 + 获取本章代码： .. code-block:: console diff --git a/guide/source/chapter8/0intro.rst b/guide/source/chapter8/0intro.rst index 458ce44..4e7ba17 100644 --- a/guide/source/chapter8/0intro.rst +++ b/guide/source/chapter8/0intro.rst @@ -94,13 +94,14 @@ 2. 接收 `第五个实验(os8)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 3. 完成第二步后，你的第五个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 4. 在你的第五个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 - 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。注：也可在vscode的 `console` 中执行 ``make codespaces_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 6. 在vscode的 `console` 中执行 `make setupclassroom_test8` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 上述的3，4，5步不是必须的，你也可以线下本地开发。 - + 注：如果是本地的ubuntu中建立开发环境，可在shell中执行 ``make ubuntu_local_setenv`` 来自动安装配置开发环境（执行``sudo``需要root权限，仅需要执行一次）。 + 获取本章代码： .. code-block:: console