daviddarnes/garth

🥁 A really basic theme for Jekyll

For over 14 years, I've been providing my skills in front-end development, design and technical writing to clients such as zeroheight, Nordhealth, Buffer, Netlify, Ghost, Octopus Energy, Stackbit and many more.

Check out my work and articles. If you like what you see get in touch.

garth's Issues

Account for multiple categories

Currently posts can only have one category, however in most cases people want to be able to put multiple categories

garth/_includes/post-meta.html

Line 2 in b8f1295

{% if page.category %}<span class="label label--category">{{ page.category }}</span>&nbsp;&nbsp;&middot;&nbsp;&nbsp;{% endif %}<time datetime="{{ page.date | date_to_xmlschema }}" class="time">{{ page.date | date_to_string }}</time>

This example code in Alembic should cater for that https://github.com/daviddarnes/alembic/blob/master/_includes/post-meta.html

Testimonial Submissions

Howdy all!
I'm looking for people using Garth to submit testimonials about their experiences of it. How are you using it? What are you liking about it? What's your favourite feature?

Let me know your thoughts and I might quote you in the README or on my personal site (as long as you're comfortable with me doing so)

Party on people!

Better CSS file structure

Similar to Alembic, Garth needs to be easy to style. The best way would be to have the following file structure:

_sass/
  sassline-base/
  _flex.scss
  _normalize.scss
  _sassline-base.scss
  _settings.scss
  _theme.scss
  _garth.scss
assets/
  styles.scss

garth.scss will import all the theme related styles, including _theme.scss. Then in turn assets/styles.scss will import garth. This means all theme related styles are in one place and the theme user only has to import one file if they wish to add their own custom styles.

Your theme is listed in jekyllthemes.ru

Your theme has been listed on http://jekyllthemes.ru/

Navigation missing

There's no navigation when you install the theme out of the box, the nav should loop through pages and have an option for a custom nav.

Give a default footer

It says the date but no name, a default name would be helpful

Can't use theme

Jekyll 3.2.0, ubuntu 16.04.1. I can't follow your instructions. First 3 steps are okay, but then there is no css/styles.scss file in css directory, only main.scss. Also there is no js/ directory at all. If I create these files, then I get bare site without theme. jekyll s --watch complains:

[2016-07-31 16:35:30] ERROR `/css/theme' not found.
[2016-07-31 16:35:33] ERROR `/css/theme' not found.
[2016-07-31 16:35:36] ERROR `/css/theme' not found.

"kicking the tires" issues

Hi David,
When I follow your instructions I get jekyll 3.2.0.pre.beta1 | Error: The garth-jekyll-theme theme could not be found. so I added the following to the Gemfile

gem "jekyll", "3.2.0.pre.beta1"
group :jekyll_plugins do
  gem "garth-jekyll-theme"
  gem "jekyll-seo-tag"
  gem "jekyll-paginate"
end

and ran that. I'm still getting the default theme even though I see that your js and css files are being generated.

If I delete my _layouts folder, I get what appears to be your theme, but it's pretty funky.

I did this on two separate installs.

Remove demo code

The demo/ directory is no longer needed as people can use the jekyll-remote-theme gem instead of forking this repo to get this design running on GitHub Pages

Provide a example site for reference

Like this one https://github.com/jekyll/minima/tree/master/example

Remove unnecessary title and alt attributes

Anchor elements don't need titles if they contain text or images with alt text.

Cannot customize colors

I tried to follow the README's instructions:

If you're just looking to set your own colours copy the _colors.scss file into your project at the same file path (_sass/_settings.scss) and change variables however you wish.

Except I used the tagged version of _colors.scss that matched the version of the gem I installed: https://raw.githubusercontent.com/daviddarnes/garth/1.0.2/_sass/_colors.scss and I called it _sass/_colors.scss (Typo in README?)

I still see the Yellow background and garth's original colors.

Here is more info about my environment and a sample repo

ruby 2.4.4p296 (2018-03-28 revision 63013) [x86_64-darwin17]
jekyll-3.7.3
garth-jekyll-theme-1.0.2

Test fonts and weights

Need to make sure that the correct weights and variations are being loaded from Google Fonts. Appears to be working now but it'll be best to get the weights used loaded in

Add support for separate favicons

Currently, the shortcut-icon property is mapped to {{ site.logo }}, but when said file is an svg, it won't be rendered by most browsers (save Firefox and Safari). For browsers that don't support non-raster favicons, maybe it'd be good to create a separate {{ site.favicon }}?

Allow use of baseurl

Currently the urls in the template don't account for a baseurl, which should prefix them