提交 a952ea7b 创建 作者: 宋海霞's avatar 宋海霞

更新 app-manual.md

上级 0e6dcbe8
...@@ -4,6 +4,9 @@ ...@@ -4,6 +4,9 @@
[登录](#登录) [登录](#登录)
[主窗口布局](#主窗口布局) [主窗口布局](#主窗口布局)
[新建实验项目](#新建实验项目) [新建实验项目](#新建实验项目)
[从实验模板 fork 一个新项目](#从实验模板-fork-一个新项目)
[将新项目克隆到本地](#将新项目克隆到本地)
[项目中的文件](#项目中的文件)
[阅读实验源代码](#阅读实验源代码) [阅读实验源代码](#阅读实验源代码)
[生成项目](#生成项目) [生成项目](#生成项目)
[解决语法错误](#解决语法错误) [解决语法错误](#解决语法错误)
...@@ -42,17 +45,44 @@ DS Lab的主窗口布局由下面的若干元素组成: ...@@ -42,17 +45,44 @@ DS Lab的主窗口布局由下面的若干元素组成:
**`提示:`**菜单栏、工具栏和各种工具窗口的位置可以随意拖动。如果想恢复窗口的默认布局,选择“窗口”菜单中的“重置窗口布局”即可。 **`提示:`**菜单栏、工具栏和各种工具窗口的位置可以随意拖动。如果想恢复窗口的默认布局,选择“窗口”菜单中的“重置窗口布局”即可。
> >
# 新建实验项目
**新建一个实验项目的步骤如下:** # 从实验模板 fork 一个新项目
1. 在“文件”菜单中选择“项目”中的“从 Git 远程库新建项目”菜单项,打开“从 Git 远程库新建项目”对话框。 >
2. 在“从 Git 远程库新建项目目”对话框中,输入 Git 远程库的URL。 **`提示`** 读者从 CodeCode.net 平台领取任务时,也是使用任务中设定的实验模板 fork 了一个新项目。
3. 在“项目文件夹名称”中输入新项目使用的文件夹名称“lab1”。 >
4. 在“项目位置”中输入新项目保存在磁盘上的位置“C:\dslab”。
5. 点击“确定”按钮。 为了方便读者完成程序设计实验,CodeCode.net 平台提供了大量 [实验模板](https://www.codecode.net/engintime/ds-lab/Project-Template) 供读者使用。通常,这些实验模板只授予读者查看的权限,而没有修改的权限。所以,读者需要从实验模板 fork 出一个新项目,然后在这个新项目中编写源代码。
新建完毕后, DS Lab 会自动打开这个新建的项目。在“项目管理器”窗口中,根节点是项目节点,各个子节点是项目包含的文件夹或者文件。读者也可以使用“Windows资源管理器”打开磁盘上的“C:\dslab\lab1”文件夹,查看项目中包含的源代码文件。 可以按照下面的步骤 fork 项目:
提示:右键点击“项目管理器”窗口中的项目节点,选择快捷菜单中的“打开所在的文件夹”,即可使用“Windows资源管理器”打开项目所在的文件夹。 1. 使用浏览器打开一个实验模板。例如在浏览器地址栏中输入 https://www.codecode.net/engintime/ds-lab/Project-Template/Lab001 。注意,只有登录 CodeCode.net 平台后才能使用浏览器fork此实验模板。
2. 当浏览器打开实验模板后,点击如下图所示的 fork 按钮。
![项目管理器](./img/1.png) ![Image text](./img/fork.png)
3. 接下来读者还需要选择一个拥有新建项目权限的群组,就会在此群组中创建一个新项目。浏览器会自动跳转到新项目的页面。
# 将新项目克隆到本地
读者从实验模板 fork 项目成功后,通常需要将新项目克隆到本地磁盘,然后使用 DS Lab 编写源代码。步骤如下:
1. 使用浏览器打开 fork 得到的新项目,在项目页面中将 fork 按钮右侧的 https 项目路径复制。
2. 在 DS Lab 的“文件”菜单中选择“新建”,然后点击“从 Git 远程库新建项目”,打开“从 Git 远程库新建项目”对话框。此时会自动将剪切板中的 URL 路径复制到“Git 远程库 URL”编辑框中。
3. 在“项目文件夹名称”中输入新项目使用的文件夹名称“lab1”。
4. 在“项目位置”中输入项目保存在本地磁盘上的位置“C:\DS Lab”。
5. 点击“确定”按钮后,会弹出一个 Windows 控制台窗口,在其中显示 Git 远程库克隆到本地的进度和结果。
6. 克隆成功后,关闭 Windows 控制台窗口,选择对话框中的“打开项目”按钮,会打开在本地新建的项目。
在左侧的“项目管理器”窗口中,根节点是项目节点,各个子节点是项目包含的文件夹或者文件。读者也可以使用“Windows资源管理器”打开磁盘上的“C:\DS Lab\lab1”文件夹,查看项目中包含的源代码文件。
![Image text](./img/1.png)
>
**`提示`** 右键点击“项目管理器”窗口中的项目节点,选择快捷菜单中的“打开所在的文件夹”,即可使用“Windows资源管理器”打开项目所在的文件夹。
>
# 项目中的文件
| 文件名 | 说明 |
| :------: | :---------- |
| main.c | 在此文件中编写源代码。也可以根据编程需要添加新的源代码文件。 |
| makefile | 在 CodeCode.net 平台中(Linux)使用此文件将源代码文件编译为可执行文件,用于在线验证。如果添加了新的源代码文件,就需要在此文件中做对应的修改。 |
| input1.txt | 在自动化验证时,会将此文件中的内容重定向到标准输入。当有多个算例时,会有多个类似文件。 |
| output1.txt | 在自动化验证时,程序的标准输出会重定向到user_output1.txt文件中,然后与该文件比较,如果两个文件的内容相同,就说明验证成功,否则,验证失败。当有多个算例时,会有多个类似文件。 |
| readme.md | Markdown 格式的文本文件。通常包含编程要求等内容。 |
# 阅读实验源代码 # 阅读实验源代码
该实验包含了一个头文件“LinearList.h”和一个C源文件“main.c”。下面对这两个文件的主要内容、结构和作用进行说明: 该实验包含了一个头文件“LinearList.h”和一个C源文件“main.c”。下面对这两个文件的主要内容、结构和作用进行说明:
......
您添加了 0 到此讨论。请谨慎行事。
请先完成此评论的编辑!
注册 或者 后发表评论