Skip to content

molincya/molincya.github.io

Repository files navigation

码志

我的个人博客:https://mazhuang.org,欢迎 Star 和 Fork。

概览

效果预览

在线预览 →

screenshot home

Fork 指南

Fork 本项目之后,还需要做一些事情才能让你的页面「正确」跑起来。

  1. 正确设置项目名称与分支。

    按照 GitHub Pages 的规定,名称为 username.github.io 的项目的 master 分支,或者其它名称的项目的 gh-pages 分支可以自动生成 GitHub Pages 页面。

  2. 修改域名。

    如果你需要绑定自己的域名,那么修改 CNAME 文件的内容,并参考 配置 GitHub Pages 站点的自定义域 做好配置;如果不需要绑定自己的域名,那么删掉 CNAME 文件。

  3. 修改配置。

    网站的配置基本都集中在 _config.yml 文件中,将其中与个人信息相关的部分替换成你自己的,比如网站的 url、title、subtitle 和第三方评论模块的配置等。

    评论模块: 目前支持 disqus、gitment、gitalk、utterances、beaudar 和 giscus,选用其中一种就可以了,推荐使用 giscus。它们各自的官方配置指南链接在 _config.yml 文件的 Comments 一节里都贴出来了,请参考官方指南配置。

    注意: 如果使用 disqus,因为 disqus 处理用户名与域名白名单的策略存在缺陷,请一定将 disqus.username 修改成你自己的,否则请将该字段留空。我对该缺陷的记录见 Issues#2

  4. 删除我的文章与图片。

    如下文件夹中除了 template.md 文件外,都可以全部删除,然后添加你自己的内容。

    • _posts 文件夹中是我已发布的博客文章。
    • _drafts 文件夹中是我尚未发布的博客文章。
    • _wiki 文件夹中是我已发布的 wiki 页面。
    • _fragments 文件夹中是我已发布的短文片段。
    • images 文件夹中是我的文章和页面里使用的图片。
  5. 修改「关于」页面。

    pages/about.md 文件内容对应网站的「关于」页面,里面的内容多为个人相关,将它们替换成你自己的信息,包括 _data 目录下的 skills.yml 和 social.yml 文件里的数据。

    skills.yml 和 social.yml 里内容的含义可以参考:_data 目录下的 yml 文件内容含义

使用文档

经验与思考

  • 排版建议遵照一定的规范,推荐 中文文案排版指北(简体中文版)

  • 简约,尽量每个页面都不展示多余的内容。

  • 有时一图抵千言,有时可能只会拖慢网页加载速度。

  • 言之有物,不做无痛之呻吟。

  • 如果写技术文章,那先将技术原理完全理清了再开始写,一边摸索技术一边组织文章效率较低。

  • 杜绝难断句、难理解的长句子,如果不能将其拆分成几个简洁的短句,说明脑中的理解并不清晰。

  • 可以学习一下那些高质量的博主,他们的行文,内容组织方式,有什么值得借鉴的地方。

联系我

如果对本博客模板或者内容有任何建议,可以通过 Issues 或者微信公众号「闷骚的程序员」与我取得联系。

致谢

本博客外观基于 DONGChuan 修改,感谢!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published