Grain编程语言官方网站：文档与贡献指南

资源摘要信息:"谷物语言网站（grain-lang.org）是Grain编程语言的官方文档网站。Grain是一种新兴的、专注于安全性和并发性的系统编程语言。网站的构建基于Markdown文件，并使用Hexo框架生成静态网站内容。Hexo是一个快速、简洁且功能强大的静态网站生成器，它允许开发者通过简单的标记语言来创建网站内容。Hexo使用Node.js编写，并且可以将内容渲染成静态HTML文件，从而提高网站的加载速度和安全性。 网站托管在Netlify平台上。Netlify是一个现代的前端开发工作流程和托管服务，它提供了自动化的网络构建、部署和托管解决方案。用户可以通过Git集成自动化其开发流程，Netlify支持持续部署（Continuous Deployment, CD），意味着每次更新到源代码仓库时，Netlify都可以自动构建并部署网站的最新版本。 网站文档的贡献指南提供了如何参与文档改进的具体步骤。首先，为了正确克隆包含git子模块的仓库，建议使用带有`--recurse-submodules`参数的`git clone`命令。这样做可以确保仓库的子模块也被一同下载，子模块通常用于管理仓库内其他外部依赖的代码。如果仓库已经克隆，但尚未包含子模块，可以使用`git pull --recurse-submodules`命令来拉取更新的子模块内容。 对于编辑和新增网站内容，贡献者需要直接编辑Markdown文件。Markdown是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。Markdown文件的路径结构与网站上的URL路径相匹配，这样可以方便地找到对应的文件进行编辑。如果某个页面在本地找不到对应的Markdown文件，网站页面顶部提供了一个“在GitHub上编辑”按钮，允许用户直接在GitHub上进行编辑，并通过Pull Request将变更合并到文档仓库中。 新增文档页面时，需要在`/src`目录下创建新的Markdown文件，并且需要更新边栏配置以在网站上显示新页面。边栏通常位于网站的侧边栏，用以导航网站内容，提供给用户一个清晰的网站结构和内容分类。新页面的添加可能涉及到修改配置文件或者模板文件来反映新内容，这部分通常使用EJS（Embedded JavaScript Templates）模板引擎来实现。 EJS是一种服务器端模板引擎，它允许在HTML文件中嵌入JavaScript代码。通过使用EJS模板，开发者可以将数据动态地插入到HTML中，这些数据通常来自于应用程序的后端。EJS模板可以包含条件判断、循环等逻辑控制语句，也可以使用嵌入式JavaScript表达式来输出变量。在网站中使用EJS模板意味着网站的边栏和其他部分可以通过模板引擎动态生成，根据不同的页面和数据展示不同的内容。 整个项目使用了git作为版本控制系统，git是一个开源的分布式版本控制系统，设计用来有效地管理项目的所有历史记录，包括代码、文档和所有类型的文件。git子模块功能允许一个git仓库中包含另一个git仓库的目录作为其子目录。这在管理多个仓库时特别有用，特别是当涉及到依赖管理时。"