eeb

Elixir Extendable Blog, http://eeb.popkit.org/. English native user, pls ref [English Version README](./posts/Getting Started.md). eeb是elixir语言版本的博客平台，它由两部分组成：

静态博客生成器；
webserver。

当前开发版本

v0.2.1-dev

安装eeb

注意：安装和运行eeb需要elixir(1.2以上版本)语言环境，安装elixir见官方的安装说明。 eeb的安装有以下两种方式：

通过hex依赖安装

1. 采用mix命令创建一个空项目

mix new eeb_blog
cd eeb_blog

2. 修改项目的mix.exs文件，添加对eeb的依赖，同时加载eeb模块

def application do
  [applications: [:logger,:eeb]]
end
  
defp deps do
  [{:eeb, "~> 0.2.0"}]
end

3. 然后安装依赖到本地，最后部署eeb博客

mix deps.get
mix eeb.deploy

部署完成后会显示

eeb running in http://localhost:4000/

这时，可通过浏览器访问http://localhost:4000/博客页面

通过eeb_new方式安装

1. 通过以下命令，安装eeb_new

mix archive.install https://github.com/aborn/eeb/raw/master/installer/archives/eeb_new.ez

2. 创建eeb博客

mix eeb.new eeb_blog
cd eeb_blog

3. 然后安装依赖到本地，最后部署eeb博客

mix deps.get
mix eeb.deploy

后台运行

通过screen命令，将eeb作为后台daemon，这样退出terminal后会在后台运行

screen mix eeb.deploy  # C-a d
# screen -ls
# screen -r id
# screen -X -S id quit #(Attached)

Github Webhooks

当你的博客文章放在自己github的某个项目里，这个功能就很有用。比如，你更新了博客或者添加了新博客这时想让eeb及时地更新博客文章，在github的项目配置里找到Webhooks的配置，添加如下Payload URL：

http://aborn.me/github.json?token=xxx

我的eeb博客部署在aborn.me这台服务器上，你把以上链接改成你自己部署的服务器链接：注意这里的token值xxx改成你自己通过mix eeb.config配置的值：

mix eeb.config webhook_token xxx

注意事项

1. 默认的markdown格式的文章目录为posts/ 改变这个目录，只需要执行 mix eeb.config blog_path "path/to/your/markdown/file/dir"，例如：

mix eeb.config blog_path "/Users/aborn/github/technotebook"

2. 生成的对应的.html静态文件目录为html/ 3. 图片从原来的.md文件对应目录或者其目录下的images目录拷贝到html/images目录 4. 博客文件名以"_"开头的，将被当作草稿博客，不做转换。

端口号配置

eeb采用cowboy默认端口号为：4000，想要改变默认端口号可以通过以下两种方式：

通过设置环境变量BLOG_PORT的值改变默认端口号

如下例中将端口号改为4001：

 export BLOG_PORT=4001

通过mix eeb.config命令配置默认端口号

如下例子中将端口号改为4002:

mix eeb.config blog_port 4002

注意：如果以上两种方式都设置了值，那以第一种为准!

多说评论

eeb可以添加多说评论插件，只要配置多说的short_name，如下：

mix eeb.config duoshuo_short_name your_duoshuo_short_name

对elixir语言的代码高亮支持

如下示例：

defmodule Eeb.DuoshuoPlug do

  @duoshuo_short_name_key :duoshuo_short_name
  import Eeb.ConfigUtils
  
  def duoshuo_short_name do
    read_key_value(@duoshuo_short_name_key, nil)
  end

  def is_use_duoshuo? do
    case duoshuo_short_name do
      nil ->
        :false
      _ ->
        :true
    end
  end
  
end