html 语言 静态站点生成页面 eleventy 应用

html阿木 发布于 21 天前 4 次阅读


使用Eleventy构建静态站点生成页面:从入门到实践

随着互联网的快速发展,静态站点生成器(Static Site Generator,SSG)因其快速部署、易于维护和良好的SEO表现而受到越来越多的关注。Eleventy是一款流行的静态站点生成器,它简单易用,功能强大,可以帮助开发者快速构建高质量的静态网站。本文将围绕Eleventy,从入门到实践,详细介绍如何使用它来生成静态站点。

一、Eleventy简介

Eleventy是一个基于Node.js的静态站点生成器,它允许开发者使用Markdown、HTML、JavaScript等前端技术来编写内容,并通过配置文件和插件来定制站点结构。Eleventy生成的静态站点可以直接部署到服务器或云平台,无需服务器端语言支持。

二、安装与配置

1. 安装Node.js

确保你的开发环境中安装了Node.js。你可以从[Node.js官网](https://nodejs.org/)下载并安装。

2. 创建项目目录

在命令行中,创建一个新的项目目录,并进入该目录:

bash

mkdir my-eleventy-site


cd my-eleventy-site


3. 初始化npm项目

在项目目录中,运行以下命令来初始化一个新的npm项目:

bash

npm init -y


4. 安装Eleventy

接下来,安装Eleventy:

bash

npm install @11ty/eleventy --save-dev


5. 配置Eleventy

在项目根目录下,创建一个名为`eleventy.config.js`的配置文件。以下是配置文件的示例:

javascript

const eleventy = require('@11ty/eleventy');

module.exports = function(config) {


// 配置模板引擎


config.addTemplateFormats('md', 'html');

// 配置插件


config.addPassthroughCopy('src/images');


config.addPassthroughCopy('src/css');

// 配置布局


config.addLayoutAlias('default', 'layouts/default.njk');

// 配置数据文件


config.addShortcode('year', () => new Date().getFullYear());

// 返回配置对象


return {


templateFormats: ['md', 'html', 'njk'],


passthroughFileCopy: true,


dir: {


input: 'src',


output: 'public',


layouts: 'src/layouts',


data: 'src/data',


},


};


};


三、编写内容

在`src`目录下,你可以创建Markdown、HTML或Nunjucks模板文件来编写内容。以下是一个Markdown文件的示例:

markdown

---


title: "Hello Eleventy"


date: "2023-04-01"


layout: "default.njk"


---

Hello Eleventy

Welcome to your new Eleventy site!


四、生成静态站点

在命令行中,运行以下命令来生成静态站点:

bash

npm run dev


这将启动一个本地服务器,并在`public`目录下生成静态站点。你可以通过访问`http://localhost:9000`来预览站点。

五、部署站点

生成静态站点后,你可以将其部署到服务器或云平台。以下是一些常用的部署方法:

1. GitHub Pages

如果你使用GitHub托管你的项目,可以通过以下步骤将站点部署到GitHub Pages:

- 在GitHub仓库的设置中,选择“GitHub Pages”选项卡。

- 在“Source”下拉菜单中,选择“master branch”。

- 点击“Save”按钮。

2. Netlify

Netlify是一个静态站点托管平台,你可以通过以下步骤将站点部署到Netlify:

- 在Netlify官网注册并登录。

- 点击“New site”按钮,选择“Import from Git”。

- 输入你的GitHub仓库信息,并选择分支。

- 点击“Import”按钮。

3. Vercel

Vercel是一个现代Web平台,你可以通过以下步骤将站点部署到Vercel:

- 在Vercel官网注册并登录。

- 点击“New Project”按钮,选择“Import from Git”。

- 输入你的GitHub仓库信息,并选择分支。

- 点击“Import”按钮。

六、总结

Eleventy是一款功能强大的静态站点生成器,它可以帮助开发者快速构建高质量的静态网站。你应该已经了解了如何使用Eleventy来创建、生成和部署静态站点。希望这篇文章能帮助你入门Eleventy,并在实践中不断探索和提升。