Markdown赛高
d=====( ̄▽ ̄*)b
正文共:2331 字 8 图
预计阅读时间: 6 分钟
为什么要有博客
博客之于程序员意义重大,因为,输出是一个程序员的基本素养和技能,开源分享是科学技术发展和人类社会进步的重要美德和推动力,而博客正是输出分享的重要途径之一。
为什么输出分享对程序员来说十分重要,我有以下几点看法。
- 从技术角度考虑,技术的提升依赖于专业知识的学习以及实际经验的积累,而人的大脑需要不断地进行重复记忆,才能将这些知识经验留在自己的知识库里。因此,无论是学习新知识还是通过实践得到的经验,有了即时的输出记录,才便于复盘与巩固。
- 在实际工作中,当我们面临复杂大型的项目,和其中大量的代码时,如果只根据个人喜好而不根据代码规范去开发,写完后不留存开发文档以及接口文档,必然给项目的维护带来更高的代价,给团队中的其他开发者带来困扰。因此,代码规范和开发文档的输出也相当必要。
如果你还不相信,坚持输出给程序员带来好处的例子很多,我随意举几个。
- 例如IT圈出名的阮一峰,张鑫旭,stormzhang(这位已经不再分享技术了)等等大佬,他们有今天这种影响力的一个重要因素就是输出分享;
- 我也曾不止一次吸取前辈的经验以及建议,前端圈的小爝大佬在知乎的某个回答当中提到过“长期坚持技术输出和总结分享”在找工作面试中是一个亮点和加分项;
- “前端桃园”公号的运营者桃翁也十分提倡坚持输出,他在他星球小圈子中给我们分享过他自己 因为坚持输出提升了影响力 而多次收到阿里面试邀请的经历。
还有很多例子,不一一例举,分享本文的原因也就写到这,不再赘述。
(当然输出分享的途径很多,本文以介绍博客为目的,如果选择其他途径可以忽略下文)
如何选择博客
现在网络上有各式各样的博客,有基于第三方的平台(如博客园、csdn等)
也有可供个人搭建的工具(如Hexo、Ghost、wordpress、jekyll等)
自建博客的选择丰富多彩,选择一个最适合自己的最重要。
作为一个博客,我最重视的有两个方面:
- 可自定义,可个性化。
因为每个人追求的博客风格不同,想要展示的内容和格式也有所不同。
- 高效转化。
我指的转化,是你的输出原文档 到 博客文本的转化,这一转化的过程对于想要存档原文,或不习惯于博客编辑器,不习惯于博客网页格式的人十分重要。
我推崇用Markdown来写笔记,因为markdown足够简约优雅,兼容性也十分强,
Markdown是一种轻量级的「标记语言」,通常为程序员群体所用,目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式。 非技术类笔记用户,千万不要被「标记」、「语言」吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。 就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。
因此今天推荐的博客搭建工具,就是Hexo.
- 通过Hexo,你可以高定制化的DIY自己的博客
- 搭建后,只需要将md文档源文件丢进指定目录,输一个命令,hexo就可以自动生成页面
- 生成静态文件后,可以无需服务器 域名,直接将静态文件丢在GithubPages上即可
Hexo博客搭建 & DIY & 使用指南
具体api请看hexo官网文档,下面只分享搭建 DIY 使用流程
- 安装node和git
- npm安装hexo和相关依赖
- 根据hexo命令 初始化 博客文件夹,在config中添加博客相关信息和配置
- 在hexo官网/themes选择相关主题,或使用默认主题,以我使用的简约主题maupassant为例
主题默认样式如图:
- 除了默认的首页/归档等tab页,可以在配置中添加更多tab页,tab的内容也可以从markdown渲染。
例如添加/Demo分页,可以在配置文件中新增一项tab配置,在source文件夹下添加/demo/index.md即可,可以在post.pug模板中更改tab分页渲染index.md的方式。
配置:
post.pug模板代码:
实现效果:
- 其他的各种折腾,其实原理都类似,找到对应的pug模板代码进行增删改即可,包括样式、脚本、内容。(注:pug,即前jade,前端的一种模板引擎,api参见https://pugjs.org/api/getting-started.html)
- 调试的过程也很方便,使用hexo server命令可以启动本地环境,并且会自动watch你的更改(包括配置 scss pug模板),并自动重新生成,这个过程也很快,大概一口茶不到的功夫。
- 搭建完成后,日常使用只需要将md源文件放入source/_post文件夹下,再运行一个简单的命令,即可自动生成 部署到git
hexo generate --deploy
hexo g -d
- 一些其他的实用功能也很多,例如:根据markdown#标题,自动生成toc目录;可以方便的引入各大评论网站的脚本,只需要账号,第三方存储评论留言不需要维护;引入百度/busuanzi等的访问量统计;文章字数统计和预计阅读时间;等等很多,不一一例举。总之DIY自由度极高,适合开发者
写在最后
最近有一些感悟,以技术为目标的人,不要浮躁,莫逞他人嘴上快,莫争浮世虚功名,心无旁骛,沉下心来钻研技术就好。
本文素材来源
ScarSu
- END -