deploy: a48999b466

0setup-devel-env.html

@@ -308,6 +308,21 @@
 <p>Windows10 用户可以通过系统内置的 <strong>WSL2</strong> 虚拟机（请不要使用 WSL1）来安装 Ubuntu 18.04 / 20.04 。读者请自行在互联网上搜索相关安装教程，或 <a class="reference external" href="https://docs.microsoft.com/zh-cn/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package">适用于 Linux 的 Windows 子系统安装指南 (Windows 10)</a> 。</p>
 <div class="admonition note">
 <p class="admonition-title">注解</p>
+<p><strong>基于github classroom的开发方式</strong></p>
+<p>基于github classroom，可方便建立开发用的git repository，并可基于github的 codespace （在线版ubuntu +vscode）在线开发使用。整个开发环境仅仅需要一个网络浏览器。</p>
+<ol class="arabic simple">
+<li><p>在网络浏览器中用自己的 github  id 登录 github.com</p></li>
+<li><p>接收 <a class="reference external" href="https://classroom.github.com/a/hnoWuKGF">第一个实验练习 setup-env-run-os1 的github classroom在线邀请</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><strong>重要：</strong> 在vscode的 <cite>console</cite> 中执行 <cite>make setupclassroom</cite>  （该命令仅执行一次）配置githubclassroom 自动评分功能。</p></li>
+<li><p>然后就可以基于在线vscode进行开发、运行、提交等完整的实验过程了。</p></li>
+</ol>
+<p>上述的3，4，5步不是必须的，你也可以线下本地开发。</p>
+</div>
+<div class="admonition note">
+<p class="admonition-title">注解</p>
 <p><strong>Docker 开发环境</strong></p>
 <p>感谢 dinghao188 和张汉东老师帮忙配置好的 Docker 开发环境，进入 Docker 开发环境之后不需要任何软件工具链的安装和配置，可以直接将 tutorial 运行起来，目前应该仅支持将 tutorial 运行在 Qemu 模拟器上。</p>
 <p>使用方法如下（以 Ubuntu18.04 为例）：</p>
@@ -441,8 +456,9 @@ qemu-riscv64 --version
 </div>
 <div class="section" id="rcore-tutorial">
 <h2>试运行 rCore-Tutorial<a class="headerlink" href="#rcore-tutorial" title="永久链接至标题">¶</a></h2>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>git clone https://github.com/LearningOS/rust-based-os-comp2022.git
-<span class="nb">cd</span> rust-based-os-comp2022
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/LearningOS/rust-based-os-comp2022.git
+$ <span class="nb">cd</span> rust-based-os-comp2022
+$ make setupclassroom  //注意：这一步很重要，是用于github classroom自动评测你的工作。这一步只需在首次克隆项目仓库时执行一次，以后一般就不用执行了，除非 .github/workflows/classroom.yml发生了变化。
 </pre></div>
 </div>
 <p>我们先运行不需要处理用户代码的裸机操作系统 <code class="docutils literal notranslate"><span class="pre">os1</span></code> ：</p>