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: "首页" } 后会替换为实际标题。

OpenArt
OpenArt

在线AI绘画艺术图片生成器工具

下载

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

    相关文章

    驱动精灵
    驱动精灵

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

    下载

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

    相关专题

    更多
    js获取数组长度的方法
    js获取数组长度的方法

    在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

    556

    2023.06.20

    js刷新当前页面
    js刷新当前页面

    js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

    374

    2023.07.04

    js四舍五入
    js四舍五入

    js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

    732

    2023.07.04

    js删除节点的方法
    js删除节点的方法

    js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

    477

    2023.09.01

    JavaScript转义字符
    JavaScript转义字符

    JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

    414

    2023.09.04

    js生成随机数的方法
    js生成随机数的方法

    js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

    991

    2023.09.04

    如何启用JavaScript
    如何启用JavaScript

    JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

    658

    2023.09.12

    Js中Symbol类详解
    Js中Symbol类详解

    javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

    552

    2023.09.20

    高德地图升级方法汇总
    高德地图升级方法汇总

    本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

    65

    2026.01.16

    热门下载

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

    精品课程

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

    共14课时 | 0.8万人学习

    Bootstrap 5教程
    Bootstrap 5教程

    共46课时 | 2.9万人学习

    CSS教程
    CSS教程

    共754课时 | 20.3万人学习

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

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