From 69bb086942423461b2866be27eb52d454a117f61 Mon Sep 17 00:00:00 2001 From: Yu Chen Date: Tue, 28 Jun 2022 19:02:20 +0800 Subject: [PATCH] add github classroom info --- guide/source/chapter1/0intro.rst | 10 +++++----- guide/source/chapter2/0intro.rst | 17 +++++++++++++++++ guide/source/chapter3/0intro.rst | 16 ++++++++++++++++ guide/source/chapter4/0intro.rst | 16 ++++++++++++++++ guide/source/chapter5/0intro.rst | 16 ++++++++++++++++ guide/source/chapter6/0intro.rst | 17 +++++++++++++++++ guide/source/chapter8/0intro.rst | 17 +++++++++++++++++ 7 files changed, 104 insertions(+), 5 deletions(-) diff --git a/guide/source/chapter1/0intro.rst b/guide/source/chapter1/0intro.rst index 10c15d5..d05db37 100644 --- a/guide/source/chapter1/0intro.rst +++ b/guide/source/chapter1/0intro.rst @@ -43,15 +43,15 @@ 基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 - 1. 在网络浏览器中用自己的 id 登录 github.com - 2. 接收 `第一个实验 setup-env-run-os1 的在线邀请 `_ ，根据提示一路选择OK即可。 - 3. 完成第二步后，你的第一个 setup-env-run-os1 的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 - 4. 在你的第一个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 + 1. 在网络浏览器中用自己的 github id 登录 github.com + 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等工具。 6. 在vscode的 `console` 中执行 `make setupclassroom` （该命令仅执行一次）配置githubclassroom 自动评分功能。 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 - 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 上述的3，4，5步不是必须的，你也可以线下本地开发。 本章一步步实现了支持打印字符串的简单操作系统。 diff --git a/guide/source/chapter2/0intro.rst b/guide/source/chapter2/0intro.rst index 3e2e7f9..7970c56 100644 --- a/guide/source/chapter2/0intro.rst +++ b/guide/source/chapter2/0intro.rst @@ -20,6 +20,23 @@ 实践体验 --------------------------- +.. note:: + + 基于github classroom的开发方式 + + 基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 + + 1. 在网络浏览器中用自己的 github id 登录 github.com + 2. 接收 `第二个实验练习的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 + 3. 完成第二步后，你的第二个实验练习的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 + 4. 在你的第二个实验练习的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 6. 在vscode的 `console` 中执行 `make setupclassroom` （该命令仅执行一次）配置githubclassroom 自动评分功能。 + 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 + + 上述的3，4，5步不是必须的，你也可以线下本地开发。 + + 本章我们引入了用户程序。为了将内核与应用解耦，我们将二者分成了两个仓库，分别是存放内核程序的 ``rCore-Tutorial-Code-20xxx`` （下称代码仓库，最后几位 x 表示学期）与存放用户程序的 ``rCore-Tutorial-Test-20xxx`` （下称测例仓库）。 你首先需要进入代码仓库文件夹并 clone 用户程序仓库（如果已经执行过该步骤则不需要再重复执行）： .. code-block:: console diff --git a/guide/source/chapter3/0intro.rst b/guide/source/chapter3/0intro.rst index b269881..0acfbdc 100644 --- a/guide/source/chapter3/0intro.rst +++ b/guide/source/chapter3/0intro.rst @@ -16,6 +16,22 @@ 实践体验 ------------------------------------- +.. note:: + + 基于github classroom的开发方式 + + 基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 + + 1. 在网络浏览器中用自己的 github id 登录 github.com + 2. 接收 `第一个实验(os3)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 + 3. 完成第二步后，你的第一个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 + 4. 在你的第一个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 6. 在vscode的 `console` 中执行 `make setupclassroom` （该命令仅执行一次）配置githubclassroom 自动评分功能。 + 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 + + 上述的3，4，5步不是必须的，你也可以线下本地开发。 + .. 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 f8d1e40..a12379c 100644 --- a/guide/source/chapter4/0intro.rst +++ b/guide/source/chapter4/0intro.rst @@ -10,6 +10,22 @@ 实践体验 ----------------------- +.. note:: + + 基于github classroom的开发方式 + + 基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 + + 1. 在网络浏览器中用自己的 github id 登录 github.com + 2. 接收 `第二个实验(os4)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 + 3. 完成第二步后，你的第二个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 + 4. 在你的第二个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 6. 在vscode的 `console` 中执行 `make setupclassroom` （该命令仅执行一次）配置githubclassroom 自动评分功能。 + 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 + + 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 本章应用运行起来效果与上一章基本一致。 获取本章代码： diff --git a/guide/source/chapter5/0intro.rst b/guide/source/chapter5/0intro.rst index ac21a73..7c9d37a 100644 --- a/guide/source/chapter5/0intro.rst +++ b/guide/source/chapter5/0intro.rst @@ -4,6 +4,22 @@ 本章导读 ------------------------------------------- +.. note:: + + 基于github classroom的开发方式 + + 基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 + + 1. 在网络浏览器中用自己的 github id 登录 github.com + 2. 接收 `第三个实验(os5)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 + 3. 完成第二步后，你的第三个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 + 4. 在你的第三个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 6. 在vscode的 `console` 中执行 `make setupclassroom` （该命令仅执行一次）配置githubclassroom 自动评分功能。 + 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 + + 上述的3，4，5步不是必须的，你也可以线下本地开发。 + 我们将开发一个用户 **终端** (Terminal) 或 **命令行** (Command Line Application, 俗称 **Shell** ) ， 形成用户与操作系统进行交互的命令行界面 (Command Line Interface)。 diff --git a/guide/source/chapter6/0intro.rst b/guide/source/chapter6/0intro.rst index d7e0fc6..694b301 100644 --- a/guide/source/chapter6/0intro.rst +++ b/guide/source/chapter6/0intro.rst @@ -9,6 +9,23 @@ 实践体验 ----------------------------------------- +.. note:: + + 基于github classroom的开发方式 + + 基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 + + 1. 在网络浏览器中用自己的 github id 登录 github.com + 2. 接收 `第四个实验(os6)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 + 3. 完成第二步后，你的第四个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 + 4. 在你的第四个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 6. 在vscode的 `console` 中执行 `make setupclassroom` （该命令仅执行一次）配置githubclassroom 自动评分功能。 + 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 + + 上述的3，4，5步不是必须的，你也可以线下本地开发。 + + 获取本章代码： .. code-block:: console diff --git a/guide/source/chapter8/0intro.rst b/guide/source/chapter8/0intro.rst index 8701da4..588fc2a 100644 --- a/guide/source/chapter8/0intro.rst +++ b/guide/source/chapter8/0intro.rst @@ -84,6 +84,23 @@ 实践体验 ----------------------------------------- +.. note:: + + 基于github classroom的开发方式 + + 基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。 + + 1. 在网络浏览器中用自己的 github id 登录 github.com + 2. 接收 `第五个实验(os8)的github classroom在线邀请 `_ ，根据提示一路选择OK即可。 + 3. 完成第二步后，你的第五个实验的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。 + 4. 在你的第五个实验的网页的中上部可以看到一个醒目的 `code` 绿色按钮，点击后，可以进一步看到 `codespace` 标签和醒目的 `create codesapce on main` 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中 + 5. 再按照下面的环境安装提示在vscode的 `console` 中安装配置开发环境：rustc，qemu等工具。 + 6. 在vscode的 `console` 中执行 `make setupclassroom` （该命令仅执行一次）配置githubclassroom 自动评分功能。 + 7. 然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。 + + 上述的3，4，5步不是必须的，你也可以线下本地开发。 + + 获取本章代码： .. code-block:: console