使用coding、daocloud和docker打造markdown纯静态博客

说起独立博客的技术演变,从数据库到纯文本放git是一大进步,从HTML到markdown又是一大进步。

解析技术有没有进步呢?既然markdown是纯文本了,再用PHP/Python/Ruby去实时解析,多么多此一举啊(比如github用的Jekyll),还需要配置服务器环境。如果用shell把markdown转换成HTML,生成纯静态博客多么愉快,无需服务器,直接放到云存储CDN上,飞快!

先看疗效!openwrt.io就是这么一个纯静态网站,网址:http://openwrt.io/,代码在coding上:https://coding.net/u/openwrtio/p/portal/git

使用coding、daocloud和docker打造markdown纯静态博客

打造这么一个酷炫的博客需要几步?

只需要两步,比把大象放进冰箱里还要简单^_^

第一步:把代码提交coding

注册登录 coding.net,fork或创建一个项目,比如blog,代码:https://coding.net/u/openwrtio/p/portal/git/tree/1.0.0/,修改其中的docs/index.md即为博客首页,然后提交,打tag(比如0.1.0),push。指令如下:

git clone xxx
cd xxx
wget -O blog.zip https://coding.net/u/openwrtio/p/portal/git/archive/1.0.0
unzip blog.zip
rm blog.zip
echo "Hello! 树先生" > docs/index.md
git add .
git commit -m 'first commit'
git push origin master
git tag -a 0.1. -m 'first commit'
git push --tags

第二步:使用daocloud自动构建和部署

打开daocloud.io,创建一个项目,“设置代码源”为刚才提交coding的项目即可,将触发自动构建。等待构建完成,即生成了一个debian系统镜像,点“查看镜像”——》“部署”——》“基础设置”——》“立即部署”,即可。daocloud会赠送一个子域名,访问即可看到博客已经跑起来了。建议购买一个自己的域名,CNAME绑定即可,比如dnspod域名注册服务

使用coding、daocloud和docker打造markdown纯静态博客使用coding、daocloud和docker打造markdown纯静态博客使用coding、daocloud和docker打造markdown纯静态博客

构建的过程为什么这么漫长?

请看这个文件: https://coding.net/u/openwrtio/p/portal/git/blob/1.0.0/Dockerfile

FROM nginx
MAINTAINER sinkcup <sinkcup@.com> RUN apt-get update -qq
RUN apt-get upgrade -y
RUN apt-get install -y python-pip
RUN pip install mkdocs
RUN mkdir -p /usr/share/nginx/html/portal
ADD . /usr/share/nginx/html/portal/
RUN cd /usr/share/nginx/html/portal/ && \
mkdocs build
RUN rm -f /etc/nginx/conf.d/*
ADD nginx/conf.d /etc/nginx/conf.d/

可以看到每次构建都需要apt-get升级、安装环境、安装mkdocs,最后用mkdocs生成HTML。前面几个步骤每次都一样,那就想办法重用即可。

Dockerfile改成两个,一个是每次都不变的服务器环境:

FROM nginx
MAINTAINER sinkcup <sinkcup@.com> RUN apt-get update -qq
RUN apt-get upgrade -y
RUN apt-get install -y python-pip
RUN pip install mkdocs
RUN cd /usr/share/nginx/html/ && \
mkdocs new demo
RUN cd /usr/share/nginx/html/demo && \
mkdocs build
RUN rm -f /etc/nginx/conf.d/*
ADD nginx/conf.d /etc/nginx/conf.d/

我把它提交到了github(https://github.com/sinkcup/docker-library-nginx-mkdocs),然后注册登录docker.com,创建一个项目,选择来自github的代码(https://registry.hub.docker.com/u/sinkcup/nginx-mkdocs/),构建成功,生成的镜像是 sinkcup/nginx-mkdocs:0.1.0

daocloud的Dockerfile里直接使用这个docker镜像即可,从此构建飞快!代码如下:

FROM sinkcup/nginx-mkdocs:0.1.
MAINTAINER sinkcup <sinkcup@.com> ADD . /usr/share/nginx/html/portal
RUN cd /usr/share/nginx/html/portal/ && \
mkdocs build
RUN rm -f /etc/nginx/conf.d/*
ADD nginx/conf.d /etc/nginx/conf.d/

完整代码在 https://coding.net/u/openwrtio/p/portal/git/tree/1.1.0/,这是一个开源项目,欢迎fork一起协作。

mkdocs文档在:http://www.mkdocs.org/

上一篇:Revit二次开发 推荐


下一篇:Jfreechart 生成不同数据源多个饼图(Multiple Pie Chart)