东莞网站建设,网站备案ip查询网站,网站建设的建议和意见,网站代码需要注意什么问题现在大家都喜欢用markdown来写技术博客#xff0c;这篇文章将阐述搭建支持markdown的简易博客方法。我的写作需求通过阅读本文#xff0c;您将学会搭建满足以下条件的博客#xff1a;博客只用书写markdown文件能支持版本控制免费#xff0c;不需要租服务器或主机编写、部署…现在大家都喜欢用markdown来写技术博客这篇文章将阐述搭建支持markdown的简易博客方法。我的写作需求通过阅读本文您将学会搭建满足以下条件的博客博客只用书写markdown文件能支持版本控制免费不需要租服务器或主机编写、部署博客不依赖复杂的环境技术选型markdown是一种简单文本格式的书写语法写好md文件后要展示在浏览器有三种思路通过php、Java、ruby等解析后展示这种方式需要服务器支持。如gitblog、gollum解析成静态文件后放在托管空间上看起来很完美但本地必须安装环境个人认为还是不方便。如jekyll、hexo直接将md文件托管到托管空间由前端直接解析后展示。如mdwiki比较下来我还是选择了最后一种方式因为它使用起来太简单了不用搭建任何环境。虽然搭建的博客比较简单但对于个人博客来说够用了。mdwikimdwiki其实就是用js分析md文件在前端转换成dom显示在浏览器。使用方法非常简单直接将mdwiki.html文件下载下来重命名为index.html放在md文件夹根目录即可浏览器访问的格式为..../index.html#!xx.md默认访问index.md。配置mdwiki可以用json配置一些属性直接在根目录配置config.json文件即可具体的配置可以参靠官网文档{useSideMenu: true,title:非专业Java程序员博客,lineBreaks: gfm,additionalFooterText: All content and images © by xi.yang | ,anchorCharacter: #}博客目录mdwiki的目录本身也是用md文件定义的直接在根目录创建navigation.md就行只能支持2级目录具体的语法可以参考博客最后的源码分享。主题mdwiki也支持主题更换可以去bootswatch下载喜欢的主题css文件放到根目录并在navigation.md配置对应的主题名称即可[gimmick:theme](cerulean)注意名称要小写如果是默认的bootswatch样式是不用下载css文件的直接配置名称即可高阶玩家可以参考语法自己定义漂亮的样式。自动生成目录完成以上步骤简单而漂亮的的博客就搭好了现在要做的就是写md格式博客并更新目录配置就可以在博客上看到更新了。但是文章写多了就会感觉很麻烦每次都要花时间去维护navigation.md如果是已经有很多现成的md文档初始化会更嫌麻烦为了简化这个过程笔者写了个简单的python脚本根据文件夹和文档直接生成目录配置文件这样每次无论改动多少内容直接执行一下python脚本就可以了具体代码可以直接看源码分享。码云pages配置接下来就是发布了可以发布到github或者码云上推荐使用码云毕竟国内速度要快点随便在码云上创建一个项目将根目录的所有文件push上去然后在服务-pages中开启服务即可访问如我的博客。无论用码云还是用github这时候都是用的他们的二级域名我们也可以使用自己的域名。首先在根目录创建CNAME文件写入自己的域名如果是github可以配置自己的域名然而码云是没有这个功能的但是可以去域名提供商配置Url转发(由于笔者在万维网买的域名说开通这个功能还要单独收费没有测试理论上是可行的)。一键部署完成上面的所有配置后我们写博客的步骤就简化为在对应文件夹写md文本博客。执行python脚本。git命令add、commit、push。这里git操作很烦每次我们都要执行好几个命令才能完成部署细想我们的个人博客其实不需要记录什么提交说明。于是笔者又写了个shell脚本将执行python脚本和一系列git命令一起执行。这样每次改完博客后直接执行这个脚本就完了非常方便windows用户装了git直接在git bash界面就可以执行脚本。脚本在源码中也有执念于提交说明的也可以修改脚本传入提交说明即可。源码分享以上博客集成代码的源码地址为md_blog将所有的文件都集成好了大家fork下来就可以直接用参考项目的readme几分钟就能完成博客搭建。
