重新学习建立网站

1.缘起

之前在考试周的时候就一直想着做一个博客，所以在做课设的闲暇之余，以至于之前通了几次宵。我都一直在抽出时间来做我自己的博客，但是苦于自己并没有相关的编程基础，也没学过css，也不了解html，甚至连md的语法都不是很清楚。又缘于前两天因为OneDrive配置失败搞得自己电脑的document文件夹也乱了，把电脑强制重置了21H1的版本，重置了所有的应用，也算是为了迎接马上要到来的Win11更新。今天又准备来搞一搞自己的博客。

其实是有这么回事的，本来想着自己再按照之前的方法用官网的教程再装一个ruby、Jekyll，然后直接重新做一个网页。但是总有种重蹈覆辙的方法，于是今天从YouTube上找到了这么一个人的视频，也算是好好学习一下到底怎么建立一个网站。网站附下：

Jekyll 博客系列 - 01 快速入门 - YouTube

2.入门操作

2.1 搭建环境

2.1.1 安装ruby

Ruby 3.0.1 使用这个链接下载并安装到windows下

2.1.2 安装Jekyll

$ gem install jekyll

2.1.3 安装bundler

bundler是Jekyll 3.3之后的版本使用的运行方式，所以在运行jekyll博客的时候必须使用bundler语句

$ gem install bundler jekyll
or
$ gem install jekyll bundler
(顺序好像没有影响？？？)

这样基础的开发环境就已经搭建完毕

2.2 在本地搭建博客

两种方式

2.2.1 simple one

直接新建一个博客文件夹（需要在想要创建的地方shift进入powershell下）

如下，将myblog替换为你要创建的博客文件夹名

$ jekyll new myblog

2.2.2 complicated one

新建一个空文件夹，然后用Jekyll在里面新建blog

$ mkdir mblog
$ cd mblog
$ jekyll new .

删掉刚才新建的第二个文档。嘛就算是熟悉一下powershell的语法。

$ cd ..
$ rm mblog
$ y

2.2.3 继续搭建基本文件

因为Jekyll在搭建系统的时候可能会有一些依赖文件，所以需要用bundler来搭建这些需要的依赖

$ cd myblog
$ dir
$ bundle install

现在，这个博客就算是搭建完成并且可以在本地进行运行，使用如下操作：

$ bundle exec jekyll serve

嘛，嫌麻烦也可以把serve改成s，这样减少代码输入量（并没有）

这时候就可以在本地的127.0.0.1:4000端口运行这个网站，ctrl + click打开这个链接就可以看到你建立的这个网站

PS E:\Programfls_extra\myblog> bundle exec jekyll s
Configuration file: E:/Programfls_extra/myblog/_config.yml
            Source: E:/Programfls_extra/myblog
       Destination: E:/Programfls_extra/myblog/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
       Jekyll Feed: Generating feed for posts
                    done in 0.446 seconds.
 Auto-regeneration: enabled for 'E:/Programfls_extra/myblog'
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

如果没有出现上面这个链接，你可能需要重新安装一下webrick这个组件

$ bundle add webrick

这样你的网站就在本地建好了

如果你电脑上之前就有装 vs code 的话，快速查看博客文件的目录结构：

$ code .

2.2.4 其他需要了解的事情

在Jekyll的文件目录库中包括很多文件，逐个阐明。

2.2.4.1 _config,yml

众所周知，config是configuration的缩写，即站点配置文件。所有对网站属性的修改都从这里开始。每次使用bundle构建站点之后直到下一次构建之前，所有对于这个文件的修改都不会生效，换言之，想要修改它就必须重新发布。

比较重要的一些关键词包括：

• title

  这个是整个博客的主标题，在初始模板上显示就是在header上的博客名

• description

  这个是博客的介绍，显示在footer上。事实上只是一个内容关键词，你甚至可以把description放在posts里面。

• baseurl

  默认不加的时候访问的是4000这个端口，但是如若你的博客域名下面有多个blog比如blog1/2/3 etc... 那么你就需要在这儿写一个基础站点指定一个二级path，比如/blog。那么Jekyll生成的站点的位置就在127.0.0.1:4000/blog/下。直接访问4000站点得到的网站应该是404网站。

  不建议直接修改，因为也用不着（暂时）

• url

  默认就是生成的站点的内容，填与不填意义不大，但是还是建议填上（比如后面将要发布的地方https://你的github名.github.io

• _username

  这个类型的，可以加很多个，只要你在模板文件中写好元素加好链接，可以链接不止两个社交帐号

• theme

  这一项就是写这个默认主页使用的jekyll主题名称，默认这个很简洁的就是叫minima~

• exclude

  exclude这一项写的是在发布网站的时候Jekyll不会往站点发布的文件，比如包括的内容在发布端应该是找不到的，后文中会详细分析。

2.2.4.2 _posts

posts，就是发布的意思，你将要在端口发布的markdown格式的博文都会储存在这个地方。

2.2.4.3 _drafts

drafts，就是手稿的意思。就是博文的草稿箱之类的东西，你并不想把这篇博文上传到端口，但是还没有写完还需要保留一部分以后继续编辑，那么你就可以把md文件暂时放在drafts文件夹里面，这样Jekyll在发布的时候也会自动地忽略这个文件夹中的博文，但是这篇文章仍然会被发布到云端？

2.2.4.4 _site

site这个文件夹在上传到端的时候不会被上传。但是我们通过端口访问的网站事实上就是Jekyll生成的这个目录里面的静态网页。事实上，也就是一个映射。甚至你可以直接把这个文件夹里面的html代码直接拷到虚拟主机或者服务器里面来构建静态网页并运行发布，完全没有问题。

因为site不会被上传到端口，所以在.gitignore这个文件中包括这个_site的内容。

如果你想让Jekyll单独输出一个这样的站点文件夹，比如把他输出到这个目录下的dist文件夹，可以这样做：

$ jekyll build --destination = ./dist

同样，上面的build可以缩写成b

标签：myblog,jekyll,网站,建立,重新学习,博客,Jekyll,文件夹,2.2
来源： https://www.cnblogs.com/repo-kristx/p/14945915.html