开始创作

2022-02-19 ⏳2.4分钟(1.0千字)

成功入驻乐乎之后,你的本地文件夹会多出一些文件。你可以尝试访问自己的域名,会看到跟乐乎网站一模一样的内容。之所以如此,那是因为我们把乐乎网站的内容同步到你的电脑,供你创作入门参考之用。

基础配置

在开始创作之前,你需要修改博客配置信息。所有的配置都保存在env文件。这是 bash 的环境变量配置文件,等号两边不能不空格,等号右边的内容如果包含空格或者等号,则需要用引号引起来。

目前支持的基本变量如下:

如果想开启 Google AdSense 和 Google analytics,则需要提供以下信息2

开始创作

乐乎支持标准 Markdown 语法以及 Pandoc Markdown 语法3

你可以使用趁手的编辑器创作 Markdown 文件。Markdown 文件需要设置 Front Matter 变量,至少需要指定 titledate 两个变量。title为文章标题,date为发布日期。日期格式推荐为YYYY-MM-DD,文章会按照日期从新到旧排序。

下面是一篇最简单的文章结构:

---
title: "Hello, World"
date: 2006-05-04
---

Hello, <lehu.in>.

你也可以任意创建文件夹。比如创建vim/目录,并发布vim/hello.md文件,则可以通过 https://domain/vim/hello.html访问。乐乎会自动生成/index.htmlvim/index.html,访问https://domain/vim/也会看到一个文章列表,但该列表页仅包含当前目录下的文章。

如果只想临时预览发布效果可以在title标题添加WIP:wip:前缀,乐乎在生成文章列表时会自动跳过有WIP:前缀的文章,但仍然会为该文章生成对应的 HTML 文件。作者可以根据文章路径预览效果。完稿后不需要修改文章路径,去掉WIP:前缀就可以了。

如果要插入图片,则需要把对应图片保存到同步目录,也可以创建各种层级的文件夹来保存图片,引用图片使用对应的相对路径即可。

请务必认真构思文章第一段内容。乐乎会提取第一段用作文章的内容摘要,并将其写入 description meta 字段,供搜索引擎使用。乐乎还会将第一段写入 ATOM 摘要字段。所以请务必认真构思首段内容。

文件保存后就可以打开网站查看展示效果了,就是这么简单。

更多 Markdown 语法请参考这篇文章

如果你不满意默认的样式,也可以自己动手装修


  1. 考虑到用户的评论很少且需要对外展示的更少,乐乎仅提供基础的留言功能。留言内容仅作者可见。如果作者觉得有必要公开,则可以追加到文章正文。这样可以杜绝引流等垃圾评论。具体设计和实现可以参考这篇文章↩︎

  2. 建议同时开启 Google AdSense 和 Google Analytics。虽然很多人会用浏览器插件屏蔽广告和数据上报,但还是有可观的用户允许展示和上报。这有助于谷歌判定网站的内容质量,从而提高网站在搜索结果里的排名。AdSense 开户可以参考这篇文章。但谷歌会审查网站的质量,只有积累一定数量的内容才能开通。↩︎

  3. https://garrettgman.github.io/rmarkdown/authoring_pandoc_markdown.html↩︎