Eleveny-Notes 项目启动与配置教程

1. 项目目录结构及介绍

Eleventy-Notes 是一个基于 Eleventy 的静态站点生成器项目。项目的目录结构如下：

eleventy-notes/
├── _data/                    # 存储数据文件，如 JSON 或 CSV 格式
├── _includes/                # 包含可重用的模块，例如页眉、页脚等
├── _layouts/                 # 页面布局文件，定义了页面的基本结构
├── _posts/                   # 存储博客文章的 Markdown 文件
├── assets/                   # 存储静态资源，如图片、CSS、JavaScript 文件等
├── .eleventy.js              # Eleventy 的配置文件
├── package.json              # Node.js 项目配置文件
├── README.md                 # 项目说明文件
└── index.md                  # 网站首页的 Markdown 文件

• _data/：这个目录用于存放项目所需要的数据，可以是 JSON、CSV 或其他格式。
• _includes/：用于存放可以重用的 HTML 片段，如页眉、页脚等。
• _layouts/：定义了页面的基本结构，其他页面可以基于这些布局进行扩展。
• _posts/：存放博客文章的 Markdown 文件，Eleventy 会自动处理这些文件生成静态页面。
• assets/：所有静态资源文件，如图像、CSS 样式表和 JavaScript 脚本都放在这里。
• .eleventy.js：Eleventy 的配置文件，用于自定义 Eleventy 的行为。
• package.json：Node.js 项目配置文件，定义了项目的依赖和脚本。
• README.md：项目的说明文件，介绍了项目的相关信息。
• index.md：网站首页的 Markdown 文件，定义了网站首页的内容。

2. 项目的启动文件介绍

项目的启动主要通过 package.json 文件中的脚本实现。以下是如何启动项目的步骤：

1. 确保你的系统中已安装 Node.js。
2. 克隆项目到本地。
3. 在项目根目录下打开终端。
4. 运行 npm install 命令安装项目依赖。
5. 运行 npm run build 命令构建网站。
6. 运行 npm start 命令启动本地服务器，通常默认端口为 8080。

3. 项目的配置文件介绍

项目的配置主要通过 .eleventy.js 文件进行。以下是配置文件的简要介绍：

module.exports = function(eleventyConfig) {
  // 添加 passthrough 处理器
  eleventyConfig.addPassthroughCopy("assets");
  // 配置其他选项
  // ...
};

在 .eleventy.js 文件中，你可以添加自定义的处理器、配置模板引擎、设置全局变量等，以自定义 Eleventy 的行为。例如，上面的代码示例中，我们通过 addPassthroughCopy 方法将 assets 目录中的文件直接复制到输出目录中，保持其原有的目录结构。这样，当你构建网站时，所有静态资源都会被正确地处理和部署。