plusjade / jekyll-bootstrap Goto Github PK

Problem: Collate a Sub-Set of Posts doesn't support tags in non-ascii characters, for example: passé, 中文标签

How to reproduce:

add either tag to some posts then add a page with

{% include JB/setup %}
{% assign posts_collate = site.tags.passé %}
{% include JB/posts_collate %}

No post returned.

If I passed in ascii tag name (test, jekyll) then posts with that tag returned.

According to the doc, it's supposed to return a list of tagged posts
http://jekyllbootstrap.com/api/bootstrap-api.html

Collate a Sub-Set of Posts

To collate a sub-set of posts, just pass in the sub-set. Bellow, only posts tagged “jekyll” will be collated:

{% assign posts_collate = site.tags.jekyll %}
{% include JB/posts_collate %}

My website repo, website.

I made sure config.yml contained a proper Google Analytics code, switched to Twitter theme for testing, regenerated files using rake theme:switch. Tested it locally through jekyll --server and refreshed the page.

Unfortunately JB Analytics code isn't working. This:

<!-- Jekyll Bootstrap Analytics -->
{% include JB/analytics %}

<!-- hardcoded Google Analytics code -->
<script type="text/javascript">
  var _gaq = _gaq || [];                                                                                                             
  _gaq.push(['_setAccount', 'UA-29827268-2']);
  _gaq.push(['_trackPageview']);

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();
</script>

turns into:

<!-- Jekyll Bootstrap Analytics -->
<!-- hardcoded Google Analytics code -->
<script type="text/javascript">
    var _gaq = _gaq || [];
    _gaq.push(['_setAccount', 'UA-29827268-2']);
    _gaq.push(['_trackPageview']);

    (function() {
        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
    })();
</script>

Here's part of my config.yml:

  analytics :
    provider : google
    google :
        tracking_id : 'UA-29827268-2'                                               
    getclicky :
      site_id :
    mixpanel :
        token : '_MIXPANEL_TOKEN_'

It would be nice to have a built-in handler for Piwik

(http://piwik.org)

I want to remove "Pages" from navigation.
http://i.imgur.com/Or7O1.png

How exactly can I achieve this?

I found that this repository is not the code of jekyllbootstrap.com . I want to have it, because it may be helpful for my own site.

Thank you!

I think that using site.safe as flag for production mode isn't the right way to do it.

This only works on Github because it uses --safe when the site is generated. I think that the real purpose of --safe used by Github is a matter of security. This can be false outside it, e.g. on my own server, Heroku or wherever I'm deploying my site and if I want to use a custom plugin (disabled by --safe).

This generates big confusion when migrating from/to github or when developing a generic theme, I think you should find a better way (custom option?) to define a production mode

Hi,
i follow this steps (https://help.github.com/articles/setting-up-a-custom-domain-with-pages)
and set up the dns

and updated _config.yml
when i visit the site only 404 page is showing up.
alixcan.github.com
blog.alixcan.net

I installed the bootstrap and made some example posts, but I'm not sure how to reroute jekyll so that the landing page is the latest blog entry as opposed to index.md. I've scoured the website, but couldn't find the info anywhere. Removing index.md doesn't seem to help either.

My site is currently hosted on GitHub here if you want to take a look.

I try to run my site on a custom domain but i get an error, and my domain DNS seems to be pointed to the git.
http://f69.myupload.dk/getfile/1i-rPsJ7 <- DNS lookup

I must have done something wrong.

• I cloned a clean copy of the jekyll-bootstrap
• created new post with some python code
• ran jekyll --server
• went to localhost:4000, navigated to my new page
• the code is blocked and indented, but there is no syntax highlighting

For the record, I'm running on Arch with pygments installed for both python 2 and 3. pygments: true is set within _config.yml

Is there value in having a Rake task to prompt the user for the values to fill in _config.yml (along with some context like "leave this blank to ignore")?

Hello,

how can i update the repo in my pc?
i see that you have update several things (twitter 2.0) and want to update my repo with your changes...
i have to use git pull?
how can i update?

OS: Windows 7
Environment: Msys / MinGW

The root problem might actually be a ruby on msys bug but just in case anyone has the same issue I am posting this here for fellow windows hackers.

The rake theme:install task refuses to work for me, when it tries to move "_theme_packages/_tmp" to a named folder, it invariably fails. The exact command is:

mv(tmp_path, new_path)

After much testing it appears that the yaml manifest file of the theme is not being closed after manifest = YAML.load_file(manifest) is called. Thus the "_tmp" directory cannot be deleted.

The workaround is to first open the file using Ruby IO and then use YAML.load(<somefile>)

Pull request will be provided soon.

Not sure if this is just me being stupid, but there might be an issue with the default _config.yml

I set up my github page at 3martini.github.com by forking jekyll-bootstrap. I set up the _config.yml with BASE_PATH : "", which is what I understood to be correct for github pages.

I noticed that locally, the logo element linked to the page root, bringing be back to index.html, but once pushed to github, the logo would just cause the current page to reload. I traced this to theHOME_PATH variable in default.html page in the theme I was using, which is "the-minimum".

When I looked at the github source I noticed the logo's nested link was

<a href>3martini</a>

While locally it was:

<a href="/">3martini</a>

Am I just misunderstanding the instructions or is there something wrong here?

Modifying the config to use BASE_PATH : "." seems to have eliminated the problem, but I want to know if that is really a fix or just a hack.

I am not sure if this is now by design but when I type:

rake post title=”New Post Test”

As described in the Quick Start, I get the error:

Error - date format must be YYYY-MM-DD, please check you typed it correctly!

But this works fine:

rake post title="New Post Test" date="2012-03-05"

Should it default to today's date if not specified or is specifying a date now mandatory?

To reproduce:

• rake theme:switch name="twitter"
• add an image (foo.jpg) asset to assets/themes/twitter/
• modify _includes/themes/twitter/page.html to include the image path using the liquid variable {{ ASSET_PATH }}:

<div class="page-header">
  <h1>{{ page.title }} {% if page.tagline %} <small>{{ page.tagline }}</small>{% endif %}</h1>
  <img src="{{ ASSET_PATH }}/foo.jpg">
</div>

<div class="row">
  <div class="span12">
    {{ content }}
  </div>
</div>

• modify _includes/themes/twitter/default.html to include foo.jpg

  <body>

  <img src="{{ ASSET_PATH }}/media_markHenning.jpg">
    <div class="navbar">
      <div class="navbar-inner">
        <div class="container">
          <a class="brand" href="{{ HOME_PATH }}">{{ site.title }}</a>
          <ul class="nav">

• Generate a new page using rake page name="bar.html"

• Start Jekyll using jekyll --server --safe

• Navigate to http://localhost:4000

  Expected Result

• foo.jpg appears above the nav bar: screenshot

• Now, navigate to http://localhost:4000

Expected Result

• foo.jpg appears above the nav bar (from default.html template) as well as under the H1

Actual Result

• foo.jpg appears above the nav bar (from default.html template) but shows as a broken image under the H1. screenshot. The image tag is rendered as <img src="/assets/themes//foo.jpg">, missing the theme directory.

I can reproduce this issue on includes/themes/[any theme]/page.html and includes/themes/[any theme]/post.html.

If I manually set asset_path in _config.yml, it behaves as expected.

JB can support the gist integration just like gist tag in octpress?

(http://brandontilley.com/2011/01/30/gist-tag-for-jekyll.html)
and
(http://blog.55minutes.com/2012/03/liquid-gist-tag-for-jekyll/)

show the jekyll plugin way.

Hi,

I just discovered that the way "Facebook Comments" are included only works for the entire site and not for every single post.

The file _includes/JB/comments-providers/facebook has to be changed to the following to fix this issue:

<div id="fb-root"></div>
<script>
    (function(d, s, id) {
        var js, fjs = d.getElementsByTagName(s)[0];
        if (d.getElementById(id)) return;
        js = d.createElement(s); js.id = id;
        js.src = "//connect.facebook.net/en_US/all.js#xfbml=1&appId={{ site.JB.comments.facebook.appid }}";
        fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'facebook-jssdk'));
</script>
<div class="fb-comments" data-href="{{ site.production_url }}{{ page.url }}" data-num-posts="{{ site.JB.comments.facebook.num_posts }}" data-width="{{ site.JB.comments.facebook.width }}" data-colorscheme="{{ site.JB.comments.facebook.colorscheme }}"></div>

I only changed data-href="{{ site.production_url }}" to data-href="{{ site.production_url }}{{ page.url }}".

I am writing a post in markdown and include an image which is located in images/pic1.png:

![This is an image][img-ref]

[img-ref]: /images/pic1.png

This works fine when running locally but when published to GitHubs project pages the image url does not work as expected.

When I change the ref to [img-ref]: {{ BASE_PATH }}/images/pic1.png it also works locally but not on GitHub.

When I change the ref to [img-ref]: {{ site.JB.BASE_PATH }}/images/pic1.png it works both locally and on Github but always (also when developing locally) inserts the link to the image hosted on GitHub.

So what is the correct usage of BASE_PATH in posts (and also pages)?

Thanks!

How to reproduce:

1. clone jekyll-boostrap repo
2. edit _config.yml, set base_path : http://example.org/test
3. edit hosts to make example.org points to 0.0.0.0
4. copy a few posts into _posts
5. make a index.md file in jekyll-boostrap root, with following content:

      ---                                                                      
      layout: page                                                             
      title: index.md                                                          
      ---                                                                      
      {% include JB/setup %}                                                   


      Recent Posts                                             
     {% for post in site.posts limit: 30 %}                                   
               <a href="{{ BASE_PATH  }}{{ post.url }}">{{ post.title }}</a>              
     {% endfor %}                                                             

1. run jekyll with jekyll /destination/to/example.org/root/test/
2. point browser to example.org/test/index.html

What you see:

1. all links to individual posts are without /test, they are http://0.0.0.0/2009/10/28/90 instead of http://0.0.0.0/test/2009/10/28/90
2. ASSET_PATH didn't get the BASE_PATH either. So no css and image assets are loaded.
3. the actual files are in /test and can be accessed through http://0.0.0.0/test/2009/10/28/90
4. on individual post, previous/next page links without BASE_PATH. In the theme file, they have that vairable set : {{ BASE_PATH }}{{ page.previous.url }}

when i am trying to install it with gem install jekyll i get this

Invalid gemspec in [/var/lib/gems/1.8/specifications/directory_watcher-1.4.1.gemspec]: invalid date format in specification: "2011-08-30 00:00:00.000000000Z"
Invalid gemspec in [/var/lib/gems/1.8/specifications/directory_watcher-1.4.1.gemspec]: invalid date format in specification: "2011-08-30 00:00:00.000000000Z"
Successfully installed directory_watcher-1.4.1
Successfully installed jekyll-0.11.2
2 gems installed
Installing ri documentation for directory_watcher-1.4.1...
Installing ri documentation for jekyll-0.11.2...
Installing RDoc documentation for directory_watcher-1.4.1...
Installing RDoc documentation for jekyll-0.11.2...

Since you (wisely) rely so heavily on Bootstrap for theming and customization, it would be awesome to support a CSS framework such as Sass or LESS.

I use this gist as a plugin and it works like magic: https://gist.github.com/960150

On another note, extending the notion of a theme to also include stuff for _plugins would come in handy for this and other purposes.

I ported the new Dinky theme to JB:

http://github.com/sodabrew/theme-dinky

I'm using This Liquid Tag to display math equations on jekyll-bootstrap blog. I'm able to run jekyll at localhost and everything just works fine. However after pushing posts with math tags to github-pages, github just tells me

The page build failed with the following error:
unable to run jekyll

How do i add paginations to my git?
http://pyroslab.net/blog.html

is this possible?

I'm deploying Jekyll-bootstrap on Heroku cedar (it needs Gemfile instead of .gems) and the S3 server fails in serving bootstrap.min.css. The file can be opened by source view, but Firebug gives an error about the file (The file isn't text).
The same site deployed with pure rack (using Rack::TryStatic), works fine.
Using the official bootstrap.css instead of bootstrap.min.css provided by jekyll-bootstrap, the css sometimes is correctly loaded.
You can see the errors at http://smooth-waterfall-6329.herokuapp.com/
Heroku gives randomly this error:

Rack::Lint::LintError at /
No Content-Type header found
Ruby    /app/vendor/bundle/ruby/1.9.1/gems/rack-1.2.5/lib/rack/lint.rb: in assert, line 19
Web     GET smooth-waterfall-6329.herokuapp.com

I open this bug both to rack-jekyll and jekyll-bootstrap because I'm not sure where's the problem

I'm attempting to install a new theme into my fresh bootstrap clone, via the following command:

rake theme:install git="git://github.com/jekyllbootstrap/theme-the-minimum.git"

But when run, I get:

Cloning into './_theme_packages/_tmp'...
fatal: write error: Invalid argument
rake aborted: system call to git clone failed

I don't see why this is failing, git is in my windows path variable and definitely works from the command prompt?

I'm trying to get Jekyll up and running on my Windows 7 computer. All the dependencies installed successfully on Jekyll. When I run jekyll --server I get this problem:

PS C:\Path\To\Folder> jekyll --server
C:/Ruby193/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require': iconv will be deprecated in the future, use String
#encode instead.
Configuration from C:/Path/To/Folder/_config.yml
C:/Ruby193/lib/ruby/gems/1.9.1/gems/directory_watcher-1.4.1/lib/directory_watcher/em_scanner.rb:10:in `block in <top (re
quired)>': undefined method `epoll' for EventMachine:Module (NoMethodError)
        from C:/Ruby193/lib/ruby/gems/1.9.1/gems/directory_watcher-1.4.1/lib/directory_watcher/em_scanner.rb:10:in `each
'
        from C:/Ruby193/lib/ruby/gems/1.9.1/gems/directory_watcher-1.4.1/lib/directory_watcher/em_scanner.rb:10:in `<top
 (required)>'
        from C:/Ruby193/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require'
        from C:/Ruby193/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require'
        from C:/Ruby193/lib/ruby/gems/1.9.1/gems/directory_watcher-1.4.1/lib/directory_watcher.rb:589:in `block in <top
(required)>'
        from C:/Ruby193/lib/ruby/gems/1.9.1/gems/directory_watcher-1.4.1/lib/directory_watcher.rb:269:in `call'
        from C:/Ruby193/lib/ruby/gems/1.9.1/gems/directory_watcher-1.4.1/lib/directory_watcher.rb:269:in `libpath'
        from C:/Ruby193/lib/ruby/gems/1.9.1/gems/directory_watcher-1.4.1/lib/directory_watcher.rb:586:in `<top (required
)>'
        from C:/Ruby193/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require'
        from C:/Ruby193/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require'
        from C:/Ruby193/lib/ruby/gems/1.9.1/gems/jekyll-0.11.2/bin/jekyll:228:in `<top (required)>'
        from C:/Ruby193/bin/jekyll:19:in `load'
        from C:/Ruby193/bin/jekyll:19:in `<main>'

I've tried running --server on some other cloned Jekyll repos to see if it was a problem with Jekyll itself, but it worked perfectly for the repos I tried.

Hi,
Most twitter bootstrap sites have the header glued to top of the browser window. The default jekyll bootstrap does not, how do I enable it in the css?

thanks,
Jake

Running

rake post title="[Some text] $PATH [other text]

results in an error saying that the post's title is too long because $PATH has been interpreted and the resulting title is "some-text-really_long_text_containing_everything_in_your_path_variable-other-text".

Updating rubygems-update
Successfully installed rubygems-update-1.8.24
ERROR: While executing gem ... (Errno::ENOENT)
No such file or directory - /usr/lib/ruby/gems/1.9.1/gems/rubygems-update-1.8.24
why? can you help me ? I am using Archlinux, want to install Jekyll

I notice people search for how to order page and post lists in Jekyll Bootstrap. Just so there is a place where this question is answered:

There is currently no way to pragmatically order pages or posts.

The posts are ordered chronologically, while the pages are ordered alphabetically (to my knowledge).

The only way to create your own order is to manually create an array in the _config.yml or YAML Front Matter pointing to the post/page urls, then iterate over that array.

This is one of the biggest drawbacks to sticking with the Jekyll framework. I'm currently scheming a solution for this =)

web: http://themes.jekyllbootstrap.com

source: https://github.com/plusjade/themes.jekyllbootstrap.com

Users can explore available Jekyll-Bootstrap themes. Need to work out an easy API for publishing themes into the Explorer.

Right now I use a rake generate_themes which generates the sample website for all available themes and places them in the preview folder. Nifty javascript takes care of the rest.

Thoughts?

• How's the UI?
• Suggestions?
• How to publish user contributed themes?

Hi all, I'm currently working on major updates in the framework-beta branch
I haven't started on upgrading the documentation so I recommend reading the commit messages to get a handle for what I've been up to.

I'd like anyone interested (@swanson) to provide feedback on the updates. Mainly if you agree/disagree and of course design recommendations/suggestions.

Main Additions

All Jekyll bootstrap include helpers are now name-spaced into _includes/JB

Additionally the "helpers" have been flattened out into the JB directory. This improves the simplicity of the API. i.e. Calling a helper is a much shorter syntax:

{% include JB/comments %} 
...
{% assign pages_list = site.pages %} {% include JB/pages_list %}

All JB helpers can be overridden

I've added the ability to define custom versions of all helpers so users don't need to edit the JB source. This is very important for versioning and upgrading. The current API is to set a helper "engine" to custom then create a file having the same name as the helper in _includes/custom/

Comments and analytics integration

Finally got around to adding integration for the most common commenting and analytics engines.

Support for dynamic paths.

I've elected to dynamically define the liquid variables: BASE_PATH and ASSET_PATH.
The framework now expects all links to be prepended with BASE_PATH.

Benefits

This feature enables GitHub "project" pages to be supported (just assign BASE_PATH to the project name).

Regardless of the settings, localhost will always run from root "/". When you push to GitHub, JB reads the site.safe flag and sets BASE_PATH for "production mode".

Using site.baseurl achieves similar subdirectory support but I really do not like having to remember to go to http://localhost:4000/repo-name

Drawbacks

All pages/post have to include JB/setup in order to use the variables. (this is automatically done when using the rake tasks)

New rake tasks for page and post creation

@pradeep1288 kindly added a rake new_post task to which I added another for creating a page.
I've renamed both to just rake post and rake page so as to be a "faster" way to publish.
Additionally I've switched to passing ENV variables over rake arguments.

Thanks!

Until I finish the new docs, more explanation can be found in the config.yml file:
https://github.com/plusjade/jekyll-bootstrap/blob/framework-beta/_config.yml

Thanks in advance for any feedback/advice/suggestions you can give.
Also would be great to point out potential edge-cases.

Thanks!

This isn't a issue as much as a question.

Is there a way to get custom page urls? I know in the config file you can a post's permalink, but what about pages.

I'd really like to get rid of the .html.

I'm on a 12" 1024x768, and the left-side navigation bar obscures some of the text. Example:

I have used a subdomain blog.genlinux.org which i am owing in CNAME.But the page is not showing up.Is there any issue with sub domain

There is no obvious way to upgrade Jekyll-Bootstrap versions.

Branch: master
os: windows 7

When attempting to run rake theme:install git=" some_theme " install fails and this error is displayed:

rake aborted: repo must contain valid manifest

It appears the rake task cannot find the manifest in the verify_manifest function.

hi there,

I write pages much more than posts, the directory hierarchy looks like:

projects
|-- projectA
|   `-- index.md
|   |-- A-1
|   |   `-- index.md
|   |   `-- a.md
|   |   `-- b.md
|   |   `-- c.md
|   |-- A-2
|   |   `-- index.md
|   |   `-- a.md
|   |   `-- b.md
|   |   `-- c.md
|-- projectB
|   `-- index.md

so how can i automatically fill all the index.md with a list of its sibling files?

should I write a helper for this? or what is the best practice?

Thank you

When I set the following in _config.yml:

provider : google

 tracking_id : 'UA-nnnnnnnn-n'

(I use my real tracking ID though)

I do not see any tracking code added to any pages or posts (or anything?) when I run Jekyll to regen the _site

git also does not report any changes to content pages. (maybe atom.xml but not sure if related to this cfg change I made).

Am I doing something wrong or is this just not working?

when I type

$ rake post title="Hello, Jekyll!"

with a exclamation mark (!) in the title, the command line returns

-bash !": event not found

How to solve it?

setup has one minor error

With gh-pages being:

http:/username.github.com/project-name/

or

http://username.github.com

the slash before the lowercase assets is a problem

I have verified the first case with username.github.com/project-name/

I have not fully verified if same correction will work for the 2nd case..but it probably will

Hi there!

I noticed on the main page of jekyll-bootstrap, the following image tag is 404'ing. Just wanted to give a heads up.

<img src="http://ruhoh.com/_media/first-post.jpg" style="display:block; margin:auto">

how do I use the subnav class with my pages in JB?

any way to break up {{ content }} into multiple parts?

I set BASE_PATH in _config.yml.

BASE_PATH : "http://example.jp/jekyll/test/_site"
or
BASE_PATH : /jekyll/test/_site

But, path in generated contents are "/${contents} .

<link href="/assets/themes/twitter/css/1.4.0/bootstrap.css" rel="stylesheet">
<link href="/assets/themes/twitter/css/style.css?body=1" rel="stylesheet" type="text/css" media="all">
<li><a href="/tags.html">Tags</a></li>
<li><a href="/pages.html">Pages</a></li>
<li><a href="/archive.html">Archive</a></li>

Is this problem ?

ASSET_PATH is usefull.

This is a feature request. Jekyll would be so much more usable if there were a command line or downloadable "boilerplate" generator to set up a base directory structure.

One whose Ruby version >= 1.9 don't have to "require "rubygems"" in their Rakefile.
See http://docs.rubygems.org/read/chapter/3/