Fogged Clarity

A Wordpress theme based on 'Some Like it Neat.' Note: This theme has some very specific dependencies and a very specific purpose.

Some Like it Neat

A WordPress Theme Using _s, Bourbon + Neat and Theme Hook Alliance

Description

Some Like it Neat is a Minimal Starter theme that is Responsive out of the box. It uses SASS along with Bourbon Neat for help with Responsive grids. It's based on _s and is pretty rad.

What's Inside?

• Bourbon (https://bourbon.io), Neat (https://neat.bourbon.io), Bitters (https://bitters.bourbon.io) and Refills (https://refills.bourbon.io) — Bourbon provides a lightweight SASS library (similar to Compass).

Neat extends bourbon and provides a nice and lightweight grid framework as a base for this project. Refills and Bitters provide additional styling and UI elements. I suggest you visit each of these projects to learn more and how to use them.

• Underscores (_s) based theme. There's smarter folks than me building great sh*t (https://underscores.me)

• SASS. We're using it and to update this theme you should be cozy with it or get ready to learn how to use. As of the initial writing of this ReadMe, I've been using SASS like a piece of shit asshole. I don't know what the fuck I'm doing. So if you do, please feel free to school a chump! If you don't know SASS, you should definitely jump in. The water's fine and you'll thank me later. I accept thanks in burritos, doritos, fritos and cheetos only.

• Theme Hook Alliance — One of the things I learned to love about working with Frameworks were their hooks. Thematic and Genesis introduced me to the notion. Since them I've been using them like they're going out of style. When I set out to make my own starter theme I wanted to make something that had "just the right amount" of features for me. I knew I needed hooks. The THA project was intro'd to me by Brandon Dove, at the OCWP (https://ocwp.org) developer's day meetup. Thought it was super neat. So I bundled that hot mess right into this thing.

• Kirki Advanced Theme Customizer Framework (https://kirki.org) — Adds some functionality to the already awesome built-in theme customizer. It adds cool extras like button sets, slider controls, radio image selectors. Read up on it! For now, I'm placing custom controls using Kirki in /library/inc/wp-customizer/customizer.php

• Flexnav Menu System and Hover Intent

• TGM PLugin Activation

• Genericons/Dashicons

• Pull requests welcome...

Getting Started

I'll be coming back to this later

Theme Hook Alliance

---

What is Theme Hook Alliance? It's a pretty rad project - https://github.com/zamoose/themehookalliance. I'm a big fan of hooks, personally. They provide a means to keep things within the theme cleaner and easier to maintain.

"The Theme Hook Alliance is a community-driven effort to agree on a set of third-party action hooks that THA themes pledge to implement in order to give that desired consistency."

Bourbon and Neat

---

Why use these in this project? It's a philosophical thing. I've used Foundation and Bootstrap before. I like them; they're both great, great projects run by smarter people than myself. So what's the philosophical bit? To achieve the responsiveness required of various projects, I would have to tear up my HTML, input my own selector classes and what have you, in addition to changing my css. I didn't like it. I heard about Neat (https://neat.bourbon.io) and really liked their approach to a grid framework. You keep your HTML structure the way you like and all of the styling in your SASS files

Use as a Parent Theme?

---

I don't see why not. I haven't done it yet. ( I'm using a child theme on https://alexhasnicehair.com ) But with the addition of Theme Hook Alliance, I'd say 'Some Like it Neat' would make for a good Parent Theme for your project and certainly more ideal if you're going to make significant edits (and why wouldn't you? By default it looks like pooh!).

What I recommend is that you generate your child theme, setup your child theme folder, style.css file. Additionally, I think it's just easier to copy the 'library' folder from the parent and place it into the child theme.

Getting Started aka What You Need to Know...

---

Well, to use this theme, you'll definitely want to learn SASS. It's what Bourbon and Neat are built on top of and is at the core of this theme's build.

Folder Structure

• Theme Root
  • library
    • assets ( js, css, sass )
      • css
      • font
      • js
      • sass ( Where all scss files are stored )
    • languages
    • vendors ( 3rd party utilities like Theme Hook Alliance, Kirki, TGM Plugin Activation etc... )
      • kirki
      • tgm-plugin-activation
      • tha-theme-hooks
      • wp-customizer
  • page-templates ( Standard Page Templates for Pages )
    • partials ( Template Parts viea get_template_parts() )

General Credits and Thanks

---

A special thanks to all the folks who inspire me on a daily basis to "do more" with what I know and what I can contribute.

• Brandon Dove
• Nikhil @techvoltz
• Jon Brown
• Jeffrey Zinn
• Steve Zehngut
• Chris Lema
• Se Reed
• Natalie MacLees
• Ryan Cowles
• Nathan Tyler
• Dave Jesch
• Devin Walker
• Blair Williams
• Robert Neu
• And a fuckload more that I'm missing here.

License

This theme is based on Underscores, (C) 2012-2013 Automattic, Inc.

• Source: https://underscores.me/
• License: GNU GPL, Version 2 (or later)
• License URI: license.txt

Kirki, (C) 2014 Aristeides Stathopoulos, Dimitris Kalliris.

• Source: https://kirki.org/
• License: GNU GPL, Version 2 (or later)
• License URI: license.txt

Flexnav, Copyright 2014 Jason Weaver.

• Source: https://jasonweaver.name/lab/flexiblenavigation/
• License: GNU GPL, Version 2 (or later)
• License URI: https://github.com/indyplanets/flexnav/blob/master/LICENSE

Genericons, Copyright 2013 Automattic, Inc.

• Source: https://www.genericons.com
• License: GNU GPL, Version 2 (or later)
• License URI: /font/license.txt

TGM Plugin Activation, Copyright 2014 Thomas Griffin Media, Inc.

• Source: https://tgmpluginactivation.com/
• License: GNU GPL, Version 2 (or later)
• License URI: https://tgmpluginactivation.com/#license

Theme Hook Alliance

• Source: https://github.com/zamoose/themehookalliance/blob/master/tha-theme-hooks.php
• License: GNU GPL, Version 2 (or later)
• License URI:

Bourbon

• Source: https://bourbon.io, © 2013 thoughtbot
• License: The MIT License
• License URI: https://github.com/thoughtbot/bourbon/blob/master/LICENSE

Neat

• Source: https://neat.bourbon.io, © 2013 thoughtbot
• License: The MIT License
• License URI: https://github.com/thoughtbot/neat/blob/master/LICENSE

Hover Intent

• Source: https://github.com/tristen/hoverintent
• License: the MIT
• License URI: license.txt