歡迎了解 Hollow,Hollow 是一個(gè)極簡(jiǎn)、自由的靜態(tài)網(wǎng)站生成器。你幾乎不用學(xué)習(xí) Hollow 創(chuàng)造的概念,會(huì) Jsx 與 Js 即可生成網(wǎng)站。
特性
-
Golang 與 Js 驅(qū)動(dòng)
- 支持 Js/Ts 作為配置文件(yaml 也支持)
- 使用 Jsx/Tsx 作為主題模板開(kāi)發(fā)語(yǔ)言
- 主題開(kāi)發(fā)沒(méi)有限制,代碼即所得。
- 支持 MDX
- 快速:生成 1000 篇頁(yè)面只需要 2s (雖然沒(méi)什么用)
- 支持部署到服務(wù)器,提供 Web UI 管理文章
- 在任何地方(如手機(jī)上)管理你的文章
- 云端文件支持同步到 Git 上,不怕文件丟失
適用于
- "想要從零開(kāi)發(fā)主題、網(wǎng)站,但不愿被框架限制" 的人
- "需要使用 Web UI 寫(xiě)作" 的人
Hollow 世界觀(guān)
在 Hollow 的世界中,代碼即所得,因?yàn)橹黝}使用 JavaScript 驅(qū)動(dòng),它是圖靈完備的,所以沒(méi)必要再定義限制:如路由、布局、標(biāo)簽、歸檔等。不再拘謹(jǐn)于框架給你的概念,這次你自己創(chuàng)造。
當(dāng)你想要實(shí)現(xiàn)更多需求的時(shí)候,最好的方式是自己開(kāi)發(fā)"主題",而不是讓某個(gè)"主題"提供給你功能。
在大多數(shù)時(shí)候,復(fù)制一個(gè)已有的主題再更改更簡(jiǎn)單
主題只有一個(gè)入口,即 index.tsx,和一個(gè)平常的 JavaScript 項(xiàng)目一樣,支持 import 或 require 語(yǔ)法,如何組織你的主題,這完全取決于你。
借助于 Jsx 語(yǔ)法,主題開(kāi)發(fā)是很簡(jiǎn)單的,比如一個(gè)最簡(jiǎn)單的主題只有一個(gè)文件:
// 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>
},
},
],
}
當(dāng)然這個(gè)簡(jiǎn)單的主題通常是不夠用的,這里只是介紹下開(kāi)發(fā)主題足夠簡(jiǎn)單,有關(guān)開(kāi)發(fā)主題的詳細(xì)文檔可查看:主題開(kāi)發(fā)。
文章管理
和大多數(shù)博客生成器一樣,你可以使用 Markdown 語(yǔ)法來(lái)編寫(xiě)文章,除了 Markdown 語(yǔ)法,MDX 語(yǔ)法 Hollow 也借鑒了過(guò)來(lái),不過(guò)由于 MDX 十分復(fù)雜,Hollow 只實(shí)現(xiàn)了子集。
一個(gè) md/mdx 例子文件如下:
---
title: 開(kāi)發(fā)主題
desc:
slug: theme-dev
sort: 1
---
export let A = (src)=> {return <img src={src}>}
# Title
<A src="./jpg"></A>
其中 meta 完全由主題而不是 Hollow 指定,你可以翻閱主題文檔來(lái)查看其支持的 meta。
詳細(xì)內(nèi)容請(qǐng)看:管理文章 章節(jié)