New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

3.0 RELEASE GAMEPLAN #3324

Closed
parkr opened this Issue Jan 18, 2015 · 44 comments

Comments

Projects
None yet
@parkr
Member

parkr commented Jan 18, 2015

I have written about what I'd like to see for Jekyll 3.0. That post is now a month and a half old. I'd like to get Jekyll 3.0 out the door in Q1 2015 to bring all the amazingness we have been cooking out to you excellent Jekyll users and developers. Check lists usually help me more than anything else, so here's what I'd like to accomplish:

  • Incremental regeneration ( #3116 )
  • Integrate basic hooks (potentially via @imathis's Octopress::Hooks work) ( #3392, #3553. )
  • Switch over to Rouge as default syntax highlighter, dropping hard dependency on Python ( #3323 )
  • Drop hard dependency on ExecJS runtime (e.g. Node) ( #3323 )
  • Make most dependencies optional and handle their absence gracefully ( #3323 )
  • Upgrading to Liquid 3 & adding optional liquid-c support ( #3002 )
  • Make _posts a default collection (& therefore simplify the internals) ( #3169, #3690 )
  • Remove Convertible.
  • Automated Windows tests? ( #3115 )

Anything else you'd like to see?

@parkr parkr added this to the 3.0 milestone Jan 18, 2015

@imathis

This comment has been minimized.

Show comment
Hide comment
@imathis

imathis Jan 18, 2015

Contributor

Everything here looks so great. I'll be especially excited to hooks come to Jekyll. Anything to get rid of all the monkey-patching we do for plugins!

Contributor

imathis commented Jan 18, 2015

Everything here looks so great. I'll be especially excited to hooks come to Jekyll. Anything to get rid of all the monkey-patching we do for plugins!

@paulrobertlloyd

This comment has been minimized.

Show comment
Hide comment
@paulrobertlloyd

paulrobertlloyd Jan 18, 2015

Contributor

This looks great. In terms of supporting plug-ins, it would be nice-to-have a more fully featured jekyll-paginate be released around the same time (i.e. having the ability to paginate practically any group of posts). Pagination I think is the only area from a templating perspective where Jekyll still suffers slightly.

Contributor

paulrobertlloyd commented Jan 18, 2015

This looks great. In terms of supporting plug-ins, it would be nice-to-have a more fully featured jekyll-paginate be released around the same time (i.e. having the ability to paginate practically any group of posts). Pagination I think is the only area from a templating perspective where Jekyll still suffers slightly.

@pepelsbey

This comment has been minimized.

Show comment
Hide comment
@pepelsbey

pepelsbey Jan 18, 2015

+1 for pagination issues.

pepelsbey commented Jan 18, 2015

+1 for pagination issues.

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Jan 18, 2015

Member

Pagination chat should be had over at: https://github.com/jekyll/jekyll-paginate But thanks for the input.

Member

parkr commented Jan 18, 2015

Pagination chat should be had over at: https://github.com/jekyll/jekyll-paginate But thanks for the input.

@IainIsCreative

This comment has been minimized.

Show comment
Hide comment
@IainIsCreative

IainIsCreative Jan 18, 2015

Rouge seems like a nice idea, but frankly, I'd like to see if my code blocks can be written out as lists and not using table. Does Rouge support that or are there other methods it provides?

IainIsCreative commented Jan 18, 2015

Rouge seems like a nice idea, but frankly, I'd like to see if my code blocks can be written out as lists and not using table. Does Rouge support that or are there other methods it provides?

@alfredxing

This comment has been minimized.

Show comment
Hide comment
@alfredxing

alfredxing Jan 18, 2015

Member

👍

We should probably get working on Make _posts a default collection (& therefore simplify the internals) & remove Convertible. Related issue is #3169.

Member

alfredxing commented Jan 18, 2015

👍

We should probably get working on Make _posts a default collection (& therefore simplify the internals) & remove Convertible. Related issue is #3169.

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Jan 18, 2015

Member

@iainspad If you open an issue on jneen/rouge, I'm sure they can get you sorted. :)

Member

parkr commented Jan 18, 2015

@iainspad If you open an issue on jneen/rouge, I'm sure they can get you sorted. :)

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Jan 18, 2015

Member

We should probably get working on Make _posts a default collection (& therefore simplify the internals) & remove Convertible. Related issue is #3169.

@alfredxing I was going to wait until @envygeeks landed #3305 his rebase nightmares aren't epic.

Member

parkr commented Jan 18, 2015

We should probably get working on Make _posts a default collection (& therefore simplify the internals) & remove Convertible. Related issue is #3169.

@alfredxing I was going to wait until @envygeeks landed #3305 his rebase nightmares aren't epic.

@alfredxing

This comment has been minimized.

Show comment
Hide comment
@alfredxing

alfredxing Jan 18, 2015

Member

#3224 (using Liquid::Drop) would also be great if it can be done.

Member

alfredxing commented Jan 18, 2015

#3224 (using Liquid::Drop) would also be great if it can be done.

@erlend-sh

This comment has been minimized.

Show comment
Hide comment
@erlend-sh

erlend-sh Jan 18, 2015

Contributor

I'm probably just confused by semantics here.

Make _posts a default collection

Does that include Pages as well then?

Contributor

erlend-sh commented Jan 18, 2015

I'm probably just confused by semantics here.

Make _posts a default collection

Does that include Pages as well then?

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Jan 18, 2015

Member

Does that include Pages as well then?

This is a tougher sell for me – each page is meant to be a separate entity. It therefore doesn't really make sense to join them together into a collection. That being said, we provide site.pages in Liquid, which is a simple array of Page objects. So as it happens we already give the user access to a "list" of pages. Now, whether we want to go one step further and allow all the various add-on features of a collection is not necessarily the case. I'll definitely revisit this once we have a _posts collection to see if we can swing it. :)

Member

parkr commented Jan 18, 2015

Does that include Pages as well then?

This is a tougher sell for me – each page is meant to be a separate entity. It therefore doesn't really make sense to join them together into a collection. That being said, we provide site.pages in Liquid, which is a simple array of Page objects. So as it happens we already give the user access to a "list" of pages. Now, whether we want to go one step further and allow all the various add-on features of a collection is not necessarily the case. I'll definitely revisit this once we have a _posts collection to see if we can swing it. :)

@erlend-sh

This comment has been minimized.

Show comment
Hide comment
@erlend-sh

erlend-sh Jan 20, 2015

Contributor

I see (sort of). The problem probably lies in my trying to understand Collections through the lens of my pre-existing notions of "Custom Post Types" in WordPress.

Contributor

erlend-sh commented Jan 20, 2015

I see (sort of). The problem probably lies in my trying to understand Collections through the lens of my pre-existing notions of "Custom Post Types" in WordPress.

@envygeeks

This comment has been minimized.

Show comment
Hide comment
@envygeeks

envygeeks Jan 20, 2015

Contributor

I thought Wordpress finally had the notion of pages that are actually pages? I've not used it in a few years but I thought back then it did have that concept.

Contributor

envygeeks commented Jan 20, 2015

I thought Wordpress finally had the notion of pages that are actually pages? I've not used it in a few years but I thought back then it did have that concept.

@pathawks

This comment has been minimized.

Show comment
Hide comment
@pathawks

pathawks Jan 20, 2015

Member

I thought Wordpress finally had the notion of pages that are actually pages?

Yup.

Member

pathawks commented Jan 20, 2015

I thought Wordpress finally had the notion of pages that are actually pages?

Yup.

@felixdorner

This comment has been minimized.

Show comment
Hide comment
@felixdorner

felixdorner commented Jan 22, 2015

+1 for tags

@kaatt

This comment has been minimized.

Show comment
Hide comment
@kaatt

kaatt Jan 24, 2015

Contributor

How do I use the beta with jekyll-redirect-from plugin?

I get this:

/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib/ruby/2.0.0/rubygems/specification.rb:2007:in `raise_if_conflicts': Unable to activate jekyll-redirect-from-0.6.2, because jekyll-3.0.0.pre.beta1 conflicts with jekyll (~> 2.0) (Gem::LoadError)

Contributor

kaatt commented Jan 24, 2015

How do I use the beta with jekyll-redirect-from plugin?

I get this:

/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib/ruby/2.0.0/rubygems/specification.rb:2007:in `raise_if_conflicts': Unable to activate jekyll-redirect-from-0.6.2, because jekyll-3.0.0.pre.beta1 conflicts with jekyll (~> 2.0) (Gem::LoadError)

@envygeeks

This comment has been minimized.

Show comment
Hide comment
@envygeeks

envygeeks Jan 24, 2015

Contributor

@KATT fork the gem you are trying to use and edit the *.gemspec and then tell your Gemfile to use the gem you forked either via :path or :github (if you host it on Github.)

Side Note: Next time please file an individual ticket for your problem.

Contributor

envygeeks commented Jan 24, 2015

@KATT fork the gem you are trying to use and edit the *.gemspec and then tell your Gemfile to use the gem you forked either via :path or :github (if you host it on Github.)

Side Note: Next time please file an individual ticket for your problem.

@nternetinspired

This comment has been minimized.

Show comment
Hide comment
@nternetinspired

nternetinspired Jan 25, 2015

Contributor

Anything else you'd like to see?

gh-pages friendly tags!

Contributor

nternetinspired commented Jan 25, 2015

Anything else you'd like to see?

gh-pages friendly tags!

@kaatt

This comment has been minimized.

Show comment
Hide comment
@kaatt

kaatt Jan 25, 2015

Contributor

Thanks a lot Jordon but still having trouble: #3353

Contributor

kaatt commented Jan 25, 2015

Thanks a lot Jordon but still having trouble: #3353

@ivanjuras

This comment has been minimized.

Show comment
Hide comment
@ivanjuras

ivanjuras Jan 26, 2015

@parkr Is there any chance that we are going to see full Jade support in the near future? it actually saves a lot of time, and makes it so much easier on the eyes. Thanks!

ivanjuras commented Jan 26, 2015

@parkr Is there any chance that we are going to see full Jade support in the near future? it actually saves a lot of time, and makes it so much easier on the eyes. Thanks!

@sondr3

This comment has been minimized.

Show comment
Hide comment
@sondr3

sondr3 Jan 27, 2015

Contributor

Given that Jade is a Node templating language and 3.0 is cutting away lots of non-Ruby dependencies I doubt that'll happen.

Contributor

sondr3 commented Jan 27, 2015

Given that Jade is a Node templating language and 3.0 is cutting away lots of non-Ruby dependencies I doubt that'll happen.

@cmegown

This comment has been minimized.

Show comment
Hide comment
@cmegown

cmegown Jan 27, 2015

The idea of removing non-Ruby dependencies is a big +1 for me. The whole reason I've fallen in love with Jekyll is that I can craft everything (almost) exactly how I want. Part of that is writing code, but another part is also managing the environment in which you write that code. Minimal non-Ruby dependencies will help greatly with that.

cmegown commented Jan 27, 2015

The idea of removing non-Ruby dependencies is a big +1 for me. The whole reason I've fallen in love with Jekyll is that I can craft everything (almost) exactly how I want. Part of that is writing code, but another part is also managing the environment in which you write that code. Minimal non-Ruby dependencies will help greatly with that.

@rschwietzke

This comment has been minimized.

Show comment
Hide comment
@rschwietzke

rschwietzke Jan 28, 2015

Default Less support as well as localization would be high on my list. Especially localization caused quite some headache. We used https://github.com/screeninteraction/jekyll-multiple-languages-plugin but it is not truly part of the concept and has rough edges.

rschwietzke commented Jan 28, 2015

Default Less support as well as localization would be high on my list. Especially localization caused quite some headache. We used https://github.com/screeninteraction/jekyll-multiple-languages-plugin but it is not truly part of the concept and has rough edges.

@erlend-sh

This comment has been minimized.

Show comment
Hide comment
@erlend-sh

erlend-sh Jan 29, 2015

Contributor

I'm verging off topic here, but @rschwietzke did you try this?
http://www.developmentseed.org/blog/multilingual-jekyll-sites/

It takes the convention over configuration approach. I haven't tested it with collections but I imagine it would be compatible.

Contributor

erlend-sh commented Jan 29, 2015

I'm verging off topic here, but @rschwietzke did you try this?
http://www.developmentseed.org/blog/multilingual-jekyll-sites/

It takes the convention over configuration approach. I haven't tested it with collections but I imagine it would be compatible.

@rschwietzke

This comment has been minimized.

Show comment
Hide comment
@rschwietzke

rschwietzke Jan 29, 2015

@erlend-sh Does not look convincing. I could not find an example, find the explanation a little confusing what to put where. This is another one: https://github.com/drallgood/jekyll-multilingual I guess it is time to ingrate that into Jekyll and find a good concept that covers everything. I am not a Ruby guy, but I could write the spec.

rschwietzke commented Jan 29, 2015

@erlend-sh Does not look convincing. I could not find an example, find the explanation a little confusing what to put where. This is another one: https://github.com/drallgood/jekyll-multilingual I guess it is time to ingrate that into Jekyll and find a good concept that covers everything. I am not a Ruby guy, but I could write the spec.

@erlend-sh

This comment has been minimized.

Show comment
Hide comment
@erlend-sh

erlend-sh Jan 29, 2015

Contributor

True, it's still a lot to take in. I guess bottom line is I fully agree: standardised localization would be great. It's immensely useful for multi-lingual documentation, which needs to be very self-explanatory since there are so many chefs involved.

Contributor

erlend-sh commented Jan 29, 2015

True, it's still a lot to take in. I guess bottom line is I fully agree: standardised localization would be great. It's immensely useful for multi-lingual documentation, which needs to be very self-explanatory since there are so many chefs involved.

@rschwietzke

This comment has been minimized.

Show comment
Hide comment
@rschwietzke

rschwietzke Jan 29, 2015

@erlend-sh Agreed. Let's make it a 3.1 feature and maybe the only one. It will take Jekyll to the next level and removes the need for a lot of customization.

Shall I write down my conceptual ideas? As mentioned, I am into Java and have my problems with Ruby. Any specific place I should add the requirement ideas to?

rschwietzke commented Jan 29, 2015

@erlend-sh Agreed. Let's make it a 3.1 feature and maybe the only one. It will take Jekyll to the next level and removes the need for a lot of customization.

Shall I write down my conceptual ideas? As mentioned, I am into Java and have my problems with Ruby. Any specific place I should add the requirement ideas to?

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Jan 29, 2015

Member

Open a separate issue with a list of checkboxes, each one being a requirement. We'll talk about it there.

Member

parkr commented Jan 29, 2015

Open a separate issue with a list of checkboxes, each one being a requirement. We'll talk about it there.

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Jan 31, 2015

Member

I've dropped the dependencies and made them all opt-in. We need documentation for that (an upgrading doc!) so people can continue to use all the plugins without too much annoyance. The gem now only includes:

  • liquid
  • mercenary
  • kramdown
  • safe_yaml
  • colorator
  • rouge
  • jekyll-sass-converter
  • jekyll-watch

which is about half as many gems as before. Yay! Removing pygments.rb dropped the hard dependency on Python, and removing jekyll-coffeescript dropped the hard dependency on NodeJS/ExecJS runtime. This will be part of the second beta, to come out in the coming week.

Working on Hooks now, then we're just about finished!

Member

parkr commented Jan 31, 2015

I've dropped the dependencies and made them all opt-in. We need documentation for that (an upgrading doc!) so people can continue to use all the plugins without too much annoyance. The gem now only includes:

  • liquid
  • mercenary
  • kramdown
  • safe_yaml
  • colorator
  • rouge
  • jekyll-sass-converter
  • jekyll-watch

which is about half as many gems as before. Yay! Removing pygments.rb dropped the hard dependency on Python, and removing jekyll-coffeescript dropped the hard dependency on NodeJS/ExecJS runtime. This will be part of the second beta, to come out in the coming week.

Working on Hooks now, then we're just about finished!

@migurski

This comment has been minimized.

Show comment
Hide comment
@migurski

migurski Feb 1, 2015

Quietly watching this from a distance, 👍 to dropping dependencies. Really excited to see 3.0 in the world.

migurski commented Feb 1, 2015

Quietly watching this from a distance, 👍 to dropping dependencies. Really excited to see 3.0 in the world.

@bcomnes

This comment has been minimized.

Show comment
Hide comment
@bcomnes

bcomnes Feb 2, 2015

Contributor

Is possible to drop the nokogiri dependance? That thing always throws build errors, not to mention stalls travis-ci for ages.

Contributor

bcomnes commented Feb 2, 2015

Is possible to drop the nokogiri dependance? That thing always throws build errors, not to mention stalls travis-ci for ages.

@envygeeks

This comment has been minimized.

Show comment
Hide comment
@envygeeks

envygeeks Feb 2, 2015

Contributor

If nokogiri trows build errors I suggest you take it up with upstream.

Contributor

envygeeks commented Feb 2, 2015

If nokogiri trows build errors I suggest you take it up with upstream.

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Feb 2, 2015

Member

Is possible to drop the nokogiri dependance? That thing always throws build errors, not to mention stalls travis-ci for ages.

@bcomnes We don't depend upon Nokogiri. Some of our optional plugins do (jemoji, jekyll-mentions), and Travis can be sped up by adding the environment variable NOKOGIRI_USE_SYSTEM_LIBRARIES=true and by enabling the cache (cache: bundler).

Member

parkr commented Feb 2, 2015

Is possible to drop the nokogiri dependance? That thing always throws build errors, not to mention stalls travis-ci for ages.

@bcomnes We don't depend upon Nokogiri. Some of our optional plugins do (jemoji, jekyll-mentions), and Travis can be sped up by adding the environment variable NOKOGIRI_USE_SYSTEM_LIBRARIES=true and by enabling the cache (cache: bundler).

@bcomnes

This comment has been minimized.

Show comment
Hide comment
@bcomnes

bcomnes Feb 2, 2015

Contributor

Can I make note of those tips in the docs?

Contributor

bcomnes commented Feb 2, 2015

Can I make note of those tips in the docs?

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Feb 2, 2015

Member

Can I make note of those tips in the docs?

We mention the nokogiri one here: http://jekyllrb.com/docs/continuous-integration/ but you can include the cache and explain it if you want.

Member

parkr commented Feb 2, 2015

Can I make note of those tips in the docs?

We mention the nokogiri one here: http://jekyllrb.com/docs/continuous-integration/ but you can include the cache and explain it if you want.

@bcomnes

This comment has been minimized.

Show comment
Hide comment
@bcomnes

bcomnes Feb 2, 2015

Contributor

Cool, will do.

Contributor

bcomnes commented Feb 2, 2015

Cool, will do.

@rodrigobraga

This comment has been minimized.

Show comment
Hide comment
@rodrigobraga

rodrigobraga Feb 3, 2015

Hi guys!

Exists plans to make a official image from Jekyll to Docker?

rodrigobraga commented Feb 3, 2015

Hi guys!

Exists plans to make a official image from Jekyll to Docker?

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Feb 3, 2015

Member

Exists plans to make a official image from Jekyll to Docker?

Hi @rodrigobraga! No plans as of yet, but @troyswanson might be convinced to maintain something like that. ;)

Member

parkr commented Feb 3, 2015

Exists plans to make a official image from Jekyll to Docker?

Hi @rodrigobraga! No plans as of yet, but @troyswanson might be convinced to maintain something like that. ;)

@rodrigobraga

This comment has been minimized.

Show comment
Hide comment
@rodrigobraga

rodrigobraga Feb 4, 2015

:)

I have my own image, but a official image can be a good start point to study, test and make projects based on Jekyll.

I go start use a imagem from @troyswanson

rodrigobraga commented Feb 4, 2015

:)

I have my own image, but a official image can be a good start point to study, test and make projects based on Jekyll.

I go start use a imagem from @troyswanson

@sondr3

This comment has been minimized.

Show comment
Hide comment
@sondr3

sondr3 Feb 4, 2015

Contributor

Hey, quick question, I have a pretty wonky problem that I think has to do with incremental regeneration. I'm currently using the 3.0 beta1 release and whenever I update a post the index file isn't updated along with the post, but the post itself is updated when you visit it. I'm running Jekyll through Gulp so every time I save my posts it runs jekyll build but quite frequently the frontpage isn't updated. Occasionally it'll update however but I can't seem to figure out when it does/doesn't. Any ideas?

Contributor

sondr3 commented Feb 4, 2015

Hey, quick question, I have a pretty wonky problem that I think has to do with incremental regeneration. I'm currently using the 3.0 beta1 release and whenever I update a post the index file isn't updated along with the post, but the post itself is updated when you visit it. I'm running Jekyll through Gulp so every time I save my posts it runs jekyll build but quite frequently the frontpage isn't updated. Occasionally it'll update however but I can't seem to figure out when it does/doesn't. Any ideas?

@envygeeks

This comment has been minimized.

Show comment
Hide comment
@envygeeks

envygeeks Feb 4, 2015

Contributor

Please start using unique tickets for your problems, thanks.

Contributor

envygeeks commented Feb 4, 2015

Please start using unique tickets for your problems, thanks.

@jekyll jekyll locked and limited conversation to collaborators Feb 4, 2015

@parkr

This comment has been minimized.

Show comment
Hide comment
@parkr

parkr Mar 5, 2015

Member

Jekyll 3.0.0.beta2 was just released, please go check it out and file bugs as you find them: https://github.com/jekyll/jekyll/releases/tag/v3.0.0.beta2

Member

parkr commented Mar 5, 2015

Jekyll 3.0.0.beta2 was just released, please go check it out and file bugs as you find them: https://github.com/jekyll/jekyll/releases/tag/v3.0.0.beta2

@parkr parkr self-assigned this Mar 16, 2015

@envygeeks

This comment has been minimized.

Show comment
Hide comment
@envygeeks

envygeeks Oct 29, 2015

Contributor

Closing this as all is checked and 3.0 is released.

Contributor

envygeeks commented Oct 29, 2015

Closing this as all is checked and 3.0 is released.

@envygeeks envygeeks closed this Oct 29, 2015

@jglovier

This comment has been minimized.

Show comment
Hide comment
@jglovier
Member

jglovier commented Oct 30, 2015

head-nod

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.