https://blog.bysir.top/blogs/hollow/
Hollow 是一个快速、自由的静态博客生成器。
- 支持部署到服务器，提供 Web UI 管理文章
- 在任何地方（如手机上）管理你的文章
- 云端文件也支持提交到 Git 上，不怕文件丢失
- Js 驱动
- 支持 Js/Ts 作为配置文件（yaml 也支持）
- 使用 Jsx/Tsx 作为主题模板开发语言
- 主题开发没有限制，极少概念，代码即所得。
- 支持 MDX
- 快速：生成 1000 篇页面只需要 2s (虽然没什么用)
- "想要从零开发主题、网站，但不想学习框架概念" 的人
- "需要使用 Web UI 写作" 的人
在 Hollow 的世界中，代码即所得，因为主题使用 JavaScript 驱动，它是图灵完备的，所以没必要再定义限制：如路由、布局、标签、归档等。不再拘谨于框架给你的概念，这次你自己创造。
当你想要实现更多需求的时候，最好的方式是自己开发"主题"，而不是让某个"主题"提供给你功能。
在大多数时候，复制一个已有的主题再更改更简单
主题只有一个入口，即 index.tsx，和一个平常的 JavaScript 项目一样，支持 import 或 require 语法，如何组织你的主题，这完全取决于你。
借助于 Jsx 语法，主题开发是很简单的，比如一个最简单的主题只有一个文件：
// index.tsx
function Index(props) {
return <html lang="zh" class="dark">
<head>
<meta charSet="UTF-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>{props.title || 'UnTitled'}</title>
</head>
<body className="">
<div>
{props.body}
</div>
</body>
</html>
}
export default {
pages: [
{
path: '',
component: () => {
return <Index title={"Hi!"} body={"I am hollow"}></Index>
},
},
],
}一个完整的主题例子 看这里
go install github.com/zbysir/hollow@latest或者直接使用 Docker (更推荐): https://hub.docker.com/r/bysir/hollow
这是一个可选步骤，用于快速查看一个主题的样子
docker run -p 9400:9400 bysir/hollow:master server -t https://github.com/zbysir/hollow-theme/tree/master/hollow- 创建项目文件夹, 如.
book，然后进入book目录 - 创建
contents文件用于存储内容 - 创建一些内容, 如文件名为
contents/hello.md, 内容如下:--- title: "Hello Hollow" date: 2022-03-22 --- # Hello Hollow write something here
- 现在你的项目结构看起来是这样的:
./ └── contents/ └── hello.md - 预览你的网站
- 运行 Hollow 服务
docker run -v ${PWD}:/source -p 9400:9400 bysir/hollow:master server -t https://github.com/zbysir/hollow-theme/tree/master/hollow - 打开任何浏览器访问
http://localhost:9400
- 运行 Hollow 服务
-
下面的命令将会构建文件到
.dist目录下docker run -v ${PWD}:/source bysir/hollow:master build -o /source/.dist -t https://github.com/zbysir/hollow-theme/tree/master/hollow./ ├── .dist/ └── contents/ └── hello.md -
然后将文件部署到 Github page 上
如果你的源文件托管在 Github 上，并且网站也想发布在 Github page 上，那么使用 Github Action 发布网站是最佳选择。
在 项目根目录下新建 .github/workflows/hollow.yaml，内容如下
name: Deploy Hollow with GitHub Pages
on:
# Runs on pushes targeting the default branch
push:
branches: ["master"]
# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
contents: read
pages: write
id-token: write
# Allow one concurrent deployment
concurrency:
group: "pages"
cancel-in-progress: true
jobs:
# Build job
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v3
- name: Setup Pages
uses: actions/configure-pages@v2
- name: Build with Hollow
uses: docker://bysir/hollow:master
with:
args: build
env:
SOURCE: .
OUTPUT: ./dist
- name: Upload artifact
uses: actions/upload-pages-artifact@v1
with:
path: "./dist"
# Deployment job
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: build
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v1现在只需要将源文件提交到 Github 上，等 30s 网站就自动上线了。
由于 UI 比想象中复杂，所以被独立为单独的项目，你可以在 这里 找到它（还在制作中）。