开始创作
乐乎成功入驻乐乎之后,你的本地文件夹会多出一些文件。你可以尝试访问自己的域名,会看到跟乐乎网站一模一样的内容。之所以如此,那是因为我们把乐乎网站的内容同步到你的电脑,供你创作入门参考之用。
基础配置
在开始创作之前,你需要修改博客配置信息。所有的配置都保存在env
文件。这是 bash 的环境变量配置文件,等号两边不能不空格,等号右边的内容如果包含空格或者等号,则需要用引号引起来。
目前支持的基本变量如下:
site_title
网站名称,比如「乐乎」author_name
作者名字,会显示在文章标题下面和 Atom 订阅文件中author_email
作者邮箱,用户留言1也会发送到该邮箱,会显示在 Atom 文件author_url
作者个人首页,默认是/about.html
,可不填
如果想开启 Google AdSense 和 Google analytics,则需要提供以下信息2:
ga_id
Google AdSense 识别码gt_id
Google Analytics 识别码
开始创作
乐乎支持标准 Markdown 语法以及 Pandoc Markdown 语法3。
你可以使用趁手的编辑器创作 Markdown 文件。Markdown 文件需要设置 Front Matter 变量,至少需要指定 title
和 date
两个变量。title
为文章标题,date
为发布日期。日期格式推荐为YYYY-MM-DD
,文章会按照日期从新到旧排序。
下面是一篇最简单的文章结构:
---
title: "Hello, World"
date: 2006-05-04
---
<lehu.in>. Hello,
你也可以任意创建文件夹。比如创建vim/
目录,并发布vim/hello.md
文件,则可以通过 https://domain/vim/hello.html
访问。乐乎会自动生成/index.html
和vim/index.html
,访问https://domain/vim/
也会看到一个文章列表,但该列表页仅包含当前目录下的文章。
如果只想临时预览发布效果可以在title
标题添加WIP:
或wip:
前缀,乐乎在生成文章列表时会自动跳过有WIP:
前缀的文章,但仍然会为该文章生成对应的 HTML 文件。作者可以根据文章路径预览效果。完稿后不需要修改文章路径,去掉WIP:
前缀就可以了。
如果要插入图片,则需要把对应图片保存到同步目录,也可以创建各种层级的文件夹来保存图片,引用图片使用对应的相对路径即可。
请务必认真构思文章第一段内容。乐乎会提取第一段用作文章的内容摘要,并将其写入 description meta 字段,供搜索引擎使用。乐乎还会将第一段写入 ATOM 摘要字段。所以请务必认真构思首段内容。
文件保存后就可以打开网站查看展示效果了,就是这么简单。
更多 Markdown 语法请参考这篇文章。
如果你不满意默认的样式,也可以自己动手装修。
考虑到用户的评论很少且需要对外展示的更少,乐乎仅提供基础的留言功能。留言内容仅作者可见。如果作者觉得有必要公开,则可以追加到文章正文。这样可以杜绝引流等垃圾评论。具体设计和实现可以参考这篇文章。↩︎
建议同时开启 Google AdSense 和 Google Analytics。虽然很多人会用浏览器插件屏蔽广告和数据上报,但还是有可观的用户允许展示和上报。这有助于谷歌判定网站的内容质量,从而提高网站在搜索结果里的排名。AdSense 开户可以参考这篇文章。但谷歌会审查网站的质量,只有积累一定数量的内容才能开通。↩︎
https://garrettgman.github.io/rmarkdown/authoring_pandoc_markdown.html↩︎