Question

我正在尝试设置项目页面using githubs pages functionality。

我正在使用捆绑器install jekyll as shown in the instructions，但它会产生以下错误：

$ bundle exec jekyll serve
Notice: for 10x faster LSI support, please install http://rb-gsl.rubyforge.org/
Configuration file: none
            Source: /Users/sowen/Code/all-spark-cube
       Destination: /Users/sowen/Code/all-spark-cube/_site
      Generating... 
             ERROR: YOUR SITE COULD NOT BE BUILT:
                    ------------------------------------
                    Post '/vendor/ruby/2.1.0/gems/jekyll-2.2.0/lib/site_template/0000-00-00-welcome-to-jekyll.markdown.erb' does not have a valid date. Fix the date, or exclude the file or directory from being processed

我尝试使用ruby 2.0.0进行全新的OsX安装。我也尝试使用rvm安装ruby 2.1.1，结果相同。

以下是我采取的步骤：

ruby --version
ruby 2.1.1p76 (2014-02-24 revision 45161) [x86_64-darwin12.0]

$ cd ~/Code/all-spark-cube

$ cat Gemfile
source 'https://rubygems.org'
gem 'github-pages'

$  bundle install
$ ...

这会产生以下目录结构

$ tree -L 1
.
├── Gemfile
├── Gemfile.lock
└── vendor

奇怪的是，上面提到的文件（000-00-00-welcome-to-jekyll ..）在显示的位置不存在。我确实在vendor/ruby/2.1.0/gems/jekyll-2.2.0/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb找到了它我尝试删除并重命名它没有运气。

同样奇怪的是它指的是绝对路径/vendor/而不是相对路径vendor/。

搜索谷歌，我能找到一些提到此错误的资源，但是我无法解决这个问题。这是gem，文档还是我的配置问题？

http://www.markcampbell.me/jekyll/heroku/2013/05/18/how-to-set-up-jekyll-on-heroku.html

Answer 1

运行bundler仅适用于已经拥有带有jekyll include的gemfile的项目。对于全新的项目，您需要运行gem install jekyll。

开始安装jekyll的更好的地方是http://jekyllrb.com/。

在本地安装Jekyll并创建新网站（jekyll new）后，您可以创建一个git存储库（git init），然后将其推送到GitHub。

Answer 2

该错误是由于您在安装Jekyll的同一目录中生成了您的站点。

为避免错误，请将此行添加到您的网站_config.yml文件中：

exclude: [vendor]

更好的解决方案是将您的网站部署在Jekyll文件夹的子目录中：

使用Bundler以与您已经完成相同的方式安装Jekyll
使用以下内容在子文件夹中创建您的网站：bundle exec jekyll new ./all-spark-cube --force
导航到您创建网站的子文件夹并在本地运行您的Jekyll网站：bundle exec jekyll serve

当您将网站代码推送到github时，第二个解决方案将有助于保持您的网站代码清洁

你如何用jekyll设置github.io页面？

2 个答案: