开始创作

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

基础配置

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

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

• site_title 网站名称，比如「乐乎」
• site_url 网站域名，比如 https://lehu.in，末尾不带斜杠
• author_name 作者名字，会显示在博客标题下面和 ATOM 文件
• author_email 作者邮箱，会显示在 ATOM 文件
• author_url 作者首页，默认是/about.html

用户留言¹会通过电子邮件发送到author_email。

如果想开启 Google AdSense 和 Google analytics，则需要提供以下信息²：

• ga_id Google AdSense 识别码
• gt_id Google Analytics 识别码

开始创作

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

你可以使用喜欢的编辑器创作 Markdown 文件。所有的 Markdown 需要设置 Front Matter 变量，至少指定 title 和 date 两个变量。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.html和vim/index.html，访问https://domain/vim/也会看到一个文章列表，但仅包含当前目录下的文章。

如果只想临时预览发布效果，可以在文件名（不是title变量）中加入draft-前缀。最新推荐的办法是在title标题添加WIP:前缀，这样完稿后不需要修改文章路径。乐乎在生成文章列表的时候会自动跳过，但会生成文章对应的 HTML 文件。

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

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

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

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

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