deploy: 88be9778c3

_sources/chapter1/0intro.rst.txt

@@ -37,6 +37,23 @@
 实践体验
 ---------------------------
 
+.. note::
+
+   基于github classroom的开发方式
+   
+   基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。
+
+   1. 在网络浏览器中用自己的 id 登录 github.com
+   2. 接收 `第一个实验 setup-env-run-os1 的在线邀请 <https://classroom.github.com/a/hnoWuKGF>`_  ，根据提示一路选择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步不是必须的，你也可以线下本地开发。
+
+
 本章一步步实现了支持打印字符串的简单操作系统。
 
 获取本章代码：
@@ -45,6 +62,9 @@
 
    $ git clone https://github.com/LearningOS/rust-based-os-comp2022.git
    $ cd rust-based-os-comp2022/
+   $ make setupclassroom  //注意：这一步很重要，是用于github classroom自动评测你的工作。这一步只需在首次克隆项目仓库时执行一次，以后一般就不用执行了，除非 .github/workflows/classroom.yml发生了编号。
+
+
 
 运行本章代码，并设置日志级别为 ``TRACE``：
 

chapter1/0intro.html

@@ -318,10 +318,28 @@ println!("Hello world!");
 </div>
 <div class="section" id="id4">
 <h2>实践体验<a class="headerlink" href="#id4" title="永久链接至标题">¶</a></h2>
+<div class="admonition note">
+<p class="admonition-title">注解</p>
+<p>基于github classroom的开发方式</p>
+<p>基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。</p>
+<ol class="arabic simple">
+<li><p>在网络浏览器中用自己的 id 登录 github.com</p></li>
+<li><p>接收 <a class="reference external" href="https://classroom.github.com/a/hnoWuKGF">第一个实验 setup-env-run-os1 的在线邀请</a>  ，根据提示一路选择OK即可。</p></li>
+<li><p>完成第二步后，你的第一个 setup-env-run-os1 的 github repository 会被自动建立好，点击此github repository的链接，就可看到你要完成的第一个实验了。</p></li>
+<li><p>在你的第一个实验的网页的中上部可以看到一个醒目的 <cite>code</cite>  绿色按钮，点击后，可以进一步看到  <cite>codespace</cite> 标签和醒目的 <cite>create codesapce on main</cite> 绿色按钮。请点击这个绿色按钮，就可以进入到在线的ubuntu +vscode环境中</p></li>
+<li><p>再按照下面的环境安装提示在vscode的 <cite>console</cite> 中安装配置开发环境：rustc，qemu等工具。</p></li>
+<li><p>在vscode的 <cite>console</cite> 中执行 <cite>make setupclassroom</cite>  （该命令仅执行一次）配置githubclassroom 自动评分功能。</p></li>
+<li><p>然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。</p></li>
+</ol>
+<blockquote>
+<div><p>上述的3，4，5步不是必须的，你也可以线下本地开发。</p>
+</div></blockquote>
+</div>
 <p>本章一步步实现了支持打印字符串的简单操作系统。</p>
 <p>获取本章代码：</p>
 <div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>git clone https://github.com/LearningOS/rust-based-os-comp2022.git
 <span class="gp">$ </span><span class="nb">cd</span> rust-based-os-comp2022/
+<span class="gp">$ </span>make setupclassroom  //注意：这一步很重要，是用于github classroom自动评测你的工作。这一步只需在首次克隆项目仓库时执行一次，以后一般就不用执行了，除非 .github/workflows/classroom.yml发生了编号。
 </pre></div>
 </div>
 <p>运行本章代码，并设置日志级别为 <code class="docutils literal notranslate"><span class="pre">TRACE</span></code>：</p>