Important: this article is not released under a Creative Commons license and may not be copied or redistributed in any form. Please use our contact page to get in touch with us if you wish to reproduce the article.

Accessing Bootstrap docs offline + Installing Jekyll on Ubuntu 13.10


Nitin Venkatesh's Gravatar

Nitin Venkatesh
published Feb. 1, 2014, 9:52 a.m.


Yesterday night, my internet crapped out on me and I was offline the whole night without any access to the Bootstrap documentation online. It's easy if you Jekyll installed on your machine properly, so let's deal with installing it on Ubuntu 13.10 first.

Installing Jekyll on Ubuntu 13.10:

The jekyll package present by default in the Ubuntu repositories is a bit outdated and causes errors with the redcarpet module whose default repo version is also a bit outdated.

So here's installing Ruby:

sudo apt-get install ruby1.9.1-dev

And then, we install Jekyll using the gem:

sudo gem install jekyll

If you still have issues with redcarpet not rendering the CSS and formatting and all:

sudo gem install redcarpet

And that's it, you're all set.

<hr>

Accessing Bootstrap Docs:

Assuming you have the Bootstrap Source downloaded and unzipped, (mine is unzipped in my home directory under the name of bs), you just need to cd into it and run jekyll serve . Now you can access the documentation from localhost:9001 or whatever, depending on the Jekyll configuration. (Jekyll will tell it to you in the output it produces when you run it).

nitin@jane-saucy:~$ cd bs/
nitin@jane-saucy:~/bs$ jekyll serve
Configuration file: /home/nitin/bs/_config.yml
            Source: /home/nitin/bs
       Destination: ./_gh_pages
      Generating... done.
 Auto-regeneration: enabled
    Server address: http://0.0.0.0:9001
  Server running... press ctrl-c to stop.

<hr>

Screenshots:

jekyll-running-screenshot

bootstrap-doc-screenshot

Cross-posted from Nitin's Blog