start-my-blog

2021/04/01 其他 共 752 字,约 3 分钟 Read:

快速搭建博客,与写作规范。

快速搭建git-pages

近来工作不忙,想尝试一下博客写作试试好不好玩。

借鉴了马壮大神和feedliu的模版。直接Fork+少量改动即可。简洁易用。

两位老师的页面。

  • https://github.com/mzlogin/mzlogin.github.io
  • https://feedliu.github.io/2019/02/15/build-your-own-blog-site/, 这个链接给出了比较简洁的教程,也可以根据feed之前的pages搭建自己的。

搭建pages中间的一些注意事项 (20210806 补充)

在使用过程中,因为自己不太熟悉,进行了一些前端方面的探索,在此陆续补充。

  • 系统主要的配置参数在 _config.html 内,可以根据自己需要进行相应增删。 例如 qrcode 和 word count 的功能。
  • 博客系统使用了 jeckyII 模版,其中文字系统基于 kramdown 系统而非 markdown, 大体上后者是前者的子集,但细微处可能还有细小的差别,例如对图片和多媒体插入的处理。 也纠结了一段时间才陆陆续续搞明白。一些差异点和 kramdown 自己特有的用法可以参考笔记
  • 评论系统和 gitalk,待补充。

中文写作

马老师提出了一些中文写作规范,感觉很不错。 摘抄如下:

  • 排版建议遵照一定的规范,推荐 中文文案排版指北(简体中文版)。
  • 简约,尽量每个页面都不展示多余的内容。
  • 有时一图抵千言,有时可能只会拖慢网页加载速度。
  • 言之有物,不做无痛之呻吟。
  • 如果写技术文章,那先将技术原理完全理清了再开始写,一边摸索技术一边组织文章效率较低。
  • 杜绝难断句、难理解的长句子,如果不能将其拆分成几个简洁的短句,说明脑中的理解并不清晰。
  • 可以学习一下那些高质量的博主,他们的行文,内容组织方式,有什么值得借鉴的地方。

Search

    Table of Contents

    本站总访问量