octopress / category-index

A category index generator for Jekyll sites.
MIT License
4 stars 0 forks source link

Reference for all category pages? #2

Closed tohuw closed 9 years ago

tohuw commented 9 years ago

I'm trying, with my limited Ruby grokking capabilities, to understand how this plugin works in terms of variables and elements usable in Liquid templates. I've noticed the category pages appear in site.pages, but is there some specific reference for all category pages? Similarly, is there some way to refer to all pages that aren't category pages?

Lastly, for whatever reason, the links to category pages build as e.g. //topics/testcat/index.html, given the below config. I imagine I've done something incorrectly.

category_dir: topics
prefixes:
  title: ""
  meta_description: "Topic: "
feed:
  enabled: false
  count: 5
imathis commented 9 years ago

I'm really sorry, this is a work in progress right now and the current version isn't ready for use. I'll update the readme. It should be ready in a day or two.

tohuw commented 9 years ago

Ah, gotcha. I'll be happy to help test and contribute in any way I can. The new iteration of octopress is really great; good work.

imathis commented 9 years ago

Awesome. i'll be sure to post a note on this issue when an updated version is released.

imathis commented 9 years ago

I think I've decided to abandon this plugin. Instead of releasing it, I have built the core functionality into Octopress Ink. This way any plugin can easily generate indexes or feeds for categories and tags. These will automatically support multilingual sites, filtering generating language specific category and tag pages, and automatically populating default configurations for each type of feed. To use these features a plugin author only needs to add template pages with the correct name to their plugin assets. I have rewritten the octopress-feeds project on top of this, and I've basically been able to delete a ton of code. It's wonderful.

So why not release this as a separate plugin that builds on these features? The main reason is that unless I ship stylesheets, I'm expecting everyone who uses this plugin to style the HTML markup I've suggested, or asking users to modify the markup and at that point, the only utility of this plugin is the template generation. Instead, I'll be building this in to the Genesis theme which will come with its own stylesheets and be much easier for someone to start using. If I released this separately I will either end up with very few users (because most people don't want to write their own stylesheets) or users who want this to be flexible enough to be useful with different markup or different stylesheets. In the end, this feature is better when shipped with a cohesive theme.

/cc @drallgood

tohuw commented 9 years ago

Fair enough! I can derive what I need by pulling the implementation from Genesis into my theme. So long as the brains are there in Ink, that works great for me. Thanks for looking into this.

imathis commented 9 years ago

It occurs to me, I could build a version of this that will look for user layouts and generate these pages. Allowing people to use this apart from a theme. I'll look into that.

tohuw commented 9 years ago

That would be perfect. I just want a pages factory - I can handle tailoring it.

imathis commented 9 years ago

Ooo, Page factory. I like the sounds of that. I'm trying to figure out a suitable name for a gem that can generate pages based on user layouts.

tohuw commented 9 years ago

Well, there's a name. Or, if we're keeping with the Octopus theme, maybe eggs? Spermatophores would of course be the helper functions! :\

taringamberini commented 9 years ago

Sorry but is not clear to me what I have to do in order to generate a category list: