我日常的文档大部分是用markdown来管理的,日积月累也积攒了很多技术和非技术的文章。最常用的工具是sublime + markdown preview,基本上可以满足大部分日常文档的编写需求。但是大部分是一些草稿或记录,一直没有找到很好的博客解决方案,直到我发现了hexo。本文是我在日常编写文档和使用hexo搭建博客中使用到的一些工具。
markdown 简介
markdown 现在已经成了我日常工作和学习的一部分了,惊艳于它简单的语法和自由的表达方式,让人沉浸于写作的乐趣,让人更专注与写作和技术本身。
基础语法可以参考 http://wowubuntu.com/markdown/。
hexo 简介
A fast, simple & powerful blog framework
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
部署到哪里
hexo 是一个本地的静态博客框架工具,可以将我们平时的文章渲染为最终的 html 代码,但是如何将文章放到公网上,让其它人也可以访问呢?当然可以买一个主机,自己搭建服务器。更为方便的是可以使用github来托管博客。
GitHub Pages 本用于介绍托管在GitHub的项目,不过,由于他的空间免费稳定,用来做搭建一个博客再好不过了。
简单的步骤:
- 申请 github page
- 配置hexo deploy
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/lepfinder/lepfinder.github.io.git
branch: master
- 安装git
- 在本地blog目录执行发布
其它
如何快速的在 markdown 文档中插入图片
插图是编写文档必不可少的一个动作,如何快速的在markdown文本中插入图片呢?我本地使用 “Alfred 工作流 + 七牛云" 外链的方式。使用起来非常便捷:
- command + control + shift + 4 完成截图
- command + control + shift + V 完成图片上传到七牛
- command + V 粘贴外链地址到指定位置(如果光标此时在编辑器中,这一步其实是自动的)
具体使用方法参考 简化markdown写作中的贴图流程
如何画出好看的图?
推荐 OmniGraffle,下面是一个截图:
如何在修改完文章后自动渲染
推荐使用livereload,我使用的是lepture写的一个python的库,项目地址。
livereload 可以做什么事情呢?比如作为一个前端开发,每次写完html或js代码之后,保存完,需要去浏览器手动刷新页面才能看到修改后的效果,能不能文件发生变化之后浏览器自动刷新呢,这样将会给实际的开发带来很大的便利,于是livereload便出场了。
使用步骤:
- 下载安装 server 端,即python-livereload
- 进入需要监控的地址,比如
cd /Users/xiexiyang/Documents/myblog
livereload
- 在浏览器中激活chrome插件
如何在文中中插入 gif 动图
推荐使用 licecap。
我上面的 livereload 动图就是使用的licecap录制的。