【亲测免费】 CS自学指南 - 使用教程

本教程将指导您了解并使用基于GitHub的开源项目【PKUFlyingPig/cs-self-learning】，这是一个关于计算机科学自学者的资源集合。

1. 项目目录结构及介绍

项目的主要目录结构如下：

.
├── docs                  # 文档目录，包含Markdown格式的学习指南和其他文档
│   ├── overrides         # Markdown文件的部分覆盖，用于更新或修改已有内容
│   └── ...
├── .editorconfig         # 编辑器配置文件，保持代码风格一致性
├── .gitignore            # Git忽略文件列表
├── LICENSE               # 许可证文件，规定项目使用权限
├── README.md             # 主页Markdown文件，项目简介
├── mkdocs.yml            # MkDocs配置文件，用于构建网站
└── requirements.txt      # Python依赖项列表，用于构建文档环境
└── ...                   # 其他相关文件和目录

• docs: 包含所有的自学指南和相关资源，overrides子目录用于更新文档的特定部分。
• .editorconfig: 提供编辑器配置，确保代码的一致性和整洁性。
• .gitignore: 规定Git不应跟踪的文件类型。
• LICENSE: 项目采用的许可证，定义了允许他人使用的条件。
• README.md: 项目的基本信息和说明。
• mkdocs.yml: MkDocs配置文件，用于定义文档结构和样式。
• requirements.txt: 列出构建文档环境所需的Python库。

2. 项目的启动文件介绍

该项目的核心并非传统的执行程序，而是一份Markdown格式的知识库。要查看和交互，您可以：

1. 本地预览文档：
   • 安装Python和pip.
   • 安装依赖包：pip install -r requirements.txt
   • 运行mkdocs serve命令，这将在本地启动一个服务器，预览文档：http://127.0.0.1:8000
   • 更改docs目录下的Markdown文件，浏览器会实时刷新显示变化。

3. 项目的配置文件介绍

mkdocs.yml

mkdocs.yml文件是项目文档的主配置文件，它定义了页面结构、主题、导航菜单等。例如：

site_name: CS自学指南
site_description: '来自PKUFlyingPig的计算机科学自学资源'
site_url: https://your-site-url.com
nav:
  - 首页: README.md
  - 学科指南:
    - 数据结构: subjects/data-structures.md
    - 计算机网络: subjects/computer-networks.md
...
theme: material
plugins:
  - search
extra_javascript:
  - js/custom.js
markdown_extensions:
  - toc:
      permalink: true

在这个配置中：

• site_name和site_description设置了网站的名字和描述。
• nav定义了导航菜单结构，如首页和其他学科指南页面。
• theme指定使用的MkDocs主题，这里是Material Design主题。
• plugins列出了启用的插件，如搜索功能。
• extra_javascript包含额外的JavaScript文件，可能用于增强用户体验。
• markdown_extensions添加Markdown扩展，比如自动目录(toc)。

如果您希望对文档进行个性化设置，可以编辑mkdocs.yml文件以调整上述选项。

希望这篇教程对您的CS自学之路有所帮助。如有疑问或想要贡献内容，请参照项目中的说明文件。祝学习愉快！