https://www.groundwork.rocks/metalsmith-feedWed, 20 Dec 2017 10:28:49 GMTThere’s been some major changes in Groundwork lately. Firstly tidying up the templates so that title works for posts and pages, and pages have a slug attribute, so that the permalink can be different to the title. Also, I have installed semantic-release, which means the semantic versioning is far easier to manage. If you’re interested in why this is important, read The Twelve-Factor App.

On a tidy code note, Groundwork is now using ESlint, a linter>) for JavaScript, and Prettier, an opinionated code formatter.

]]>https://www.groundwork.rocks/posts/171217-ch-ch-ch-changes.mdhttps://www.groundwork.rocks/posts/171217-ch-ch-ch-changes.mdSun, 17 Dec 2017 00:00:00 GMTI’ve removed the Fractal styleguide from the Groundwork template, as I think it’s a bit too much if you just want a simple site.

There’ll be some tutorials coming (honest!) which will show how to set Fractal up with Groundwork.

I find it a bit too cluttered, so I have decided not to use it for components.

Components are “discrete, complete chunks of UI”, and they are commonplace. So the rule is, if it doesn’t have a prefix, it must be a component type of module.

]]>https://www.groundwork.rocks/posts/170316-enough-prefix-madness.mdhttps://www.groundwork.rocks/posts/170316-enough-prefix-madness.mdTue, 18 Apr 2017 00:00:00 GMTTo build the styleguide, Groundwork uses the magnificent Fractal by Mark Perkins from Clearleft (which is also home to the fiendishly ubiquitous @adactio).

It automatically picks up “components” (what I call “modules”) from your directory structure, so it plays perfectly with the whole Modular CSS thang. You create a CSS file, a template file (Handlebars by default), a JS file, SVG, PNG etc., and it’s all picked up in one tickety little bundle.

]]>https://www.groundwork.rocks/posts/170711-fractal-styleguide.mdhttps://www.groundwork.rocks/posts/170711-fractal-styleguide.mdTue, 11 Jul 2017 00:00:00 GMTThanks to @leviwheatcroft’s plugin metalsmith-move, I’ve been able to move(!) all my image assets out of their individual CSS module folders into /assets/images/. This is A Good Thing, makes image linking much simpler.

In other news:

the Fractal styleguide is now working at /styleguide/, although the styles aren’t being pulled in yet!

I’m in the midst of creating a blank “white label” template, which will become the canonical Groundwork project itself. In the meantime if you’d like to try it out, use Groundwork.Rocks

So, soon there will be a 0.1.0 release of Groundwork, which will make me very happy, happy enough to embark upon a social media marketing campaign blitz.

]]>https://www.groundwork.rocks/posts/170703-romping-toward-0.1.0-release.mdhttps://www.groundwork.rocks/posts/170703-romping-toward-0.1.0-release.mdMon, 03 Jul 2017 00:00:00 GMTThe animated GIF with Screenflow turned out to be 1.8MB, which is a bit big for what is essentially these commands:

As soon as I get the metalsmith-feed plugin working, I’ll pipe out the posts to the Twitter account. I’ll also pipe them out to growdigital. Coming at you from all sides. Oh yes.

]]>https://www.groundwork.rocks/posts/170328-twitter-a-go-go.mdhttps://www.groundwork.rocks/posts/170328-twitter-a-go-go.mdSat, 01 Apr 2017 00:00:00 GMTHow hard can it be to make an animated GIF showing how to install Groundwork?

PRETTY BLOODY HARD

is the answer.

I’d previously tooled up with Screenflow for a contract that never flew, so I’ve been trying my hand at this new fangled screen-castering malarkey. What a lot of messing about.

Anyway, the good news is that I’ll put an animated GIFs together that is less than 108MB in size and post it on the website tomorrow. Honest.

]]>https://www.groundwork.rocks/posts/170329-animated-gif-in-production.mdhttps://www.groundwork.rocks/posts/170329-animated-gif-in-production.mdWed, 29 Mar 2017 00:00:00 GMTThe trouble with Open Source software is that you just can’t give it away.

Money is only one part of the equation, of more importance is the investment of time and effort.

To that end, I’ve rewritten the README and created a Slack channel. My arbitary but achievable aim is to have 100 stars for the project by the end of the year. So, please feel free to give Groundwork a star :)

]]>https://www.groundwork.rocks/posts/170328-hot-hot-hot.mdhttps://www.groundwork.rocks/posts/170328-hot-hot-hot.mdTue, 28 Mar 2017 00:00:00 GMTI just set up semantic versioning for Groundwork with semver.org, using the interactive guide to package.json as a guide. I like semantic versioning, it appeals to my tidy side. Also, it makes a great deal of sense for any sane method of development, web or whatever.

Along the same lines, I can also heartily recommend The Twelve-Factor App, casts a big shining light on all this plugin semantic versioning for Metalsmith.

It would be nice to insert the date with a keystroke. There’s a plugin for that, maybe tomorrow…

]]>https://www.groundwork.rocks/posts/170325-metalsmith-snippet.mdhttps://www.groundwork.rocks/posts/170325-metalsmith-snippet.mdSat, 25 Mar 2017 00:00:00 GMTI wasn’t sure if the file extension for Handlebars is .hbt or .hbs, so I asked on the friendly MetalsmithSlack channel, and an answer came back from Woody:

I think it's .hbs because by definition handlebars is a template so .hbt is a but of a misnomer.

It’s all these little details that take the time. And I haven’t even started writing the documentation.

]]>https://www.groundwork.rocks/posts/170324-hbs-or-hbt.mdhttps://www.groundwork.rocks/posts/170324-hbs-or-hbt.mdFri, 24 Mar 2017 00:00:00 GMTGroundwork is a Module CSS Starter Kit. Make sure to have Node.js installed, download the repo, then just run this in a terminal:

Soon as I get everything work just about, I’ll post a message here on this blog.

]]>https://www.groundwork.rocks/posts/170323-groundwork-rocks-soft-launch.mdhttps://www.groundwork.rocks/posts/170323-groundwork-rocks-soft-launch.mdThu, 23 Mar 2017 00:00:00 GMTGroundwork has finally been released as a 0.1.0. This means it really kind of works now. Indeed, I myself shall be building my Grow Digital blog and forest gardening blog with it.