/oceanpress_old

将 Markdown 文件转换为 HTML 生成静态站点的工具,专为思源笔记实现了许多特有渲染效果。

Primary LanguageJavaScriptMIT LicenseMIT

这个项目已经停止维护

现在推荐使用新版 https://github.com/siyuan-note/oceanpress

OceanPress

将 MarkDown 文件转换为 html 的静态站点

点击这里查看生成后的效果 静态文件位于 gh-pages

搭配 hexo 的效果

运行方式 run

下载地址 只需下载所用平台的二进制文件与 views.zip 就可以了

平台 命令 备注
Windows .\md2website-windows-4.0-amd64.exe 参数
Linux .\md2website-linux-amd64 参数
Mac .\md2website-darwin-10.6-amd64 参数 我没有尝试过,因为我没有 mac
源码 go run .\src\ 参数

参数

参数名 示例
SourceDir 是笔记所在目录 C:/Users/llej/Documents/SiYuan/data/note
OutDir 是你要输出的目录 D:/code/doc/docHTML
viewDir 之前下载的 view.zip 解压后的目录,
可以自行修改其中的文件来定制一些效果
./views/
SqlitePath 是思源生成的 db 文件的路径 C:/Users/llej/AppData/Local/Temp/siyuan/siyuan.db
RssNoOutputHtml 对于后缀为.rss.xml的文档不输出对应的html true(默认值)

示例:

❯ ./md2website-windows-4.0-amd64.exe -SourceDir C:/Users/llej/Documents/SiYuan/data/note -OutDir D:/code/doc/docHTML -TemplateDir D:/code/oceanpress/src/views -SqlitePath C:/Users/llej/AppData/Local/Temp/siyuan/siyuan.db

# 运行输出

0. === 🛬 开始转换 🛫 ===
1. 用户输入
   1.1 sourceDir:C:\Users\llej\Documents\SiYuan\data\note
   1.2 outDir:D:\code\doc\docHTML
   1.3 viewsDir:D:\code\oceanpress\src\views
   1.4 dbPath:C:\Users\llej\AppData\Local\Temp\siyuan\siyuan.db
   1.5 AssetsDir:C:\Users\llej\Documents\SiYuan\data\assets
2. copy 资源到 outDir
   2.1 copy 完成
3. 生成 html
   3.1 收集转换生成所需数据
   3.2 复制资源文件
   3.3 从文件到数据结构转换完毕,开始生成html,共 293 项
   [warn] 未找到id 20210104102607-1rhjb41 对应的fileEntity
   [warn] 未找到id 20210511124801-bhveys4 对应的fileEntity
   ----- End -----

待完成的功能点(按优先级降序排序)

下面很久没有更新了,请点击此链接查看更新记录

可用 功能名 大致进度
#6 内容块动态查询渲染 80%
❎🔨 #4 菜单页面美化 15%
✅🔨 #2 嵌入块渲染 目前不支持循环引用 60%
目录树
页面 header 与 footer
块引用当前页面预览
块链接可 copy
书签页
标签页
✅🔨 #8 反链 50%
✅🔨 #1 块引用链接 92%
支持 {.text} 这样的锚文本。
思源1.2后已经不再支持
100%
#3 代码高亮 以及 数学公式和脑图等渲染 点击这里查看生成后的效果
还需要修改 vditor 等资源的引用为本地文件(不是很重要之后再说)
100%
  1. ✅ 表示基本可以使用了
  2. 🔨 表示还在修改中
  3. ❎ 表示有一小部分功能可以使用了但还存在比较大的问题
  4. ❌ 表示不可用
  5. ⭕ 表示尚未开始

相关

使用本产品的网站

欢迎您向我提交您的网站地址,我将在审阅后添加到此处

开发

整体设计

渲染

  • 自定义渲染器在 ./src/render/ocean_press_render_custom.go 下
    • render 目录下的其他文件均是从 lute 项目中 copy 过来的

/front-end-lib

这个目录下是一个使用 svelte 的前端项目,目的是为了提供前端技术上的支持

这个项目主要的思路是提供自定义组件的 js 文件,然后在 html 的模板中就直接使用自定义组件的标签了,这样方便用户替换其中的一些实现。

目前生成的资源有:

js 文件 描述 体积
all_components 包含了所有组件 266KB
block-ref.web_components 块引用组件 4KB
embedded-block.web_components 嵌入块组件 5KB
md.web_components.js 文档渲染组件
因为引入了 vditor 所以稍微有点大
263KB

默认引入 all_components.js

build

go build -o md2website.exe .\src\

RssNoOutputHtml