joshareed/grass

Groovy Authoring for Static Sites

grass's Issues

Need a LICENSE file

Pick a license and commit it. I'm not too worried about things so would probably look to some of the other GR8 projects for their licenses.

Feed plugin tries to re-evaluate any text that contains a $

Steps to reproduce:

1. Create document that contains escaped $ (ie $800)
2. Run grass

Expected outcome:
Properly generates both post and feed/rss text.

Outcome:
Properly encodes post but uses post text to encode feed summary and gives SimpleTemplateEngine error

SimpleTemplateScript2687.groovy: 1712: illegal string body character after dollar sign;
solution: either escape a literal dollar sign "$5" or bracket the value expression "${5}" @ line 1712, column 63.
the bells and whistles costs $4,500. It

Archives Plugin

As blogs grow, it will become impractical to show all blog posts on the index page. It would be nice to have a plugin that generates an Archives page that organizes all posts in chronological order.

Category/Tagging Plugin

One major missing feature for blogging is the ability to categorize/tag posts and then view all posts in that category.

Sitemap Plugin

It would be useful to have a plugin that generates a sitemap.xml file for the site.

Incremental Generation of Posts

Usecase: adding a post but don't want to regenerate the hundreds of posts that haven't changed.

Proposed steps:

1. Write post.
2. Read JSON (or some sort of text file) to get timestamp of last run.
3. Find posts created since that time and update only the index page, the specific tags and the RSS feeds of index and tags for that post.

I propose adding another CLI flag to do this. I think it would work well with a modification I've made to cap the number of posts on the index page (no pagination, just the first X posts and then they can go into the archive for stuff).

Could help resolve issue #13.

Need a CONTRIBUTING file

Should describe the process for contributing to the project

Feeds Plugin

It would be extremely useful to have a plugin that generated Atom/RSS feeds for all blog posts. Bonus points if it integrates with a Category/Tagging plugin to generate per-tag feeds.

Google Analytics support

Add support for Google Analytics. Should be able to specify the GA key in config and include the appropriate snippet.

Unit Tests

It would be great to add unit tests for the existing code. However, I haven't figured out the best way under the current architecture. Maybe it's time to look at Gradle?

Convert to a shell command instead of simply a Groovy script?

If we packaged things up as more than just a Groovy script, we could probably get it included with GVM. It might be useful to convert to a Gradle build so then we could add tests.

Site Template

Currently the default template included doesn't generate nice or usable HTML. It would be nice to ship with a default template that will work well for simple static sites or blogs.

Exceeds memory limits of low end VMs on large blogs.

My blog has about 270 or so posts, grass hung up when trying to make index page.

I profiled it locally and it showed that it was using 760MB of RAM. Lowend hosted VMs are usually 512MB.

I'm sure I could get around it with some CLI VM instructions, but I don't think that should be needed.

StackOverflow at about 140-150 posts

Script fails to complete if you try to convert more than 140 posts all at once.

Flesh out README

Flesh out the README file to include info for users as well as developers