Git Product home page Git Product logo

jekyll-example's Introduction

jekyll-example

This is a setup example for a jekyll site with bootstrap installed thanks to bower, and fully hosted on github pages.

See the blog post: http://www.aymerick.com/2014/07/22/jekyll-github-pages-bower-bootstrap.html

View the site here: http://jekyll-example.aymerick.com

Development

Install tools:

$ npm install -g grunt-cli
$ npm install -g bower
$ gem install bundle

Install dependencies:

$ npm install
$ bower install
$ bundle install

Build the site and watch for changes:

$ grunt -v

Browse http://127.0.0.1:4000

Deploy to Github Pages:

$ rake deploy

jekyll-example's People

Contributors

aymerick avatar

Stargazers

avatar avatar

Watchers

avatar avatar

Forkers

gravitywaves manuelcalerosolis hannic yosemike

jekyll-example's Issues

question

Hi aymerick, sorry about contacting you this way, this is not an issue, it is the only way I could find to contact you aside from twitter's 140 characters.

I found your tutorial/blog post about setting up jekyll with bower and grunt however, I am a little confused. Could you let me know what I am missing?

Why do you add the .nojekyll file and include it in the _config.yml? Doesn't github need to run jekyll in order to create the _site directory structure?

If the answer is executing the Rakefile from your local machine populates the _site dir, how does that work? _site is in the .gitignore so even when you run the Rakefile > grunt build > exec:jekyll > jekyll build --trace, the destination _site contents will not be pushed.

Also, I don't understand how the vendor assets are being persisted. The directory is also in the .gitignore

Thanks for the help, I really appreciate it.

Missing dependency: kramdown 

$ grunt -v
Initializing
Command-line options: --stack, --verbose

Reading "Gruntfile.coffee" Gruntfile...OK

Registering Gruntfile tasks.

Registering "grunt-bower-task" local Npm module tasks.
Reading /Users/michaeljin/git/jekyll-example/node_modules/grunt-bower-task/package.json...OK
Parsing /Users/michaeljin/git/jekyll-example/node_modules/grunt-bower-task/package.json...OK
Loading "bower_task.js" tasks...OK
+ bower

Registering "grunt-contrib-connect" local Npm module tasks.
Reading /Users/michaeljin/git/jekyll-example/node_modules/grunt-contrib-connect/package.json...OK
Parsing /Users/michaeljin/git/jekyll-example/node_modules/grunt-contrib-connect/package.json...OK
Loading "connect.js" tasks...OK
+ connect

Registering "grunt-contrib-copy" local Npm module tasks.
Reading /Users/michaeljin/git/jekyll-example/node_modules/grunt-contrib-copy/package.json...OK
Parsing /Users/michaeljin/git/jekyll-example/node_modules/grunt-contrib-copy/package.json...OK
Loading "copy.js" tasks...OK
+ copy

Registering "grunt-contrib-watch" local Npm module tasks.
Reading /Users/michaeljin/git/jekyll-example/node_modules/grunt-contrib-watch/package.json...OK
Parsing /Users/michaeljin/git/jekyll-example/node_modules/grunt-contrib-watch/package.json...OK
Loading "watch.js" tasks...OK
+ watch

Registering "grunt-exec" local Npm module tasks.
Reading /Users/michaeljin/git/jekyll-example/node_modules/grunt-exec/package.json...OK
Parsing /Users/michaeljin/git/jekyll-example/node_modules/grunt-exec/package.json...OK
Loading "exec.js" tasks...OK
+ exec
Initializing config...OK
Loading "Gruntfile.coffee" tasks...OK
+ build, default, serve

No tasks specified, running default tasks.
Running tasks: default

Running "default" task

Running "serve" task

Running "build" task

Running "copy" task

Running "copy:jquery" (copy) task
Verifying property copy.jquery exists in config...OK
Files: bower_components/jquery/dist/jquery.min.js -> vendor/js/jquery.min.js
Options: encoding="utf8", processContent=false, processContentExclude=[], mode=false
Copying bower_components/jquery/dist/jquery.min.js -> vendor/js/jquery.min.js
Reading bower_components/jquery/dist/jquery.min.js...OK
Writing vendor/js/jquery.min.js...OK
Copied 1 files

Running "copy:bootstrap" (copy) task
Verifying property copy.bootstrap exists in config...OK
Files: bower_components/bootstrap/dist/css/bootstrap.min.css -> vendor/css/bootstrap.min.css
Files: bower_components/bootstrap/dist/js/bootstrap.min.js -> vendor/js/bootstrap.min.js
Options: encoding="utf8", processContent=false, processContentExclude=[], mode=false
Copying bower_components/bootstrap/dist/css/bootstrap.min.css -> vendor/css/bootstrap.min.css
Reading bower_components/bootstrap/dist/css/bootstrap.min.css...OK
Writing vendor/css/bootstrap.min.css...OK
Copying bower_components/bootstrap/dist/js/bootstrap.min.js -> vendor/js/bootstrap.min.js
Reading bower_components/bootstrap/dist/js/bootstrap.min.js...OK
Writing vendor/js/bootstrap.min.js...OK
Copied 2 files

Running "exec:jekyll" (exec) task
Verifying property exec.jekyll exists in config...OK
File: [no files]

jekyll build --trace
Expecting exit code 0
>> WARN: Unresolved specs during Gem::Specification.reset:
>>       listen (~> 3.0)
>> WARN: Clearing out unresolved specs.
>> Please report a bug if this causes problems.
Configuration file: /Users/michaeljin/git/jekyll-example/_config.yml
            Source: /Users/michaeljin/git/jekyll-example
       Destination: /Users/michaeljin/git/jekyll-example/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
>> You are missing a library required for Markdown. Please run:
>>   $ [sudo] gem install kramdown
>>   Conversion error: Jekyll::Converters::Markdown encountered an error while converting '_posts/2014-07-22-welcome-to-jekyll.markdown':
>>                     Missing dependency: kramdown
>>              ERROR: YOUR SITE COULD NOT BE BUILT:
>>                     ------------------------------------
>>                     Missing dependency: kramdown
>> Exited with code: 1.
Warning: Task "exec:jekyll" failed. Use --force to continue.
Error: Task "exec:jekyll" failed.
    at Task.<anonymous> (/Users/michaeljin/git/jekyll-example/node_modules/grunt/lib/util/task.js:205:15)
    at null._onTimeout (/Users/michaeljin/git/jekyll-example/node_modules/grunt/lib/util/task.js:241:33)
    at Timer.listOnTimeout (timers.js:89:15)

Aborted due to warnings.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.