FOW - Focus On Writing

快速入门

第一步：使用npm安装fow并更新。

npm install fow -g

第二步：创建静态博客。

fow init myblog
cd myblog
fow build
fow serve

第三步：访问http://localhost:8090/。

Fow简介

NodeJS编写，飞快生成静态博客，绿色无污染
使用GitHub Flavored Markdown、YAML写文章、配置博客
基于目录生成静态博客，这一点和市面上的生成器不太一样哦
可以部署到GitHub
自带代码高亮、LaTeX数学公式、Disqus、FontAwesome图标字体
支持扩展插件
支持RSS
支持自定义主题
支持自定义页面

命令行

fow [i/init] [DIR_NAME] 创建博客
fow [n/new] [ARTICLE_ID] 创建一篇文章，ARTICLE_ID是CATEGORY_NAME/ARTICLE_NAME这样的格式，比如当前文章的ARTICLE_ID是fow/quickstart
fow [b/build] 构建静态资源，默认情况下只构建修改后的ARTICLE_ID，可以加--force参数强制构建所有
fow [s/serve] [PORT] 开启本地服务器，默认端口为8090，可以访问http://localhost:8090/预览博客
fow [h/help] 显示帮助信息

在任意fow目录的层次中，均可以使用fow命令（init命令除外）。 ARTICLE_ID说明：ARTICLE_ID是固定的，即目录名+斜线+文章名。

写文章

执行fow new ARTICLE_ID创建的文章，对应于drafts/categories/ARTICLE_ID.md文件。

可以使用GitHub Flavored Markdown写文章。

摘要

我是摘要

<!--more-->

继续写文章

前面的内容将被作为摘要，就目前而言，摘要与其它内容的不同之处仅仅是样式不同。

图片

图片默认放在文章所在目录的images文件夹内，示例![](xiyangyang.jpg)。

公式

${\widehat{C_i}} = C_i + \Phi(i) - \Phi(i-1)$ 将会转换为以下公式。

${\widehat{C_i}} = C_i + \Phi(i) - \Phi(i-1)$

可以使用在线公式编辑器来辅助生成LaTeX代码。

代码

```python
    if __name__ == '__main__':
        print 'Fow!'
```

转换后的代码如下。

    if __name__ == '__main__':
        print 'Fow!'

元数据

元数据文件drafts/meta.yml是整个博客是索引，非常重要，示例如下。

- id: howto/helloworld
title: helloworld
category: howto
tags:
  - others
create_time: 2015-02-18 14:45:52
update_time: 2015-02-17 09:07:55

其中，id不建议修改，fow会自动管理。建议修改title、category、tags、create_time、update_time，如下。

- id: howto/helloworld
title: 这是helloworld
category: 使用说明
tags:
  - fow
  - nodejs
  - 使用说明
create_time: 2015-02-18 14:45:52
update_time: 2015-02-17 09:07:55

博客配置

修改config.yml可以定制自己的博客，参数说明如下。

title 会显示在浏览器的标签页上
subtitle 会显示在个人头像的下方
meta html中相应的meta信息
profile avatar为个人头像，duoshuo为多说评论的id
navigation 定制设置导航条，比如新加了一个自定义页面
site 生成博客需要的一些基本信息，可以在此自定义博客的主题，博客的banner

自定义页面

如果想新加一个页面，比如about（关于）的页面，可以在drafts文件夹中添加文件about.md，然后设置config.yml的navigation参数。

博客主题

可以在themes文件夹中添加自定义的主题，然后设置config.yml的theme参数。

默认主题为themes/default，修改自Oishi。

博客插件

插件放置于plugins文件夹，目前有2个文件，plugins/header_plugin.ejs、plugins/footer_plugin.ejs，分别进行html的头部注入和尾部注入。

贡献

期待你的贡献！

Fow 核心代码
Fow Custom 定制（包括布局、主题、插件）

感谢

Fow的开发离不开以下项目：

License

MIT

zhangxiaoyang / fow