Note: This blog is powered by Jekyll with al-folio theme. Hosted by GitHub Pages.

这篇主要讲下怎么具体的实现个人网站构建的过程,并总结自己花费两三天总结的问题。 具体如下:

1.下载编译:使用fork或use this template,将al-folio主题包转化成自己的repo,然后注意这个repo名修改成自己用户名,之后下载如下

git clone git@github.com:<用户名>/<用户名>.git

2.线上初步部署,在vscode的新终端进行推送

  • vscode打开 _config.yml, 修改url改成 https://<用户名>.github.io,baseurl 留空用户名>
  • 推送指令
      git init
      git add readme.md # 初步简单推上去,主要是为了配置相关选项  
      git commit -m “blog1”  
      git push -u origin master  
      # 第一次需要使用 -u 命令,之后直接 'git push' 就好了
      # git push --force origin master  #当推送失败可以试试这个,意义为强制推送
    
  • 首次推送包成功后,在github包的Action选项中选择Enable Github Actions,之后在Settings选项中选择 Actions -> General -> Workflow permissions 中开启读写权限
  • 重新提交:git add . -> git commit -m “blog2” -> git push
  • 等待GitHub包的自动部署,之后会构建出一个gh-pages分支, 这个就是用来看最终网页的
  • 进入Settings->Pages选项中,Brance选择gh-pages branch + /(root),保存
  • 等待刷新会看到: Your site is live at https://<用户名>.github.io/,访问即可, 部署成功用户名>
  • Github actions总是在master分支进行编译,然后把页面的html都push到gh-pages 分支下并部署到Github Pages网页

3.在本地windows环境下配置+修改Jekyll环境:

  • 下载安装RubyInstaller
  • 右键打开Git bash, 命令行安装jekyll 和 bundler
      gem install jekyll  bundler
    
  • 使用VScode打开下载的repo,打开对应的终端安装该包所需插件
      bundle install
    
  • 本地编译并查看网页,三者任选一个
      jekyll serve 
      jekyll s
      bundle exec jekyll serve
    
  • 浏览器直接访问 http://127.0.0.1:4000/
  • 如此即可随时在本地修改源代码并进行网站效果查看

    实际遇到的报错解决如下:

    • 注释+添加相应插件
      # gem 'mini_racer'
      gem 'unicode_utils'
      gem "kramdown"
      gem "kramdown-parser-gfm"
      gem "rouge"
      gem "webrick", "~> 1.7"
      gem 'wdm', '>= 0.1.0'  
      

4.个性化主题本地修改

  • News,project, blog 分别在 _news, _projects, _posts文件夹进行对比学习+修改
  • News小标题+文字的格式排版修改: 打开_includes->news.html
      <th scope="row>
      <div class="col-sm-3 p-0">
      <span class="badge primary-color-dark darken-1 font-weight-bold text-uppercase align-middle date"></span>
      </div>
      </th>
    
  • Publications修改
    • 参考模板bib,填充相应的小框及对应的问题,在_includes->bib.html可拓展展示的内容,
    • 加粗自己的名字显示格式,并注释掉more_authors相关行
        <strong>
        <span style="color:#024f92"> </span>
        </strong>
        <!-- <em> </em> -->
      
    • 相关内容放在首页,打开_pages->about文件,选择publications: true. bibtex条目中添加selected={true}
  • 其他格式修改方法:针对自己喜欢的模板,F12刷新该网页,直接看对应的代码,基本能确定静态页面的相关参数和设计。之后在自己repo里面搜索相关的设置参数进行修改

5.最终推送

  • Gemfile文件修改,回复出事的参数,不然action会报错
  • 类似步骤2,重新提交:git add . -> git commit -m “blog2” -> git push

6.TODO—将public repo改成private repo