0%

写博客的一些规范

最近开始将CSDN的博客转到个人博客上,主要是采用Markdown将以前的文章保存下来,然后将其用hexo部署到github。在这里,我介绍一下使用Markdown写博客时一些技巧,格式,以及如何用部署到网站上。


用新电脑继续写博客

去年我在旧电脑使用hexo搭建了博客,其配置文件的没有上传到github。今年疫情在家,用新的电脑想写博客的时候发现无法发布到网站上。于是乎,到了学校之后,我就把配置文件也上传到了github上面,这样以后也可以在其他电脑上愉快的写博客了。具体的操作步骤如下:

  1. 在旧电脑上,使用hexo+github搭建博客(具体步骤网上有很多教程),会创建一个名为你名称的库,例如我的为tengweitw.github.io。该库中的master分支会存储你博客中的静态网页内容。我们需要手动创建一个新的分支(命名为hexo),并将该分支设置为默认分支,这个hexo分支的目的就是为了保存网站的配置文件。

    图1为master分支中的内容:

    图1

​ 图2为hexo分支中的内容:

图2

  1. 在新电脑上,我们使用如下命令将库克隆到本地tengweitw.github.io文件夹中:

    1
    git clone git@github.com:tengweitw/tengweitw.github.io
  1. 在本地tengweitw.github.io文件夹中右击运行Git bash(需要安装Git),依次输入如下命令来安装hexo环境:

    1
    2
    3
    4
    npm install hexo
    hexo init
    npm install
    npm install hexo-deployer-git
  1. 修改文件夹中的_config.yml中的deploy参数,分支改为master,这里的目的是在hexo分支中使用hexo d部署博客时,是上传到master分支下。

  2. 然后执行如下命令,将配置文件同步到hexo分支中:

    1
    2
    3
    git add .
    git commit -m "add something"
    git push
  1. 最后执行如下命令(在hexo分支下执行即可),生成静态网页并同步到master分支中:

    1
    2
    hexo g
    hexo d

总的来说,在一台新电脑写博客时,执行步骤2-6即可。当我们对博客进行修改(修改配置文件,或者添加新的博文)时,只需要执行步骤5-6即可。


写博客的一些规范

本想在网上找一些写一篇博文的格式规范,却发现相关内容少之又少。下面介绍一下我自己在写文章过程中常用的一些格式规范。

  • Markdown 编辑器
    我使用的是Typora,网上好评很多。对我来说,我有时需要在不同操作系统中切换,Typora也支持多系统。

  • 图床
    最开始一直都是存在本地,后来发现发布到网上就不行了。网上很多推荐使用各种图床的,付费的免费的都有。但是有可能不稳定,不开放外链,就会出现找不到图片的问题。我现在使用的是在github建立了一个名为FigureBed的仓库,将博客所有的图片放在这里面,每篇文章的图片按着其发布时间建立一个文件夹,如下图所示:
    图1

    使用github库作为图床的一个问题就是国内网络有时访问不了。不过我们 可以使用jsDelivr来进行CDN加速,其访问github仓库的方法特别简单,格式如下:

    1
    https://cdn.jsdelivr.net/gh/用户名称/仓库名称@latest/目录

    举例来说,对于本文的第一个图,我们使用的语句为:

    1
    <img src="https://cdn.jsdelivr.net/gh/tengweitw/FigureBed@latest/20200730/20200730_fig001.jpg" width="500" height="550" title="图1" alt="图1" >

    其中20200730是以文章发布日期为名的文件夹,20200730_fig001.jpg为该文章的第一个图。

    当然,我们最好将FigureBed库git到本地,然后在本地新建文件夹(比如,以日期为名),将图放进去,然后使用前面步骤5的命令将图上传到github中。对于博文中图的大小设置,即width和height我一直都不知道怎样才合适?怎样才比较美观?

  • 未完待续

坚持原创技术分享,您的支持将鼓励我继续创作!