Compare commits
10 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 1b337739a6 | |||
|
32fa37c451 | ||
|
|
75508c746d | ||
|
|
d9a0cf4036 | ||
|
|
5f0c8fab20 | ||
|
|
d5603a44ae | ||
|
|
3f31c09342 | ||
|
|
d3c4b6a131 | ||
|
99bfa05bed | ||
|
|
455efc9c3c |
2
.github/FUNDING.yml
vendored
2
.github/FUNDING.yml
vendored
@@ -1 +1 @@
|
||||
custom: https://www.paypal.me/daviddarnes/5usd
|
||||
custom: https://buymeacoffee.com/daviddarnes#support
|
||||
|
||||
26
README.md
26
README.md
@@ -1,8 +1,9 @@
|
||||
# [Garth](https://garth.darn.es/)
|
||||
[](https://badge.fury.io/rb/garth-jekyll-theme)
|
||||
# [Funky](https://garth.darn.es/)
|
||||
|
||||
🥁 A really basic theme for Jekyll, using the official Jekyll theme implementation.
|
||||
|
||||
[<img src="https://cdn.buymeacoffee.com/buttons/default-yellow.png" width="217"/>](https://buymeacoffee.com/daviddarnes#support)
|
||||
|
||||
|
||||
|
||||
## Contents
|
||||
@@ -14,6 +15,16 @@
|
||||
|
||||
## Installation
|
||||
|
||||
### Quick setup
|
||||
|
||||
To give you a running start I've put together some starter kits that you can download, fork or even deploy immediately:
|
||||
|
||||
- Vanilla Jekyll starter kit:
|
||||
[](https://app.netlify.com/start/deploy?repository=https://github.com/daviddarnes/garth-kit)
|
||||
- Stackbit starter kit:
|
||||
[](https://app.stackbit.com/create?theme=https://github.com/daviddarnes/garth-stackbit-kit)
|
||||
- GitHub Pages with remote theme kit - **[Download kit](https://github.com/daviddarnes/garth-kit/archive/remote-theme.zip)**
|
||||
|
||||
### As a Jekyll theme
|
||||
|
||||
1. Add `gem "garth-jekyll-theme"` to your `Gemfile` to add the theme as a dependancy
|
||||
@@ -31,17 +42,6 @@
|
||||
5. Run `bundle exec jekyll serve` to build and serve your site
|
||||
6. Done! Use the example [`_config.yml`](https://github.com/daviddarnes/garth/blob/master/_config.yml) file to set site-wide options
|
||||
|
||||
### As a Boilerplate / Fork
|
||||
|
||||
_(deprecated, not recommended)_
|
||||
|
||||
1. [Fork the repo](https://github.com/daviddarnes/garth#fork-destination-box)
|
||||
2. Replace the `Gemfile` with one stating all the gems used in your project
|
||||
3. Delete the following unnecessary files/folders: `CODE_OF_CONDUCT.md`, `CONTRIBUTING.md`, `LICENSE`, `screenshot.png`, `CNAME` and `garth-jekyll-theme.gemspec`
|
||||
4. Run the command `bundle install` in the root of project to install the jekyll remote theme gem as a dependancy
|
||||
5. Run `bundle exec jekyll serve` to build and serve your site
|
||||
6. Done! Use the example [`_config.yml`](https://github.com/daviddarnes/garth/blob/master/_config.yml) file to set site-wide options
|
||||
|
||||
## Customising
|
||||
|
||||
When using Garth as a theme means you can take advantage of the file overriding method. This allows you to overwrite any file in this theme with your own custom file, by matching the file name and path. The most common example of this would be if you want to add your own styles or change the core style settings.
|
||||
|
||||
@@ -1,34 +1,34 @@
|
||||
{% if paginator.posts %}
|
||||
|
||||
<ul class="list list--posts">
|
||||
{% for page in paginator.posts %}
|
||||
<li class="item item--post">
|
||||
<article class="article article--post typeset">
|
||||
<ul class="list list--posts">
|
||||
{% for page in paginator.posts %}
|
||||
<li class="item item--post">
|
||||
<article class="article article--post typeset">
|
||||
|
||||
<h2><a href="{{ site.baseurl }}{{ page.url }}">{{ page.title }}</a></h2>
|
||||
{% include post-meta.html %}
|
||||
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
||||
<h2><a href="{{ site.baseurl }}{{ page.url }}">{{ page.title }}</a></h2>
|
||||
{% include post-meta.html %}
|
||||
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
||||
|
||||
</article>
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
{% include post-pagination.html %}
|
||||
</article>
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
{% include post-pagination.html %}
|
||||
|
||||
{% else %}
|
||||
|
||||
<ul class="list list--posts">
|
||||
{% for page in site.posts %}
|
||||
<li class="item item--post">
|
||||
<article class="article article--post typeset">
|
||||
<ul class="list list--posts">
|
||||
{% for page in site.posts %}
|
||||
<li class="item item--post">
|
||||
<article class="article article--post typeset">
|
||||
|
||||
<h2><a href="{{ site.baseurl }}{{ page.url }}">{{ page.title }}</a></h2>
|
||||
{% include post-meta.html %}
|
||||
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
||||
<h2><a href="{{ site.baseurl }}{{ page.url }}">{{ page.title }}</a></h2>
|
||||
{% include post-meta.html %}
|
||||
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
||||
|
||||
</article>
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
</article>
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -4,11 +4,11 @@
|
||||
{% unless item.title == false or item.url contains "/page" or item.url contains "/404.html" or item.url contains "/feed." %}
|
||||
<li class="item item--nav{% if item.url == page.url %} item--current{% endif %}">
|
||||
{% if item.collectionpage %}
|
||||
{% assign collectiondata = site.collections | where: "label", item.collectionpage | first %}
|
||||
<a href="{{ site.baseurl }}{{ item.url }}">{{ collectiondata.title }}</a>
|
||||
{% else %}
|
||||
{% assign collectiondata = site.collections | where: "label", item.collectionpage | first %}
|
||||
<a href="{{ site.baseurl }}{{ item.url }}">{{ collectiondata.title }}</a>
|
||||
{% else %}
|
||||
<a href="{{ site.baseurl }}{{ item.url }}">{{ item.title }}</a>
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
</li>
|
||||
{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
3
about.md
3
about.md
@@ -6,7 +6,8 @@ A really basic theme for Jekyll, using the official Jekyll theme implementation.
|
||||
|
||||
- [Fork on GitHub](https://github.com/daviddarnes/garth)
|
||||
- [Install Garth](https://github.com/daviddarnes/garth#installation)
|
||||
- [Tip me $5](https://www.paypal.me/daviddarnes/5usd)
|
||||
|
||||
[<img src="https://cdn.buymeacoffee.com/buttons/default-yellow.png" width="217"/>](https://buymeacoffee.com/daviddarnes#support)
|
||||
|
||||
## Installation
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Gem::Specification.new do |spec|
|
||||
spec.name = "garth-jekyll-theme"
|
||||
spec.version = "1.0.4"
|
||||
spec.version = "1.0.5"
|
||||
spec.authors = ["David Darnes"]
|
||||
spec.email = ["me@daviddarnes.com"]
|
||||
|
||||
@@ -15,8 +15,8 @@ Gem::Specification.new do |spec|
|
||||
|
||||
spec.files = `git ls-files -z`.split("\x0").select { |f| f.match(%r{^(assets|_layouts|_includes|_sass|LICENSE|README)}i) }
|
||||
|
||||
spec.add_runtime_dependency "jekyll", "~> 3.6"
|
||||
spec.add_runtime_dependency "jekyll", ">= 3.6", "< 5.0"
|
||||
spec.add_runtime_dependency "jekyll-paginate", "~> 1.1"
|
||||
|
||||
spec.add_development_dependency "bundler", "~> 1.14"
|
||||
spec.add_development_dependency "bundler", ">= 1.14", "< 3.0"
|
||||
end
|
||||
|
||||
Reference in New Issue
Block a user