Hexo on 七三的小站

Hexo 使用 Isso 评论系统

Sat, 01 Jul 2017 00:00:00 +0800

一、Isso 服务端

1.1 自定义配置文件

下面选项需要修改，更多解释请参考官方文档 Server Configuration

host 是你引用 Isso 的 JS 的网站地址，需要写全。
smtp 发送评论到你邮箱以及审核评论

vim /opt/isso/config/isso.conf

[general]
dbpath = /db/comments.db
host = https://www.wangyan.cloud/
max-age = 1d
notify = smtp

[moderation]
enabled = false
purge-after = 30d

[server]
listen = http://0.0.0.0:8080/

[smtp]
username = noreply@wangyan.org
password = xxxx
host = smtp.exmail.qq.com
port = 25
security = none
to = service@wangyan.org
from = "WangYan BLog" <noreply@wangyan.org>
timeout = 10

[guard]
enabled = true
ratelimit = 5
direct-reply = 10
reply-to-self = false
require-author = true
require-email = true

[markup]
options = strikethrough, superscript, autolink
allowed-elements = img
allowed-attributes = src

1.2 docker-compose.yml

vim /opt/isso/docker-compose.yml

isso:
    image: wonderfall/isso
    container_name: isso
    environment:
        - GID=1000
        - UID=1000
    ports:
        - "8080:8080"
    volumes:
        - /opt/isso/config:/config
        - /opt/isso/db:/db
    restart: always

最后运行 docker-compose up -d 就 OK 了。

二、Nginx 配置（选做）

为了网址好看些，比如说 isso.wangyan.org 还需要配置 Nginx

server {
    listen 80;
    server_name isso.wangyan.org;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header   Host    $host;
        proxy_set_header   X-Real-IP   $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto https;
    }
}

server {
    listen 443 ssl http2;
    server_name isso.wangyan.org;

    ssl on;
    ssl_certificate  /etc/nginx/ssl/isso.wangyan.org.pem;
    ssl_certificate_key /etc/nginx/ssl/isso.wangyan.org.key;
    ssl_session_timeout 5m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
    ssl_prefer_server_ciphers on;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header   Host    $host;
        proxy_set_header   X-Real-IP   $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto https;
    }
}

三、客户端引入 Isso

3.1 一般设置

在页面的适当位置放下面一段代码

<script data-isso="https://www.wangyan.cloud/"
        data-isso-css="true"
        data-isso-reply-to-self="false"
        data-isso-require-author="true"
        data-isso-require-email="true"
        data-isso-max-comments-top="100"
        data-isso-max-comments-nested="5"
        data-isso-reveal-on-click="10"
        data-isso-avatar="true"
        data-isso-avatar-bg="#f0f0f0"
        data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
        data-isso-vote="false"
        src="https://www.wangyan.cloud/js/embed.min.js"></script>

<section id="isso-thread"></section>

3.2 Hexo 设置

如果是 hexo 可以这样（不同主题放置方法不一样）

编辑主题配置文件 _config.yml

isso_url: //isso.wangyan.org/

编辑 layout/_partial/component/comments.ejs 加入一行

 <%- partial('isso') %>

最后引入 isso.ejs

/* layout/_partial/component/isso.ejs */

<% if (theme.isso_url){ %>
<script data-isso="<%= theme.isso_url %>"
        data-isso-css="true"
        data-isso-reply-to-self="false"
        data-isso-require-author="true"
        data-isso-require-email="true"
        data-isso-max-comments-top="100"
        data-isso-max-comments-nested="5"
        data-isso-reveal-on-click="10"
        data-isso-avatar="true"
        data-isso-avatar-bg="#f0f0f0"
        data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
        data-isso-vote="false"
        src="<%= theme.isso_url %>js/embed.min.js"></script>

<section id="isso-thread"></section>
<% } %>

参考文档：

Hexo 一键安装自动部署

Sun, 04 Sep 2016 00:00:00 +0800

一、写作流程

首先在Github或者GitLab上编辑文章（或者本地git push)
然后会触发webhook，自动将git上的md文件拉取到 /opt/hexo/source/_posts 文件夹
接着自动执行hexo g操作，生成静态文件。
最后通过网址访问，结束。

二、安装 Docker

关于Docker 更多信息，请访问其官网。https://docs.docker.com

debian

apt-get update && \
apt-get -y install curl && \
curl -fsSL https://get.daocloud.io/docker | sh \
update-rc.d -f docker defaults && \
service docker start

CentOS

yum update && \
curl -fsSL https://get.docker.com/ | sh && \
systemctl enable docker.service && \
systemctl start docker.service

三、安装 Hexo

IP_OR_DOMAIN 服务器IP或者域名
GITHUB github自动发布地址（Gitlab 请使用 -e GITLAB=http://xxx）
WEBHOOK_SECRET github webhook 密钥（GitLab 不支持该选项）
APT_MIRRORS 使用国内软件源

国内主机可将 idiswy/hexo:latest 换成 docker.wangyan.org/root/docker-hexo:latest 国内主机可用 -e APT_MIRRORS=aliyun 选项，使用国内的镜像源。

docker run --name hexo \
-v /opt/hexo:/opt/hexo \
-p 80:80 \
-e IP_OR_DOMAIN=wangyan.org \
-e GITHUB=https://github.com/wangyan/test.git \
-e WEBHOOK_SECRET=123456 \
-e APT_MIRRORS=aliyun \
-d idiswy/hexo:latest

安装可能需要30秒左右，通过下面方法查看安装进度。

docker logs -f hexo //查看安装进度

四、配置 webhook

注意将youdomain替换成你的网站域名，secret密钥可以随便设置

五、Hexo 常用命令

5.1 安装Hexo

npm install hexo -g #全局安装hexo
npm update hexo -g #升级hexo
hexo init #初始化,新建一个网站

5.2 启动服务器

hexo server # 启动web服务器（默认端口4000，'ctrl + c'关闭）
hexo server -s #静态模式
hexo server -p 5000 #启动时，自定义端口
hexo server -i 192.168.1.1 #启动时，自定义 IP

5.3 写作

new命令

hexo new [layout] <title> #新建
# layout对应三种布局：post、page、draft，默认为post

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo new draft "draftName" #新建草稿

自定义文章信息

---
title: 文章标题
layout: post （可选）
date: 2016-01-01 00:00
comments: true（可选）
categories: 技术札记（可选）
tag:  标签（可选）
- tag1
- tag2
keywords: 关键词（可选）
description:描述（可选）
---

####设置文章摘要

以上是文章摘要 


以下是余下全文

5.4 生成静态文件

hexo generate #生成静态页面至public目录
hexo generate --watch #生成静态页面，同时监视文件变动

5.5 部署（选做）

hexo deploy #部署到远程服务器
hexo generate --deploy #生成静态页面后自动部署

5.6 常用简写

hexo n "hello world" == hexo new "hello" #新建文章hello world
hexo p == hexo publish #将草稿发布为这正式文章
hexo g == hexo generate #生成静态文件
hexo s == hexo server #启动服务器
hexo d == hexo deploy #部署

了解更多Hexo命令：https://hexo.io/zh-cn/docs/commands.html

六、了解更多

关于Hexo更多信息，请访问其官网。https://hexo.io

更多使用帮助请阅读wiki，其他问题欢迎在issues中反馈。