Cloud computing assignment9

How to build your own blog site

Posted by Yuexi on May 02, 2023 · 31 mins read
Cloud computing assignment9

Cloud computing assignment 9

1. 博客主题及其选取原因

博客主题选取的主题是clean-blog-jekyll

选取的原因:

  • 简洁,没有什么花里胡哨的地方,方便阅读

  • 字体字号设置的比较规整

  • 在blog页面,每篇blog下面可以写些简介之类的,方便阅读

  • 在jekyll theme网站这个模板是Free

     

2. 博客搭建过程

本站主要使用Jekyll框架+Github Pages部署。Jekyll 是一个简单的静态网页框架,它有一个模版目录,其中包含原始文本格式的文档,通过 Markdown 或者 Textile 转化成一个完整的可发布的静态网站,可以发布在任何服务器上。

使用 Jekyll 搭建博客之前要确认下本机软件安装,Git(用于从本地部署到远端)、Ruby(Jekyll 是基于 Ruby 开发的)、包管理器 RubyGems

在做之前纠结了一下是否要直接在Windows上下载jekyll、ruby等环境,网上似乎都表示不太推荐,所以最终选择了在docker中进行。

2.1 具体操作过程

  1. 在GitHub里选个喜欢的样式的repo,fork到自己的账号下,同时将repo的名字改为`your-username.github.io

  2. 注册docker账号,下载docker desktop

    docker desktop需要WSL2环境,你可以wsl --update来更新本机的WSL环境

    在docker中可以把镜像换成国内的镜像 Settings -> Docker Engine

  3. 将GitHub上的repo clone到docker镜像上,这里用的是Ruby的Docker仓库

  4. 更新博客repo中的_config.yml文件(你可能要先下个vim)

    _config.yml 是整个博客的基础信息配置文件,修改这个文件可以直接把别人的博客变成自己的。

    重要字段说明

    • comment/livere: livere评论系统,支持微信、qq、微博、豆瓣、twitter等登录后可以直接评论
    • comment/disqus: disqus评论系统,支持facebook、twitter等登录后可以直接评论
    • social/weibo、github、zhihu、jianshu等: 个人站底部展示的微博等三方社交按钮,点击后直接跳转到个人微博或其他社交主页
    • enableToc: 是否开启文章自动生成目录,设置为false文章不会自动生成目录
    • baidu/id: 百度统计,用来统计你个人站点的用户访问情况
    • ga/id: google统计,用来统计你个人站点的用户访问情况

    如果需要在导航显示新增的页面,直接在_config.yml 文件的nav字段中添加新页面配置。

    ps.这里如果$(pwd)中包含了Docker无法识别的特殊字符,可以直接改成博客文件夹的绝对路径

  5. 在存储库目录中使用以下命令构建站点并启动本地服务器

    进入容器,在容器中运行以下命令安装 Jekyll 和其他必要的依赖项

    然后启动jekyll服务器

    这个命令将在 Docker 容器中启动 Jekyll 服务器,并将本地 4000 端口映射到 Docker 容器中的 4000 端口。此时,在浏览器中输入 http://localhost:4000 就可以直接访问博客。

  6. 生成 Jekyll 网站,并将生成的文件推送到 GitHub 仓库中。

此时,即可在浏览器中访问your-username.github.io

 

2.2 碰到的问题

每次运行一次镜像都会生成新的初始环境的容器

 

写在最后

其实很早就想搞个自己的博客了,只是一直拖拖拖。。。很开心借这个作业逼着自己把这件事干了 :-D