0

0

如何实现一个JavaScript驱动的静态站点生成器(SSG)?

夜晨

夜晨

发布时间:2025-10-12 09:16:02

|

798人浏览过

|

来源于php中文网

原创

答案:javascript 驱动的静态站点生成器通过 node.js 读取模板与内容,利用字符串替换或 markdown 解析渲染 html,再批量输出文件。核心流程为:设计 content、templates、public 目录结构;使用 fs 模块读写文件;通过简单模板引擎替换 {{key}} 插值;借助 marked 库将 markdown 转为 html;遍历内容文件批量生成页面;可额外构建首页聚合链接。关键点包括路径处理、错误捕获与输出清理,后续可扩展 front matter、css 注入等功能。整个过程不依赖框架,突出轻量与可控性。

如何实现一个javascript驱动的静态站点生成器(ssg)?

实现一个 JavaScript 驱动的静态站点生成器(SSG)并不需要依赖复杂的框架。核心思路是:用 Node.js 读取模板和内容文件,通过 JavaScript 处理数据并渲染 HTML,最后输出静态文件到指定目录。

1. 基本结构设计

一个最简 SSG 包含以下几个部分:

  • content/:存放 Markdown 或 JSON 内容文件
  • templates/:HTML 模板文件(可用简单的字符串模板)
  • public/:输出静态文件的目录
  • build.js:主构建脚本

2. 使用 Node.js 读写文件

利用 fspath 模块处理文件系统操作:

const fs = require('fs');
const path = require('path');

function readFile(filePath) {
  return fs.readFileSync(filePath, 'utf-8');
}

function writeFile(filePath, content) {
  fs.writeFileSync(filePath, content);
  console.log(`已生成: ${filePath}`);
}

3. 渲染模板

可以使用简单的字符串替换实现模板引擎:

立即学习Java免费学习笔记(深入)”;

function renderTemplate(template, data) {
  return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
    return data[key] || match;
  });
}

例如模板

{{title}}

,传入 { title: "首页" } 后会替换为实际标题。

飞书多维表格
飞书多维表格

表格形态的AI工作流搭建工具,支持批量化的AI创作与分析任务,接入DeepSeek R1满血版

下载

4. 处理 Markdown 内容

安装 marked 解析 Markdown:

npm install marked

在构建脚本中使用:

const { marked } = require('marked');

const mdContent = readFile('content/post1.md');
const htmlContent = marked.parse(mdContent);

5. 构建页面流程

以生成一篇文章为例:

const template = readFile('templates/post.html');
const content = readFile('content/post1.md');

const data = {
  title: '我的第一篇文章',
  content: marked.parse(content)
};

const html = renderTemplate(template, data);
writeFile('public/post1.html', html);

6. 批量生成多页

遍历 content 目录自动生成所有文章:

fs.readdirSync('content').forEach(file => {
  if (path.extname(file) === '.md') {
    const slug = path.basename(file, '.md');
    const content = readFile(`content/${file}`);
    const html = marked.parse(content);

    const page = renderTemplate(template, {
      title: `关于 ${slug}`,
      content: html
    });

    writeFile(`publichttps://www.php.cn/link/eb22f88f11afb43e5ad8075fc7b2491e`, page);
  }
});

7. 添加首页或路由索引

可以额外生成一个首页,列出所有文章链接:

let links = '';
fs.readdirSync('content').forEach(file => {
  const slug = path.basename(file, '.md');
  links += `<li><a href="https://www.php.cn/link/eb22f88f11afb43e5ad8075fc7b2491e">${slug}</a></li>`;
});

const homeHtml = renderTemplate(homeTemplate, { links });
writeFile('public/index.html', homeHtml);
基本上就这些。不复杂但容易忽略细节,比如路径处理、错误捕获和输出目录清理。你可以逐步扩展功能,比如支持 Front Matter(用 gray-matter 解析)、CSS 自动注入、或者生成 RSS。核心是:读数据、套模板、写文件。

相关文章

驱动精灵
驱动精灵

驱动精灵基于驱动之家十余年的专业数据积累,驱动支持度高,已经为数亿用户解决了各种电脑驱动问题、系统故障,是目前有效的驱动软件,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

455

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

546

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

335

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 42.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号