目录

找教程

第二又试了wsl安装ubuntu

部分资料：

---

主要步骤：

1.注册github账号；

2.创建仓库；访问自己的网页https://shililanka.github.io 静态html页面

3.使用jekyll，选择网页风格，编辑自己的网页

找教程

1.  建一个个人网站，了解到github pages有免费托管，看了别人做的效果。

2.  通过官方教程文档GitHub Pages 使用入门 - GitHub 文档和网友总结的教程，知道需要用到github仓库 + jekyll；

按照官方教程文档设置新建了一个仓库: username.github.io  空仓库，

打开https://shililanka.github.io网址早了会出现404；

仓库建好几分钟后，打开https://shililanka.github.io网址，会有一个空白页面； 

看到说，添加一个readme.md文件，网站会显示文档里的内容，就新建了一个readme.md，往里面添加了文字，图片，提交后； 网站页面也一起更改了。此时网站只有链接https://shililanka.github.io像网站的样子，可以在手机、浏览器上打开，网站页面想一个pdf页面。

3.  官方教程，如何搞jekyll，此时还不知道jekyll具体是干什么的，以为是一个软件安装好就可以用了。jekyll网站上下载了一个jekyll-4.3.3的压缩包，以为是安装软件，打开后也没有找到exe文件，先不管了。

 教程说需要先把Ruby、bundle搞好再搞jekyll，也是以为Ruby、bundle是软件直接安装就能用，然后就搞搞搞，这两个安装部署好之后；到了bundle exec jekyll serve，在这一步才出现了jekyll（还是不知道它有什么用），这一步一直也没有搞好。

4.  然后看到一个教程说怎么样改仓库里的文件去修改网站页面，里面的文件和我之前下载的jekyll-4.3.3基本一样，我就把jekyll-4.3.3文件也搞到我的username.github.io仓库里，这时候还是不知道怎么把这个文件和网站联系起来，又找到一个视频https://www.youtube.com/watch?v=g6AJ9qPPoyc 

介绍了用al-folio模板 theme建站，也知道了我的jekyll-4.3.3文件是配置网站的文件，然后我也用了视频里的仓库，不过到bundle install    和bundle exec jekyll serve这几步，还是出现各种问题。

5.  解决不了。又找al-folio相关的资料，又找到了一个教程 Jekyll + GitHub 实现个人主页部署  介绍了两种使用jekyll的方法，在Windows上和Linux（wsl上的ubuntu）上；

第一试了Windows，到了bundle install    和bundle exec jekyll serve这几步还是搞不好；

第二又试了wsl安装ubuntu

（最后也是用ubuntu这种方式搞好的），

第一次用wsl安装ubuntu很顺利，可是设密码的时候没搞好（输密码的时候显示字符，一直以为没有输进去）；

重装ubuntu，重装花费了很长时间，重新镜像到国内，还有可能之前卸载没清理干净等等问题，搞了很久才装好。

6.  然后又在ubuntu上安装了Ruby 、bundler、Python、pip3等各种工具环境，在gem install jekyll bundler    和bundle exec jekyll serve也是问题比较多 ， gem install jekyll bundler 安装jekyll和bundler用了很长时间一直卡在那里，也是网络原因，重新镜像到国内，就正常了。

bundle exec jekyll serve的过程中，发现了一些环境配置。路径安装等错误；然后是一直提示_config.yaml格式不对，但是又找不出来；我只是把默认的标题替换成了我的标题；后来使用了没有经过任何更改的文件，就可以了，也不知道为什么。

7.  然后是网络问题，因为我是用的al-folio模板 里面有从medium和google链接里拉取一些内容，导致一直卡在那里，也不报错，只能Ctrl+c强制停止；  后面把代理设置成了全局模式才可以（后面把这两个链接都屏蔽了，就不用代理了），最后终于不报错了（也有报错，但不影响）又卡在了     

Server address: http://127.0.0.1:4000/al-folio/
 Server running... press ctrl-c to stop.

一边搞一边看127.0.0.1:4000或者localhost:4000 有没有内容，当它卡在Server running... press ctrl-c to stop.的时候，页面终于出现了和教程里一样的页面。

执行指令bundle exec jekyll serve，出现Server running... press ctrl-c to stop.表示网站在运行中，访问127.0.0.1:4000或者localhost:4000，网页正常显示；Ctrl+c强制停止，serve停止，网页404.

每次更改配置后，要重启bundle exec jekyll serve服务，才会看到新效果。

在github上直接更改配置也会生效，不过不方便，一是没有本地的编辑器好用，二是github pages对deploy次数有限制  所以需要在本地改好，预览效果后，再把配置推送到github。 

还一个问题，在本地访127.0.0.1:4000，页面挺正常的，但是部署到github上，访问https://username.github.io 也有内容，字是对的，但是格式大小什么的都不对，以后再说了。

昨天13.00到今天13.00，才基本搞好了一个个人网页，可以更改标题，更换图片一些基本操作。

只会建立github仓库，推送拉取这些基本操作。 还好资料很多，搜索引擎主要找文档教程类的资料，网友总结教程或者提出来的问题； 然后就是kimi和chatgpt，比如在配置环境的过程中，ubuntu或者cmd窗口给出的错误提示，搜索引擎给出的答案太片段了，使用大模型，给出的结果就会更系统，更全面，对于解决debug过程中的问题很好用。

网络问题：搞的过程中，很多资料都需要从网上配置到本地，因为网络问题卡了很多次，搞到最后才想起来开全局代理，才避免了卡在从网上下载的资料的地方。

重新安装或者生成的文件可能会受到前面的影响，要删干净一点。

更多：

在网上找到模板后，直接复制别人的仓库，等待几分钟就能访问自己的网页了。只是内容都是模板里的内容。后面搞jekyll  Ruby是为了后续对网站内容进行修改管理的。

我用了这么长时间才做好，主要是没有搞懂做网页的一个流程，然后就是使用工具不熟悉。

利用Github实现(多个)个人网站

资料：

Jekyll Tutorial: How to Create a Static Website

安装 WSL | Microsoft Learn

Jekyll on Ubuntu

Ruby gem，bundler默认源替换为国内镜像，可解决bundler install卡住等问题

查找、安装以及发布 Gem

清华大学开源软件镜像站

Jekyll 网站 Themes

Jekyll是一个强大的静态网站生成器，可以将Markdown、HTML、Liquid模板等文件转换为静态网站。Jekyll支持模板引擎、主题、插件、集成GitHub Pages等特性，可以帮助用户快速搭建和发布静态网站。       是一个运行在Ruby编程语言上的静态站点生成器。

静态站点生成器的优点:速度-您的网站将执行得更快，因为服务器不需要解析任何内容。它只需要读取普通的HTML。安全性——你的网站不容易受到攻击，因为服务器端没有可利用的东西。简单——不需要处理数据库或编程语言。简单的HTML和CSS知识就足够了。灵活性——你完全知道你的网站是如何运作的，因为你是从零开始创建的。