使用github,Jekyll自建博客教程

申请github账号

https://github.com

找一个喜欢的主题

去主题网站http://jekyllthemes.org/ 找一个喜欢的主题。

比如 http://jekyllthemes.org/themes/adam-blog-2/

找到该主题的GitHub主页,如下图点击 themes.png

fork 该主题

fork.PNG 需要取名,比如 EnchantedForest。这是你的博客名字

点击最下面绿色按钮 fork

修改 _config.yml 文件

config.png

点击铅笔的图表,修改下面的内容 确保你的 _config.yml 文件包含正确的站点信息,例如 url 和 baseurl 的设置。一般来说,如果没有配置特别的 baseurl,你可以将其设置为/。 例如: url: “”
baseurl: “”

最后提交commit

启用 GitHub Pages

在你的 GitHub 仓库中,进入 Settings > Pages,确保选择了正确的分支并保存了设置。 page.png 修改 2,3,构建完成后 1是你的博客地址

等待构建完成:

GitHub Pages 可能需要一些时间来构建你的站点。通常,构建完成后,你应该在几分钟内看到网站上线。

进阶教程:并添加 Disqus 评论功能

https://blog.walterlv.com/jekyll/2017/09/15/setup-a-jekyll-blog-1.html

添加 Disqus 评论功能非常简单:

Disqus 创建个账号 一步步开通 Disqus 站点账号之后,进入到 Universal Code install instructions 页面 将 Disqus 提供的代码贴到 _layout / post.html 文件里面

如何添加博文

建议下载一个编辑markdown文件的工具,比如vscode,用电脑原生的也行

无工具,无git版:

找到你的博客仓库中_post文件夹 alt text

点击 add file按钮,编辑你的博文: alt text

博文的格式参考原仓库的写法:

  1. 博文命名:2024-09-22-blog.md 即 时间和博文名字加-的组合

  2. 博文的格式为markdown,建议检索markdown教程(一般五分钟学会) 博文最开头必须有

    ---
    layout: post
    title: PRD
    date: 2024-08-08
    author: https://yang-alice.github.io/
    categories: PRD
    banner:
      video: https://vjs.zencdn.net/v/oceans.mp4
      loop: true
      volume: 0.8
      start_at: 8.5
      image: /assets/images/leetcode/33/Figure_5.png
      opacity: 0.618
      background: "#000"
      height: "100vh"
      min_height: "38vh"
      heading_style: "font-size: 4.25em; font-weight: bold; text-decoration: underline"
      subheading_style: "color: gold"
    tags: PRD
    sidebar: []
    ---
    

    你需要修改 title,date之类的

其中图片和视频如果没有则可以删掉

  1. 注意:插图 图片存放位置一般是 assets文件夹下面。我一般会根据博文在建子文件夹,比如这篇博文的图片放在子文件夹blog下面。

插图的格式为:

![alt text](/assets/images/blog/add.PNG)

注意:图片需要你手动先上传到assets/images/blog文件夹下面

  1. 最后提交commit即可