美文网首页Hexo 搭建个人博客
Hexo 搭建个人博客 #04 主题的安装与自定义样式

Hexo 搭建个人博客 #04 主题的安装与自定义样式

作者: y0ngb1n | 来源:发表于2019-01-18 12:44 被阅读81次

    本文首发于:https://y0ngb1n.github.io/a/2270d168.html

    Hexo 博客主题

    Hexo 默认的主题简陋?不太好看?就是不喜欢?

    其实想要更换 Hexo 的主题是很简单的,Hexo 提供了可插拔式的主题机制,让我们可以轻松地更换博客主题。

    可以在「官方收集的主题列表」挑选任意一个你喜欢的主题,总有一个适合你。

    skapp」这个主题挺不错的,接下来就参照这个主题的官网的教程进行安装使用。

    主题的安装(skapp

    利用 Docker 快速搭建 node.js v8.9.3 环境

    docker run -it --name node8 --rm \
      -v $(pwd):/app -w /app \
      -p 4000:4000 \
      node:8.9.3 /bin/bash
    

    在 windows 下各种报错,无奈转到 Linux 的机子上操作

    cd blog
    
    # 将 skapp 主题 clone 至 themes/skapp 文件夹下
    git clone https://github.com/Mrminfive/hexo-theme-skapp.git themes/skapp
    
    # 安装 skapp 主题指定的依赖
    # 基于 2018-12-19,有个小坑:要使用 node.js v8.9.3 版本才能正常安装这些依赖,是由于 lunr 仍然在使用 nodejieba 2.2.5 引起的
    npm install --save hexo-autoprefixer hexo-filter-cleanup hexo-generator-feed hexo-generator-sitemap hexo-renderer-sass hexo-renderer-swig mamboer/lunr.js moment node-sass object-assign
    
    hexo clean
    
    hexo server
    

    :triangular_flag_on_post: 能否使用 Git Submodule 进行管理第三方主题?

    上面直接 clonehexo-theme-skapp 仓库于 themes/skapp,带有 .git 文件夹,git 识别为 Submodule,但没有产生外链到原 hexo-theme-skapp 仓库,只是个普通的文件夹。当我们把自己的博客仓库 clone 到本地后会发现 themes/skapp 只是一个普通的空文件夹 :anguished:,主题不见了。

    未使用子模块

    那能不能在执行 clone 操作时能直接拉取该主题仓库,而且该主题的源码不托管在我们的仓库中呢?可以的,这时就该使用 git submodule 了 :+1:。

    # 先取消暂存 themes/skapp 目录
    git rm -r themes/skapp
    
    # 添加子模块
    git submodule add git@github.com:Mrminfive/hexo-theme-skapp.git themes/skapp
    
    # 可以看到新增 .gitmodules 文件
    git status
    

    .gitmodules 描述了 Submodule 的远程仓库信息与本仓库的相对路径:

    [submodule "themes/skapp"]
        path = themes/skapp
        url = git@github.com:Mrminfive/hexo-theme-skapp.git
    

    .git/config 中也自动添加了 submodule 信息:

    [submodule "themes/skapp"]
        url = git@github.com:Mrminfive/hexo-theme-skapp.git
        active = true
    

    以及产生了 .git/modules 文件夹,最后提交并推送到博客的远程仓库:

    git commit -m 'chore: convert to skapp submodule'
    
    git push
    

    GitHub 仓库 上会显示出当前所引入的子模块版本:

    convert to skapp submodule

    当我们在其他地方进行仓库的 git clone git@github.com:y0ngb1n/y0ngb1n.github.io.git 时,发现 themes/skapp 是个空文件夹,意味着没有安装该主题。那么如何 clone 一个完整的仓库呢?只需如下操作即可:

    # 方式一:使用  submodule init / update
    git clone git@github.com:y0ngb1n/y0ngb1n.github.io.git blog && cd blog
    git submodule init && git submodule update
    
    # 方式二:添加 --recursive 参数
    git clone git@github.com:y0ngb1n/y0ngb1n.github.io.git --recursive
    

    当该第三方主题更新了,我们可以更新子模块:

    git submodule update --remote themes/skapp
    

    或者切换至 themes/skapp 目录下使用 git 命令切换到不同的历史版本,如果对子模块执行了相关操作后,会提示 modified: themes/skapp (new commits)

    $ git status
    On branch source
    Your branch is up to date with 'origin/source'.
    
    Changes not staged for commit:
      (use "git add <file>..." to update what will be committed)
      (use "git checkout -- <file>..." to discard changes in working directory)
    
            modified:   themes/skapp (new commits)
    

    然后按正常流程提交并推送到远程仓库即可。

    主题的配置

    主题的相关配置可以参考「skapp 官方说明」,可以设置:菜单、博客信息、联系方式、外部链接等。

    header 的背景图(随机图)

    使用了「Spencer Woo」家提供的 https://api.spencerwoo.com 接口,可随机不同的图片,在 _config.yml 中设置:

    ## header 的背景图
    header_cover: https://api.spencerwoo.com
    

    开启「不蒜子统计

    skapp 主题已经集成了「不蒜子统计」,但默认是关闭的,只需在 _config.yml 中开启即可:

    # Busuanzi
    busuanzi: true
    
    Skapp Hexo 主题

    欢迎围观 我的博客 https://y0ngb1n.github.io/ :wave:

    自定义样式

    待续...

    参考资料

    相关文章

      网友评论

        本文标题:Hexo 搭建个人博客 #04 主题的安装与自定义样式

        本文链接:https://www.haomeiwen.com/subject/qwqndqtx.html