kelvin-luo

极简图像编辑工具 orchidimgediter功能介绍

Sun, 26 Jul 2026 00:00:00 +0000

极简图像编辑工具 - OrchidImgEditer功能介绍

一个轻量级、功能丰富的图像注释和编辑工具，为截图、标记、提取文字而生。

github主页：https://github.com/kelvin-luo/OrchidImgEditer.git

工具概述

OrchidImgEditergEditer 是一个基于 C++、Qt 6 和 OpenCV 5 开发的跨平台图像编辑应用。它提供了一套直观的图像标注、处理和 OCR 文字提取功能，特别适合需要快速处理、批注、识别图像内容的用户。

核心特性

✨ 开箱即用 — 一键启动，直观的图形界面
🎨 丰富的绘图工具 — 直线、矩形、圆形、箭头、自由铅笔等
🔤 OCR 文字识别 — 内置 Tesseract 引擎，支持中英文识别
✂️ 图像处理 — 裁剪、ROI 抠图、马赛克模糊
⚡ 流畅的交互 — 实时缩放、撤销、颜色选择器
💾 灵活的保存 — 支持多种格式导出

核心功能详解

1. 📐 绘图与标注工具

工具	功能	使用场景
直线	画直线	连接关键点、标记方向
矩形	画矩形框	突出重点区域、创建边框
圆形	画圆形	圆形高亮、创建标记
箭头	带箭头的直线	指示方向、流程标记
铅笔	自由手绘	手写注释、随意涂鸦
文字	添加文本标签	注解、标题、说明文字

使用方式：

工具栏中选择工具
在图像上点击或拖拽绘制
支持实时调整线宽、颜色
按 Ctrl+Z 撤销最后操作

2. 🔍 OCR 文字识别

OrchidImgEditergEditer 集成了 Tesseract 5.4 OCR 引擎，可快速从图像中提取文字。

支持语言：

✅ 简体中文
✅ 英文
✅ 其他 120+ 种语言（通过扩展语言包）

使用流程：

在工具栏选择 OCR 工具
在图像上拖拽选择包含文字的矩形区域
识别结果自动复制到剪贴板（可选）
在程序中查看或编辑识别结果

应用场景：

截图上的文字快速提取
证件信息识别
表单数据录入
多语言文档扫描

3. ✂️ 图像裁剪与处理

裁剪工具 (Crop)

选择矩形区域后自动裁剪
保留裁剪后的图像
支持多次独立裁剪

ROI 抠图工具 (ROI Extract)

高级功能：通过指定上下左右的 Padding 值 进行精准抠图。

Padding 参数说明：

上: 顶部内缩距离（正数）或外扩（负数）
下: 底部内缩距离（正数）或外扩（负数）
左: 左侧内缩距离（正数）或外扩（负数）
右: 右侧内缩距离（正数）或外扩（负数）

示例：

Top=10, Bottom=10, Left=10, Right=10 → 原区域所有边向内缩小 10 像素
Top=-5, Bottom=-5, Left=-5, Right=-5 → 原区域所有边向外扩大 5 像素

马赛克工具 (Mosaic)

隐藏敏感区域
支持调整马赛克块大小
快速打码处理

4. 🎨 样式定制

在工具栏中实时调整：

参数	范围	说明
线宽	1-50	绘图线条粗细
马赛克大小	1-30	马赛克块大小
字体大小	8-72	文字标注大小
颜色	RGB	点击颜色按钮选择自定义颜色

5. 🖱️ 交互体验

视图缩放

鼠标滚轮 — 以鼠标位置为中心缩放
适应窗口 — 工具栏 Fit 按钮快速适应屏幕
实时显示 — 状态栏显示当前缩放比例

图像打开

拖拽打开 — 直接把图像文件拖到窗口打开
菜单打开 — File → Open
快捷键 — Ctrl+O

撤销与恢复

撤销 — Ctrl+Z 或工具栏 Undo 按钮
支持多步撤销

工作流程示例

场景：快速截图注释

1. 启动 OrchidImgEditergEditer
2. 拖拽一张截图到窗口（或使用 Ctrl+O 打开）
3. 在需要注意的地方：
   - 用 [矩形工具] 框出问题区域
   - 用 [箭头工具] 指示重点
   - 用 [文字工具] 添加说明
4. 用 [颜色选择器] 改变标记颜色（如改成红色更醒目）
5. Ctrl+S 保存为 PNG / JPG
6. 分享或发送

场景：从图像提取中文

打开图片（如扫描文档、证件照）
工具栏选择 [OCR 工具]
在包含文字的区域拖拽选择矩形
系统自动识别并显示文字
复制提取的文字到文档或编辑器

场景：敏感信息打码

打开包含敏感信息的截图
工具栏选择 [马赛克工具]
调整马赛克大小（如 10×10 像素块）
在敏感区域（如身份证号、手机号）拖拽涂盖
保存处理后的图像

系统需求

项目	要求
操作系统	Windows 10 / 11 或更新版本
处理器	任意现代 CPU（建议双核以上）
内存	最小 2GB，建议 4GB+
磁盘空间	100MB+ 自由空间
依赖	Visual C++ Redistributable

安装与使用

快速开始

直接使用编译版本（推荐新手）

下载发布包（包含预编译的 .exe）
解压到任意目录
运行 kImgEdit.exe
或者拖拽图像文件到窗口打开

常见问题 (FAQ)

Q1: 打开 OCR 工具后没有识别到文字？

A: 这通常是因为 Tesseract 语言包未正确加载。

解决方案：

首次使用请运行 setup_tesseract.bat 将 OCR 引擎打包到程序目录
确保程序可访问 ./tesseract/tessdata 目录中的语言文件
如果仍有问题，在菜单 Settings → Tesseract Status 查看当前使用的路径
也可手动指向系统已安装的 Tesseract（如 C:\Program Files\Tesseract-OCR）

Q2: 如何识别其他语言？

A: Tesseract 支持 120+ 种语言。

方式：

下载对应的 .traineddata 语言文件
放入 ./tesseract/tessdata 或系统 Tesseract 目录
重启程序即可使用

Q3: 支持哪些图像格式？

A: 支持常见格式：

输入：JPG, PNG, BMP, TIFF, WebP 等
输出：PNG（无损）、JPG（可控质量）

Q4: 编辑的图像可以撤销吗？

A: 支持撤销，但有限制：

按 Ctrl+Z 或工具栏 Undo 按钮逐步撤销
一次加载图像中最多保留 ~50 步撤销记录（具体数量取决于编辑复杂度）
关闭未保存的图像会丢失所有编辑

Q5: 程序可以移动或便携使用吗？

A: 完全可以！

所有相对路径都已相对于程序所在目录
直接移动整个文件夹到其他位置，程序照样运行
无需注册表写入，卸载直接删除即可

Q6: 如何批量处理图像？

A: 目前 OrchidImgEditer主要针对单个图像的精细编辑。如需批量处理，可考虑：

通过脚本循环调用（传入参数）
或使用 OpenCV 编写自定义批处理脚本

获取帮助

📖 在线文档：[项目主页]
🐛 提交 Bug：通过 GitHub Issues
💬 讨论与建议：GitHub Discussions
📧 联系开发者：342247588@qq.com

更新日志

v1.0（当前版本）

✅ 基础绘图工具集（直线、矩形、圆形、箭头、铅笔）
✅ 内置 Tesseract OCR 中英文识别
✅ 图像裁剪与 ROI 抠图
✅ 马赛克模糊工具
✅ 撤销功能
✅ 拖拽打开图像
✅ 实时缩放与交互

计划中的功能

🔮 高级滤镜（模糊、锐化、色温调整等）
🔮 图层支持（多图层编辑）
🔮 批量处理 API
🔮 插件系统
🔮 暗黑主题支持

鸣谢

感谢以下开源项目与社区的支持：

Qt Framework
OpenCV
Tesseract OCR
所有贡献者与使用者

简介到此结束。祝您使用愉快！ 🎨✨

有任何问题或建议，欢迎在知乎评论区讨论！

博客模板功能介绍

Sat, 11 Jul 2020 00:00:00 +0000

在此之前我有写过一篇如何使用我博客模板的文章请先看这篇基础集成，这篇文章主要讲的是如何使用和修改我的博客主题，文章内容含以下几点：

博客特性

博客主要模块介绍

_config.yml

_config.yml 是博客的配置文件，整个站点的信息都在这修改，想要把我的模板改成你自己的也需要修改_config.yml

重要字段说明

enableToc: 是否开启文章自动生成目录，设置为false文章不会自动生成目录
comment/livere: livere评论系统，支持微信、qq、微博、豆瓣、twitter等登录后可以直接评论
comment/disqus: disqus评论系统，支持facebook、twitter等登录后可以直接评论
social/weibo、github、zhihu、jianshu等: 个人站底部展示的微博等三方社交按钮，点击后直接跳转到个人微博或其他社交主页
baidu/id: 百度统计，用来统计你个人站点的用户访问情况
ga/id: google统计，用来统计你个人站点的用户访问情况

_config.yml 文件除以上字段还有一些可以自行修改，例如title之类的字段

_posts

_posts 目录是用来存放文章的目录，写新文章，直接放在这个目录即可

使用博客模板时，请把博客自带的文章给去掉，如果想使用博客自带的文章请 注明出处。

自定义页面

about.md、support.md 等为自定义页面，如果你想添加自动以页面可以直接复制about.md 文件修改文件名和里面的内容即可。

如果需要在导航显示你新增的页面，直接在_config.yml 文件的nav字段中添加你新页面配置即可

修改说明

如果要修改博客模板信息建议只修改_config.yml 文件内容和 _posts 里面的文章信息。因为博客模板一直在更新迭代，改动多了以免你后期更新博客模板的时候不方便。

如果你想改动模板的样式又想继续更新迭代博客模板，你可以提交在github上提交pull request 或者直接给我发邮件建议改成什么样，如果你的提议确实可以，我会采纳的，并且非常感谢你的建议。

博客迭代信息请看ReleaseNode

遇到解决不了的问题可以找技术支持

博客迭代记录

Fri, 10 Jul 2020 00:00:00 +0000

介绍

本博客首发时间为2015年，至今已经5个年头了。

感觉之前更新迭代的有点乱，很多用户在使用的时候也没法确定是否要更新新版的博客，再次我专门用一篇文章来记录博客更新迭代的记录，如果你已经在使用我的博客模板的，你可以看看更新记录后确认下是否要更新。

博客的全功能介绍请看博客功能介绍

1.0.0

2016-11-25 第一版发布，红色主题

2.0.0 开发中

2016-11-25 修改博客风格为淡蓝色主题
2016-12-16 增长404、about等页面
2017-1-12 增加代码高亮
2017-3-19 增加打赏公共
2017-9-8 多说评论系统停服，切换到disqus评论（多说上的评论全没了😭）
2019-1-25 增加博客底部社交链接
2020-7-8 博客域名从 http://baixin.io 迁移到 http://leopardpan.cn （baixin.io没法备案之前的统计也全没了😭）.
2020-7-13 增加文章自动生成目录功能, 增加livere评论系统

博客更新手册

如果你已经在使我的博客模板了，现在又想继续更新新版的博客，你下载博客后只需要修改两个各方

_config.yml 文件
_posts 目录

_config.yml 文件里面的内容设置成你自己的，也可以用你原来的，最好是更新版的字段做一下对比。

_posts 目录里面的文章全部删掉，把你自己的文章放进来

修改以上两个地方新版的博客便更新完成，快看看效果吧！

文档支持的Markdown语法

Sun, 20 Nov 2016 00:00:00 +0000

什么是 Markdown

Markdown 是一种方便记忆、书写的纯文本标记语言，用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档：如您正在阅读的这篇文章。它使用简单的符号标记不同的标题，分割不同的段落，粗体或者斜体某些文字.

很多产品的文档也是用markdown编写的，并且以“README.MD”的文件名保存在软件的目录下面。　　

一些基本语法

标题
H1 :# Header 1
H2 :## Header 2
H3 :### Header 3
H4 :#### Header 4
H5 :##### Header 5
H6 :###### Header 6
链接 :Title
加粗 :Bold
斜体字 :Italics
*删除线 :~~text~~
内嵌代码 : alert('Hello World');

列表

列表1
列表2
列表3

列表引用

列表1

列表2

列表3

插入一张图片

打赏一个吧

css 的大部分语法同样可以在 markdown 上使用，但不同的渲染器渲染出来的 markdown 内容样式也不一样，下面这些链接里面有 markdown 基本语法，你也可以在下面几个平台上尝试着写一些。

博客支持的高级语法

1. 制作一份待办事宜

支持以 PDF 格式导出文稿
改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
新增 Todo 列表功能
修复图标功能

2. 高亮一段代码

@requires_authorization
class SomeClass:
    pass

if __name__ == '__main__':
    # A comment
    print 'hello world'

3. 绘制表格

项目	价格	数量
计算机	$1600	5
手机	$12	12
管线	$1	234

Jekyll搭建个人博客

Fri, 14 Oct 2016 00:00:00 +0000

　之前写了一篇HEXO搭建个人博客的教程获得了很好评，尤其是在简书上目前已经累积了10W+的阅读量了，也有好心的读者主动给我打赏，在此感谢。

　如果你看过我的文章会发现我现在的博客样式跟之前是有很大的区别的，之前我也是使用 HEXO 搭建的博客，后来发现使用 HEXO 在多台电脑上发布博客，操作起来并不是那么方便，果断就转到了 Jekyll 上，接下来我会讲如何使用 Jekyll 搭建博客，博客模板效果。

介绍

　Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过 Markdown （或者 Textile）以及 Liquid 转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上，也就是说，你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站，而且是完全免费的

　使用 Jekyll 搭建博客之前要确认下本机环境，Git 环境（用于部署到远端）、Ruby 环境（Jekyll 是基于 Ruby 开发的）、包管理器 RubyGems
　　如果你是 Mac 用户，你就需要安装 Xcode 和 Command-Line Tools了。下载方式 Preferences → Downloads → Components。

　　Jekyll 是一个免费的简单静态网页生成工具，可以配合第三方服务例如： Disqus（评论）、多说(评论) 以及分享等等扩展功能，Jekyll 可以直接部署在 Github（国外）或 Coding（国内）上，可以绑定自己的域名。Jekyll中文文档、Jekyll英文文档、Jekyll主题列表。

Jekyll 环境配置

安装 jekyll

$ gem install jekyll

创建博客

$ jekyll new myBlog

进入博客目录

$ cd myBlog

启动本地服务

$ jekyll serve

在浏览器里输入： http://localhost:4000，就可以看到你的博客效果了。

so easy !

目录结构

　　Jekyll 的核心其实是一个文本转换引擎。它的概念其实就是：你用你最喜欢的标记语言来写文章，可以是 Markdown，也可以是 Textile,或者就是简单的 HTML, 然后 Jekyll 就会帮你套入一个或一系列的布局中。在整个过程中你可以设置URL路径, 你的文本在布局中的显示样式等等。这些都可以通过纯文本编辑来实现，最终生成的静态页面就是你的成品了。

一个基本的 Jekyll 网站的目录结构一般是像这样的：

.
├── _config.yml
├── _includes
|   ├── footer.html
|   └── header.html
├── _layouts
|   ├── default.html
|   ├── post.html
|   └── page.html
├── _posts
|   └── 2016-10-08-welcome-to-jekyll.markdown
├── _sass
|   ├── _base.scss
|   ├── _layout.scss
|   └── _syntax-highlighting.scss
├── about.md
├── css
|   └── main.scss
├── feed.xml
└── index.html

这些目录结构以及具体的作用可以参考官网文档

进入 _config.yml 里面，修改成你想看到的信息，重新 jekyll server ，刷新浏览器就可以看到你刚刚修改的信息了。

到此，博客初步搭建算是完成了，

博客部署到远端

　我这里讲的是部署到 Github Page 创建一个 github 账号，然后创建一个跟你账户名一样的仓库，如我的 github 账户名叫 leopardpan，我的 github 仓库名就叫 leopardpan.github.io，创建好了之后，把刚才建立的 myBlog 项目 push 到 username.github.io仓库里去（username指的是你的github用户名），检查你远端仓库已经跟你本地 myBlog 同步了，然后你在浏览器里输入 username.github.io ，就可以访问你的博客了。

编写文章

　　所有的文章都是 _posts 目录下面，文章格式为 mardown 格式，文章文件名可以是 .mardown 或者 .md。

　　编写一篇新文章很简单，你可以直接从 _posts/ 目录下复制一份出来 2016-10-16-welcome-to-jekyll副本.markdown ，修改名字为 2016-10-16-article1.markdown ，注意：文章名的格式前面必须为 2016-10-16- ，日期可以修改，但必须为年-月-日- 格式，后面的 article1 是整个文章的连接 URL，如果文章名为中文，那么文章的连接URL就会变成这样的：http://leopardpan.cn/2015/08/%E6%90%AD%E5/ ，所以建议文章名最好是英文的或者阿拉伯数字。双击 2016-10-16-article1.markdown 打开

---
layout: post
title:  "Welcome to Jekyll!"
date:   2016-10-16 11:29:08 +0800
categories: jekyll update
---

正文...

title: 显示的文章名，如：title: 我的第一篇文章
date: 显示的文章发布日期，如：date: 2016-10-16
categories: tag标签的分类，如：categories: 随笔

注意：文章头部格式必须为上面的，…. 就是文章的正文内容。

我写文章使用的是 Sublime Text2 编辑器，如果你对 markdown 语法不熟悉的话，可以看看作业部落的教程

使用我的博客模板

虽然博客部署完成了，你会发现博客太简单不是你想要的，如果你喜欢我的模板的话，可以使用我的模板。

首先你要获取的我博客，Github项目地址，你可以直接点击下载博客，进去leopardpan.github.io/ 目录下，使用命令部署本地服务

$ jekyll server

如果你本机没配置过任何jekyll的环境，可能会报错

/Users/xxxxxxxx/.rvm/rubies/ruby-2.2.2/lib/ruby/site_ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in `require': cannot load such file -- bundler (LoadError)
	from /Users/xxxxxxxx/.rvm/rubies/ruby-2.2.2/lib/ruby/site_ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in `require'
	from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/gems/jekyll-3.3.0/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
	from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/gems/jekyll-3.3.0/exe/jekyll:9:in `<top (required)>'
	from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/jekyll:23:in `load'
	from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/jekyll:23:in `<main>'
	from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/ruby_executable_hooks:15:in `eval'
	from /Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/ruby_executable_hooks:15:in `<main>'

原因：没有安装 bundler ，执行安装 bundler 命令


$ gem install bundler

提示：

Fetching: bundler-1.13.5.gem (100%)
Successfully installed bundler-1.13.5
Parsing documentation for bundler-1.13.5
Installing ri documentation for bundler-1.13.5
Done installing documentation for bundler after 5 seconds
1 gem installed

再次执行 $ jekyll server ，提示

Could not find proper version of jekyll (3.1.1) in any of the sources
Run `bundle install` to install missing gems.

跟着提示运行命令

$ bundle install

这个时候你可能会发现 bundle install 运行卡主不动了。

如果很长时间都没任何提示的话，你可以尝试修改 gem 的 source

$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***

http://ruby.taobao.org

再次执行命令 $ bundle install，发现开始有动静了

Fetching gem metadata from https://rubygems.org/...........
Fetching version metadata from https://rubygems.org/..
Fetching dependency metadata from https://rubygems.org/.
。。。
Installing jekyll-watch 1.3.1
Installing jekyll 3.1.1
Bundle complete! 3 Gemfile dependencies, 17 gems now installed.
Use `bundle show [gemname]` to see where a bundled gem is installed.

bundler安装完成，后再次启动本地服务

$ jekyll server

继续报错

Configuration file: /Users/tendcloud-Caroline/Desktop/leopardpan.github.io/_config.yml
  Dependency Error: Yikes! It looks like you don't have jekyll-sitemap or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- jekyll-sitemap' If you run into trouble, you can find helpful resources at http://jekyllrb.com/help/! 
jekyll 3.1.1 | Error:  jekyll-sitemap

表示当前的 jekyll 版本是 3.1.1 ，无法使用 jekyll-sitemap

解决方法有两个

1、打开当前目录下的 _config.yml 文件，把 gems: [jekyll-paginate,jekyll-sitemap] 换成 gems: [jekyll-paginate] ，也就是去掉jekyll-sitemap。

2、升级 jekyll 版本，我当前的是 jekyll 3.1.2 。

修改完成后保存配置，再次执行

$ jekyll server

提示

Configuration file: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github/_config.yml
            Source: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github
       Destination: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
                    done in 0.901 seconds.
 Auto-regeneration: enabled for '/Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github'
Configuration file: /Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/leopardpan.github.io-github/_config.yml
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

表示本地服务部署成功。

在浏览器输入 127.0.0.1:4000 ，就可以看到leopardpan.cn博客效果了。

修改成你自己的博客

如果你想使用我的模板请把 _posts/ 目录下的文章都去掉。

修改 _config.yml 文件里面的内容为你自己的。

然后使用 git push 到你自己的仓库里面去，检查你远端仓库，在浏览器输入 username.github.io 就会发现，你有一个漂亮的主题模板了。

为什么要是用 Jekyll

使用了 Jekyll 你会发现如果你想使用多台电脑发博客都很方便，只要把远端 github 仓库里的博客 clone 下来，写文章后再提交就可以了，Hexo 由于远端提交的是静态网页，所有无法直接写 Markdown 的文章。如果你想看 Hexo 搭建博客，可以看看我的另一篇HEXO搭建个人博客的教程。

如果你在搭建博客遇到问题，可以在原文博客的评论里给我提问。

后面会继续介绍，在我的博客基础上，如何修改成你自己喜欢的 Style，欢迎继续关注我博客的更新。

Q&A

问题：最近很多朋友使用我的模板报警告：The CNAME leopardpan.cn is already taken 解决：把CNAME里面的baixin.io修改成你自己的域名，如果你暂时没有域名，CNAME里面就什么都不用谢。（之前没人反馈过这个问题，应该是github page最近才最的限制。）

HEXO进阶

Sun, 12 Jun 2016 00:00:00 +0000

HEXO接近是最近有一些朋友提出的问题，然后我做了总结，如果你也在使用HEXO，不妨看看，应该会有些帮助。

1、博客部署样式出问题了怎么办？
2、电脑重装或者误删了本地博客怎么办？
3、想使用两台电脑写博客怎么办？
4、为何使用百度搜不到我的博客？

使用Jekyll解决前三个问题。

不得不说 Jekyll 确实可以解决我上面三个问题, 因为 Jekyll 是直接把Markdown格式的文章直接放在github仓库里的, 相当于直接用git来管理博客了, Github 官方也很推荐 Jekyll 。你可以先看下 Jekyll 搭建博客的voyagelab, github地址, 当然了这只是很普通的, Jekyll 也有很多主题可以选择的, 更详细的请看Jekyll中文文档、Jekyll英文文档、Jekyll主题列表。在 Jekyll 上逛了一个星期的我又回到了 Hexo , 发现目前 Jekyll 对主题和一些插件的支持相对 Hexo 来说, 没那么友好, 可能有一些其它的方法只是我没找到而已,关于 Jekyll 搭建博客就介绍到这, 如果有问题的话可以评论, 或者联系我。

使用Hexo解决上面前三个问题

是的, 我大Hexo同样可以解决上面三个问题, 那就是使用git。关于如何使用 Hexo 搭建博客请看我另一篇文章HEXO搭建个人博客, 如果搭建的过程中出现了问题, 我们可以交流交流。现在我假设你已经能基本使用 Hexo 了, 接下来就看看如何来管理博客。

使用git管理博客

Blog-Growing是我管理博客的仓库地址。结构大致是:

– Blog-Growing
　　|– .git
　　|– .gitignore
　　|– Hexo
　　　　| ..
　　　　| ..
　　　　| 整个博客的配置信息

你可以把我的的Blog-Growing clone下来, 看看一些基本配置是怎么配置的。需要提醒的是, 要把主题下的.git给删除掉 , 当然了你也可以使用 git submodule 来管理, 具体的管理方法我这里就不做多的介绍了, 想了解的话可以私信我。上面的过程基本做完后, 怎么来解决我开篇提的前三个问题了。

具体实现:

一：家里电脑使用博客
　　建立git远端仓库管理博客,并使用家里的电脑把本地博客的配置推送到远端仓库。
二：公司电脑使用博客
　　到了公司只需要执行sudo npm install -g hexo,然后cd到你的博客目录下,如我cd 到Hexo目录下, 然后执行 hexo server 就可以在本地预览博客了。
三：使用Git保存
　　修改好博客后记得先使用git来提交下, 即使下次把博客的样式修改坏了, 也可以使用 git reset --hard 来回退。如: 我cd 到 Blog-Growing 目录下使用git提交。
四：博客提交
　　1、修改好的博客使用 hexo d 展示到博客页上。
　　2、git push 整个本地博客。

提示: 在这里 git 仅仅只是用户做博客的版本管理的, 博客的样式修改、基本部署还是使用 hexo 来操作的。

让百度能搜索到你的博客

为什么要使用百度搜索？

　　有人可能会说作为一个开发人员, 你不会用 Google 啊。是的, Google是能搜到我们搭建在 Github Page 的博客, 会用Google 也是一个开发人员必备技能之一。但是, 我们生活在天朝, 所以百度还是总有会用到的时候, 或者是你想让更多的天朝人能搜到你。

为什么使用百度搜索不到 Github Page 上的博客？

有人联系过 Github Support 部门 , 给出大致的意思就是: 百度爬虫爬得太猛烈，已经对很多 Github 用户造成了问题。所以 Github 将禁止百度爬虫的爬取。

如何让百度能搜索你的博客?

　　根据上面说的, 目前发现只是Github Page禁止了百度搜索, 所以让百度能搜索到你的博客还是有一些方法的。例如:

自己搞个VPS,博客部署在VPS上。
博客部署 Coding.net 上, GitCafe已经合并到 Coding 。我使用的是第二种方法, 博客部署在 Coding.net 上也相对简单些。

在Coding上部署你的博客。

　　Coding同样支持Hexo、Jekyll等博客的部署, Coding 跟Github还是挺像的,而且是中文。同样的在Coding里面建一个项目,项目名字跟你的用户名一样,这里我就不啰嗦了, 说几个需要注意的地方:
注意一:
　　在Coding Page 上部署博客,需要把博客推送到coding-pages 分支上, 分支名字是固定的。
注意二:
　　Coding Page 不支持自定义CNAME, 你需要点击到Page模块,然后添加一个域名来绑定。

更详细的请看Coding Pages 官网介绍.

参考文章: 解决 Github Pages 禁止百度爬虫的方法与可行性分析

转载请注明：潘柏信的博客 » 点击阅读原文

HEXO搭建个人博客

Tue, 25 Aug 2015 00:00:00 +0000

　　经过各种找资料，踩过各种坑，终于使用 hexo 搭建个人博客初步完成了，域名目前用得时 github 的，我的 hexo 是 3.1.1 版本，hexo 不同的版本，很多配置都不一样。好吧，废话不多说了，开始吧。

　　本篇文章累计了大量评论，和我的一些解答，读者有什么问题可以先看看评论，或者搜下关键字，如果还是有问题可以给我在评论里给我留言，问题很着急的可以加我ＱＱ：1499065178　，或者给我发邮件：leopardpan@icloud.com ，都可以，如果你已经搭建完成了，可以看看我的另一篇博客HEXO进阶，有讲如何能百度搜索你的博客、多台电脑使用HEXO发布博客等。我现在的博客是使用 Jekyll 搭建的，如果你想使用我现在的模板请看Jekyll搭建个人博客

背景

　这篇教程是针对与Mac的，参考链接，由于原文讲到的hexo是以前的老版本，所以现在的版本配置的时候会有些改动。

　之前是想着写博客，一方面是给自己做笔记，可以提升自己的写作、总结能力，一个技术点我们会使用，并不难，但是要做到让让别人也能听懂我们讲得，还是需要一定的技巧和经验的。很多类似于CSDN、博客园也都可以写文章，但是页面的样式我，不是太喜欢，简书还算好点得。最近看到一些大神们的博客（在我的友情链接里有），貌似都是用hexo写得，我也依葫芦画瓢的搭建了一个。不罗嗦了，直接上搭建步骤。

配置环境

安装Node（必须）

作用：用来生成静态页面的到Node.js官网下载相应平台的最新版本，一路安装即可。

安装Git（必须）

作用：把本地的hexo内容提交到github上去. 安装Xcode就自带有Git，我就不多说了。

申请GitHub（必须）

作用：是用来做博客的远程创库、域名、服务器之类的，怎么与本地hexo建立连接等下讲。 github账号我也不再啰嗦了,没有的话直接申请就行了，跟一般的注册账号差不多，SSH Keys，看你自己了，可以不配制，不配置的话以后每次对自己的博客有改动提交的时候就要手动输入账号密码，配置了就不需要了，怎么配置我就不多说了，网上有很多教程。

正式安装HEXO　

Node和Git都安装好后，可执行如下命令安装hexo：

$ sudo npm install -g hexo

初始化

创建一个文件夹，如：Blog，cd到Blog里执行hexo init的。命令：

hexo init

好啦，至此，全部安装工作已经完成！

生成静态页面

继续再Blog目录下执行如下命令，生成静态页面

hexo generate （hexo g  也可以）

本地启动

启动本地服务，进行文章预览调试，命令：

hexo server

浏览器输入http://localhost:4000 我不知道你们能不能，反正我不能，因为我还有环境没配置好

常见的HEXO配置错误：

ERROR Plugin load failed: hexo-server

原因： Besides, utilities are separated into a standalone module. hexo.util is not reachable anymore.

解决方法，执行命令：$ sudo npm install hexo-server

执行命令hexo server，提示：Usage: hexo<Command> ....

原因：我认为是没有生成本地服务

解决方法，执行命令：$ npm install hexo-server --save

提示：hexo-server@0.1.2 node_modules/hexo-server
.... 

表示成功了[参考](https://hexo.io/zh-cn/docs/server.html)

这个时候再执行：$ hexo-server

得到: INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

这个时候再点击http://0.0.0.0:4000，正常情况下应该是最原始的画面，但是我看到的是：白板和Cannot GET / 几个字原因：由于2.6以后就更新了，我们需要手动配置些东西，我们需要输入下面三行命令：

npm install hexo-renderer-ejs --save
npm install hexo-renderer-stylus --save
npm install hexo-renderer-marked --save

这个时候再重新生成静态文件，命令：

hexo generate （或hexo g）

启动本地服务器：

hexo server （或hexo s）

再点击网址http://0.0.0.0:4000 OK终于可以看到属于你自己的blog啦，?，虽然很简陋，但好歹有了一个属于自己的小窝了。参考链接，本地已经简单的设置好了，但是现在域名和服务器都是基于自己的电脑，接下来需要跟github进行关联。

配置Github

建立Repository

建立与你用户名对应的仓库，仓库名必须为【your_user_name.github.io】，固定写法然后建立关联，我的Blog在本地/Users/leopard/Blog，Blog是我之前建的东西也全在这里面，有：

Blog
　｜
　｜－－ _config.yml
　｜－－ node_modules
　｜－－ public
　｜－－ source
　｜－－ db.json
　｜－－ package.json
　｜－－ scaffolds
　｜－－ themes 　　　　　　　　

现在我们需要_config.yml文件，来建立关联，命令：

vim _config.yml

翻到最下面，改成我这样子的，注意： : 后面要有空格

deploy:
  type: git
  repository: https://github.com/leopardpan/leopardpan.github.io.git
  branch: master

执行如下命令才能使用git部署

npm install hexo-deployer-git --save

网上会有很多说法，有的type是github, 还有repository 最后面的后缀也不一样，是github.com.git，我也踩了很多坑，我现在的版本是hexo: 3.1.1，执行命令hexo -vsersion就出来了,貌似3.0后全部改成我上面这种格式了。忘了说了，我没用SSH Keys如果你用了SSH Keys的话直接在github里复制SSH的就行了，总共就两种协议，相信你懂的。然后，执行配置命令：

hexo deploy

　然后再浏览器中输入http://leopardpan.github.io/就行了，我的 github 的账户叫 leopardpan ,把这个改成你 github 的账户名就行了

部署步骤

每次部署的步骤，可按以下三步来进行。

hexo clean
hexo generate
hexo deploy

一些常用命令：

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #将.deploy目录部署到GitHub
hexo help  #查看帮助
hexo version  #查看Hexo的版本

这里有大量的主题列表使用方法里面都有详细的介绍，我就不多说了。
我这里有几款个人认为不错的主题，免去你们，一个一个的选了，欢迎吐槽我的审美，?
　Cover - A chic theme with facebook-like cover photo
　Oishi - A white theme based on Landscape plus and Writing.
　Sidebar - Another theme based on Light with a simple sidebar
　TKL - A responsive design theme for Hexo. 一个设计优雅的响应式主题
　Tinnypp - A clean, simple theme based on Tinny
　Writing - A small and simple hexo theme based on Light
　Yilia - Responsive and simple style 优雅简洁响应式主题，我用得就是这个。
　Pacman voidy - A theme with dynamic tagcloud and dynamic snow

博客目录介绍

　文章在 source/_posts，编辑器可以用 Sublime，支持 markdown 语法。如果想修改头像可以直接在主题的 _config.yml 文件里面修改，友情链接，之类的都在这里，修改名字在 public/index.html 里修改，开始打理你的博客吧，有什么问题或者建议，都可以提出来，我会继续完善的。

Markdown语法参考链接: 作业部落

Q&A

问：如何让文章想只显示一部分和一个 阅读全文 的按钮？
答：在文章中加一个  ，  后面的内容就不会显示出来了。

问：本地部署成功了，也能预览效果，但使用 username.github.io 访问，出现 404 .
答：首先确认 hexo d 命令执行是否报错，如果没有报错，再查看一下你的 github 的 username.github.io 仓库，你的博客是否已经成功提交了，你的 github 邮箱也要通过验证才行。

转载请注明原地址，潘柏信的博客：http://leopardpan.github.io 谢谢！