README.cn.md

JoeJoeyMa Themes

An attractive, exquisite theme for Hexo. named "JoeJoeMa"

☞ 在线预览 | [问题交流]

以上Demo站点的源文件在这里，大家有需要的可以参考：http://joejoey.tk/categories/

安装步骤

1. 从GitHub上获取代码

 $ git clone https://github.com/JoeJoeyMa/hexo-theme-JoeJoeyMa.git themes/JoeJoeyMa

2. 启用

把Hexo主目录下的 _config.yml 文件中的字段 theme 修改为 JoeJoeyMa.

# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: JoeJoeyMa

3. 更新

 $ cd themes/JoeJoeyMa
 $ git pull

特性

自定义首页背景

您可以将选择的大图放到 YOUR_HEXO_SITE\themes\JoeJoeyMa\source\css\images 文件夹下. 然后更改 JoeJoeyMa/_config.yml文件里的home_background_image字段.

# Homepage
# eg. home_background_image: [css/images/home-bg.jpg, http://t.cn/RMbvEza]
# eg. mode: image | polyline | trianglify
home_background_image:
  enable: true
  mode: image
  rolling: true
  url: [css/images/home-bg.jpg, css/images/sample.jpg, https://source.unsplash.com/collection/954550/1920x1080]

首页背景填充方式有三种可选mode：

• image: 大图模式
• trianglify: 多边形渐变背景
• polyline: 随机彩色折线

默认配置为image模式，也就是大图模式。多边形渐变背景polyline模式来自Trianglify大致如下图：

如果你不中意以上两种背景填充方式，可以选择随机彩色折线polyline模式，长相参考下图。

！！注意：如果在使用image模式时url为空（enable仍然保持true）, 主题也会自动使用下面这种**漂亮的随机线条 **填充（也就是会自动退化为polyline模式）：

Code 色彩主题

JoeJoeyMa 使用Tomorrow Theme 作为代码高亮的配色. 总共有六种选择: default, normal, night, night blue, night bright, night eighties

默认高亮配色如上图。 另外的五种配色如下.

Modify highlight_theme in JoeJoeyMa/_config.yml.

# Code Highlight theme
# Available value:
#    default | normal | night | night eighties | night blue | night bright
# https://github.com/chriskempson/tomorrow-theme
highlight_theme: default

博客主题色

为你的博客提供了五种可选的主题色，可以配置成random, 每次生成博客时会自动随机使用一个主题色.

• orange
• blue
• red
• green
• black

You can modify theme_color in JoeJoeyMa/_config.yml.

# Article theme color
# Available value:
#    random | orange | blue | red | green | black
theme_color: random

夜间模式

只有在文章阅读页面，点击左上角的logo图片，就能打开设置对话框，操作如下图

站内搜索

使用 Insight Search 实现了站内搜索，在_config.yml文件中启用如下.

# Search
search:
    insight: true # you need to install `hexo-generator-json-content` before using Insight Search
    swiftype: # enter swiftype install key here
    baidu: false # you need to disable other search engines to use Baidu search, options: true, false

！注意: 在使用搜索功能前必须在Hexo目录下使用以下命令安装 hexo-generator-json-content 插件.

$ npm install -S hexo-generator-json-content

Fancybox

使用Fancybox来浏览展示您文章中的图片，支持以下方式在文章中添加图片：

![img caption](img url)
{% fancybox img_url [img_thumbnail] [img_caption] %}

侧边栏

sidebar（侧边栏位置）可以设置为 left , right, bottom.

有以下5种侧边栏插件:

• category
• tag
• tagcloud
• archives
• recent_posts

All of them are enabled by default. You can edit them in widget setting.

打赏捐赠按钮

每篇文章最后显示打赏按钮，目前仅支持微信支付和支付宝两种打赏方式。您可以在文件 JoeJoeyMa/_config.yml 中配置您的微信、支付宝付款二维码图片的URL:

# donation button
donate:
    enable: true
    message: '如果觉得我的文章对您有用，请随意打赏。您的支持将鼓励我继续创作!'
    wechatImage: https://your_WECHAT_PAY_ImageUrl
    alipayImage: https://your_ALIPAY_ImageUrl

评论

已完全支持原生Disqus、livere（来必力）、wumii（无觅）评论系统。因多说、网易云跟帖均已停止服务，在国内建议大家使用相对稳定的来必力评论系统。在文件 JoeJoeyMa/_config.yml 中修改以下代码片段:

# comment ShortName, you can choose only ONE to display.
gentie_productKey: #网易云跟帖your-gentie-product-key
duoshuo_shortname: 
disqus_shortname: 
livere_shortname: MTAyMC8yOTQ4MS82MDQ5
uyan_uid: 
wumii: 

• 网易云跟帖说明（已停止服务）

登陆 网易云跟帖 获取你的 Product Key。请注意，您在**云跟帖管理后台设置的域名必须跟您站点的域名一致**。在本地测试时，需要做两步骤前置设定：

1. 修改 hosts 文件，将您域名的请求指向本地。例如：127.0.0.1 yoursite.com
2. 修改 Hexo 监听的端口为 80：hexo s --debug -p 80

测试完成后请将 hosts 文件中的域名映射删除即可。

Comment support (add new Gitment)

JoeJoeyMa has native support for DuoShuo & Disqus comment systems. Modify the following snippets to JoeJoeyMa JoeJoeyMa/_config.yml:

# comment ShortName, you can choose only ONE to display.
gentie_productKey: #your-gentie-product-key
duoshuo_shortname: 
disqus_shortname: 
livere_shortname: MTAyMC8yOTQ4MS82MDQ5
uyan_uid: 
wumii: 

https://github.com/settings/applications/new

支持的浏览器

Contributing

欢迎大家有各种问题和改进建议的，直接提issue或者评论，或者pull request都行。我会尽量抽时间和大家交流。刚接触Hexo不久，疏忽不足之处，还望大家海涵！