V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
Acuberoot
V2EX  ›  分享创造

向各位介绍又一个静态网站生成器: v-no

  •  
  •   Acuberoot · 2021-02-26 16:53:38 +08:00 · 2642 次点击
    这是一个创建于 1126 天前的主题,其中的信息可能已经有所发展或是发生改变。

    是不是没想到都 2021 年了还有人写静态网站生成器……

    先献祭演示及文档:

    https://akrisrn.github.io/v-no-doc/?conf=zh

    (中文版大概完成了 2/3,还有些粗糙。英文版暂时只有个空架子,准备等中文版完善后再逐步翻译。)

    项目仓库:

    https://github.com/akrisrn/v-no

    然后是简介:

    v-no 是一个为 Markdown 准备的轻量级静态网站渲染 / 生成器,也是一个由 Vue.js 驱动的纯静态单页面应用。它主要通过识别 URL 的 Hash 部分记录的路径,异步请求 Markdown 文件对页面进行渲染。你可以只把它当作一个 Markdown 渲染器使用,也可以用它的子项目 v-no-script 生成预渲染 HTML 文件,或者启动一个支持热重载的 Web 服务。

    主要特性:

    • 可切换的多配置组(以及借此实现的 l10n 和 i18n )。
    • 可嵌入的文件片段和模板(支持传递参数和切分文件)。
    • 可执行的行内脚本(执行结果会作为 Markdown 的一部分被渲染,支持 await 异步函数)。
    • 动态引入的自定义脚本和样式(可选择暂留或者常驻)。
    • 大量服务行内 / 自定义脚本的 API ( 200+,不过还不太稳定)。
    • Markdown 文件之间的双向链接(可视化网状链接关系图)。
    • 扩展了部分 Markdown 语法(自动填充链接文本、在图像链接中追加样式、折叠标题等)。
    • 额外增加了多个标记语法(文件元数据、可嵌套标签、自动生成列表、重定向页面等)。
    • 两种模式的站内搜索(关键词或元数据)。
    • 暗色 / 禅模式。

    谁有可能对它感兴趣?

    • 希望 Markdown 拥有对页面内容的可编程能力。
    • 希望细化 Markdown 文件的粒度,建立起它们之间的关联、增加复用。

    谁会对它不感兴趣?

    • 希望定制主题、更换布局(很遗憾你只能做一些样式上的调整)。
    • ...

    它的子项目:

    • v-no-script:一些需要在 Node.js 环境下执行的脚本位于这个仓库,它包含:
      • 预渲染页面的脚本(使用 Puppeteer,有同步队列和递归并发两种选择)。
      • 启动支持热重载的 Web 服务( express )的脚本(它会自动植入一个 WebSocket 客户端)。
      • 根据 git log 更新 Markdown 文件元数据的脚本。
      • 计算文件摘要,更新缓存键的脚本。
    • v-no-doc:文档仓库。
    • v-no-doc-script:文档使用的自定义脚本仓库。
    • v-no-page-component:可以作为自定义脚本引入的 Vue 单文件组件仓库,它包含:
      • 在页面中执行行内脚本的控制台。
      • 即时渲染 Markdown 的沙盒。
      • Markdown 文件之间的网状链接关系图。
    • 项目模板:
      • v-no-template:使用默认环境变量进行编译的网站模板,开箱即用,能满足通常的部署需求。
      • v-no-hash-template:为避免预渲染冲突而准备的网站模板。
      • v-no-script-template:用于搭建自定义脚本仓库的脚手架,使用 Webpack 打包,配置有:
        • vue-loader
        • ts-loader
        • babel-loader
        • sass-loader

    闲话:

    静态网站生成器这一命题下的应用实在多不胜数,和它一样用 Vue.js 驱动的也有不少,我都不清楚我这几年来闭门造了个什么。我没有将它和同类应用比较过,它作为满足我个人需求的工具,有不少缺陷、也有让我兴奋的特性。我自己倒是对它挺满意的,不过不知道别人的看法(说不定会很差劲?)。

    总之,我在这里将它推荐给 v2 的各位,要是有人能感兴趣那就太好了,peace !

    2 条回复    2021-02-27 21:48:47 +08:00
    yhz610
        1
    yhz610  
       2021-02-26 23:55:24 +08:00 via iPhone
    赞一个,不错
    muzihuaner
        2
    muzihuaner  
       2021-02-27 21:48:47 +08:00
    看起来不错,👍
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5370 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 27ms · UTC 08:34 · PVG 16:34 · LAX 01:34 · JFK 04:34
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.