David Darnes
GitHub
commit
e6256f60f7
149
CODE_OF_CONDUCT.md
Normal file
149
CODE_OF_CONDUCT.md
Normal file
@ -0,0 +1,149 @@
|
|||||||
|
# Code of Conduct
|
||||||
|
|
||||||
|
## When Something Happens
|
||||||
|
|
||||||
|
If you see a Code of Conduct violation, follow these steps:
|
||||||
|
|
||||||
|
1. Let the person know that what they did is not appropriate and ask them to stop and/or edit their message(s) or commits.
|
||||||
|
2. That person should immediately stop the behaviour and correct the issue.
|
||||||
|
3. If this doesn’t happen, or if you're uncomfortable speaking up, [contact the maintainers](#contacting-maintainers).
|
||||||
|
4. As soon as available, a maintainer will look into the issue, and take [further action (see below)](#further-enforcement), starting with a warning, then temporary block, then long-term repo or organisation ban.
|
||||||
|
|
||||||
|
When reporting, please include any relevant details, links, screenshots, context, or other information that may be used to better understand and resolve the situation.
|
||||||
|
|
||||||
|
**The maintainer team will prioritise the well-being and comfort of the recipients of the violation over the comfort of the violator.** See [some examples below](#enforcement-examples).
|
||||||
|
|
||||||
|
## Our Pledge
|
||||||
|
|
||||||
|
In the interest of fostering an open and welcoming environment, we as contributors and maintainers of this project pledge to making participation in our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, technical preferences, nationality, personal appearance, race, religion, or sexual identity and orientation.
|
||||||
|
|
||||||
|
## Our Standards
|
||||||
|
|
||||||
|
Examples of behaviour that contributes to creating a positive environment include:
|
||||||
|
|
||||||
|
* Using welcoming and inclusive language.
|
||||||
|
* Being respectful of differing viewpoints and experiences.
|
||||||
|
* Gracefully accepting constructive feedback.
|
||||||
|
* Focusing on what is best for the community.
|
||||||
|
* Showing empathy and kindness towards other community members.
|
||||||
|
* Encouraging and raising up your peers in the project so you can all bask in hacks and glory.
|
||||||
|
|
||||||
|
Examples of unacceptable behaviour by participants include:
|
||||||
|
|
||||||
|
* The use of sexualised language or imagery and unwelcome sexual attention or advances, including when simulated online. The only exception to sexual topics is channels/spaces specifically for topics of sexual identity.
|
||||||
|
* Trolling, insulting/derogatory comments, and personal or political attacks.
|
||||||
|
* Public or private harassment, deliberate intimidation, or threats.
|
||||||
|
* Publishing others' private information, such as a physical or electronic address, without explicit permission. This includes any sort of "outing" of any aspect of someone's identity without their consent.
|
||||||
|
* Publishing private screenshots or quotes of interactions in the context of this project without all quoted users' *explicit* consent.
|
||||||
|
* Publishing of private communication that doesn't have to do with reporting harassment.
|
||||||
|
* Any of the above even when [presented as "ironic" or "joking"](https://en.wikipedia.org/wiki/Hipster_racism).
|
||||||
|
* Any attempt to present "reverse-ism" versions of the above as violations. Examples of reverse-isms are "reverse racism", "reverse sexism", "heterophobia", and "cisphobia".
|
||||||
|
* Unsolicited explanations under the assumption that someone doesn't already know it. Ask before you teach! Don't assume what people's knowledge gaps are.
|
||||||
|
* [Feigning or exaggerating surprise](https://www.recurse.com/manual#no-feigned-surprise) when someone admits to not knowing something.
|
||||||
|
* "[Well-actuallies](https://www.recurse.com/manual#no-well-actuallys)"
|
||||||
|
* Other conduct which could reasonably be considered inappropriate in a professional or community setting.
|
||||||
|
|
||||||
|
## Scope
|
||||||
|
|
||||||
|
This Code of Conduct applies both within spaces involving this project and in other spaces involving community members. This includes the repository, its Pull Requests and Issue tracker, its Twitter community, private email communications in the context of the project, and any events where members of the project are participating, as well as adjacent communities and venues affecting the project's members.
|
||||||
|
|
||||||
|
Depending on the violation, the maintainers may decide that violations of this code of conduct that have happened outside of the scope of the community may deem an individual unwelcome, and take appropriate action to maintain the comfort and safety of its members.
|
||||||
|
|
||||||
|
### Other Community Standards
|
||||||
|
|
||||||
|
As a project on GitHub, this project is additionally covered by the [GitHub Community Guidelines](https://help.github.com/articles/github-community-guidelines/).
|
||||||
|
|
||||||
|
Additionally, as a project hosted on npm, is is covered by [npm, Inc's Code of Conduct](https://www.npmjs.com/policies/conduct).
|
||||||
|
|
||||||
|
Enforcement of those guidelines after violations overlapping with the above are the responsibility of the entities, and enforcement may happen in any or all of the services/communities.
|
||||||
|
|
||||||
|
## Maintainer Enforcement Process
|
||||||
|
|
||||||
|
Once the maintainers get involved, they will follow a documented series of steps and do their best to preserve the well-being of project members. This section covers actual concrete steps.
|
||||||
|
|
||||||
|
### Contacting Maintainers
|
||||||
|
|
||||||
|
You may get in touch with the maintainer team through any of the following methods:
|
||||||
|
|
||||||
|
* Through email:
|
||||||
|
* [me@daviddarnes.com](mailto:me@daviddarnes.com) (David Darnes)
|
||||||
|
|
||||||
|
* Through Twitter:
|
||||||
|
* [@DavidDarnes](https://twitter.com/DavidDarnes) (David Darnes)
|
||||||
|
|
||||||
|
### Further Enforcement
|
||||||
|
|
||||||
|
If you've already followed the [initial enforcement steps](#enforcement), these are the steps maintainers will take for further enforcement, as needed:
|
||||||
|
|
||||||
|
1. Repeat the request to stop.
|
||||||
|
2. If the person doubles down, they will have offending messages removed or edited by a maintainers given an official warning. The PR or Issue may be locked.
|
||||||
|
3. If the behaviour continues or is repeated later, the person will be blocked from participating for 24 hours.
|
||||||
|
4. If the behaviour continues or is repeated after the temporary block, a long-term (6-12mo) ban will be used.
|
||||||
|
|
||||||
|
On top of this, maintainers may remove any offending messages, images, contributions, etc, as they deem necessary.
|
||||||
|
|
||||||
|
Maintainers reserve full rights to skip any of these steps, at their discretion, if the violation is considered to be a serious and/or immediate threat to the health and well-being of members of the community. These include any threats, serious physical or verbal attacks, and other such behaviour that would be completely unacceptable in any social setting that puts our members at risk.
|
||||||
|
|
||||||
|
Members expelled from events or venues with any sort of paid attendance will not be refunded.
|
||||||
|
|
||||||
|
### Who Watches the Watchers?
|
||||||
|
|
||||||
|
Maintainers and other leaders who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. These may include anything from removal from the maintainer team to a permanent ban from the community.
|
||||||
|
|
||||||
|
Additionally, as a project hosted on both GitHub and npm, [their own Codes of Conducts may be applied against maintainers of this project](#other-community-standards), externally of this project's procedures.
|
||||||
|
|
||||||
|
### Enforcement Examples
|
||||||
|
|
||||||
|
#### The Best Case
|
||||||
|
|
||||||
|
The vast majority of situations work out like this. This interaction is common, and generally positive.
|
||||||
|
|
||||||
|
> Alex: "Yeah I used X and it was really crazy!"
|
||||||
|
|
||||||
|
> Patt (not a maintainer): "Hey, could you not use that word? What about 'ridiculous' instead?"
|
||||||
|
|
||||||
|
> Alex: "oh sorry, sure." -> edits old comment to say "it was really confusing!"
|
||||||
|
|
||||||
|
#### The Maintainer Case
|
||||||
|
|
||||||
|
Sometimes, though, you need to get maintainers involved. Maintainers will do their best to resolve conflicts, but people who were harmed by something **will take priority**.
|
||||||
|
|
||||||
|
> Patt: "Honestly, sometimes I just really hate using $library and anyone who uses it probably sucks at their job."
|
||||||
|
|
||||||
|
> Alex: "Whoa there, could you dial it back a bit? There's a CoC thing about attacking folks' tech use like that."
|
||||||
|
|
||||||
|
> Patt: "I'm not attacking anyone, what's your problem?"
|
||||||
|
|
||||||
|
> Alex: "@maintainers hey uh. Can someone look at this issue? Patt is getting a bit aggro. I tried to nudge them about it, but nope."
|
||||||
|
|
||||||
|
> KeeperOfCommitBits: (on issue) "Hey Patt, maintainer here. Could you tone it down? This sort of attack is really not okay in this space."
|
||||||
|
|
||||||
|
> Patt: "Leave me alone I haven't said anything bad wtf is wrong with you."
|
||||||
|
|
||||||
|
> KeeperOfCommitBits: (deletes user's comment), "@patt I mean it. Please refer to the CoC over at (URL to this CoC) if you have questions, but you can consider this an actual warning. I'd appreciate it if you reworded your messages in this thread, since they made folks there uncomfortable. Let's try and be kind, yeah?"
|
||||||
|
|
||||||
|
> Patt: "@keeperofbits Okay sorry. I'm just frustrated and I'm kinda burnt out and I guess I got carried away. I'll DM Alex a note apologising and edit my messages. Sorry for the trouble."
|
||||||
|
|
||||||
|
> KeeperOfCommitBits: "@patt Thanks for that. I hear you on the stress. Burnout sucks :/. Have a good one!"
|
||||||
|
|
||||||
|
#### The Nope Case
|
||||||
|
|
||||||
|
> PepeTheFrog🐸: "Hi, I am a literal actual nazi and I think white supremacists are quite fashionable."
|
||||||
|
|
||||||
|
> Patt: "NOOOOPE. OH NOPE NOPE."
|
||||||
|
|
||||||
|
> Alex: "JFC NO. NOPE. @keeperofbits NOPE NOPE LOOK HERE"
|
||||||
|
|
||||||
|
> KeeperOfCommitBits: "👀 Nope. NOPE NOPE NOPE. 🔥"
|
||||||
|
|
||||||
|
> PepeTheFrog🐸 has been banned from all organisation or user repositories belonging to KeeperOfCommitBits.
|
||||||
|
|
||||||
|
## Attribution
|
||||||
|
|
||||||
|
This Code of Conduct was generated using [WeAllJS Code of Conduct Generator](https://npm.im/weallbehave), which is based on the [WeAllJS Code of
|
||||||
|
Conduct](https://wealljs.org/code-of-conduct), which is itself based on
|
||||||
|
[Contributor Covenant](http://contributor-covenant.org), version 1.4, available
|
||||||
|
at
|
||||||
|
[http://contributor-covenant.org/version/1/4](http://contributor-covenant.org/version/1/4),
|
||||||
|
and the LGBTQ in Technology Slack [Code of
|
||||||
|
Conduct](http://lgbtq.technology/coc.html).
|
||||||
234
CONTRIBUTING.md
Normal file
234
CONTRIBUTING.md
Normal file
@ -0,0 +1,234 @@
|
|||||||
|
# Contributing
|
||||||
|
|
||||||
|
Thank you so much for your interest in contributing!. All types of contributions are encouraged and valued. See below for different ways to help, and details about how this project handles them!
|
||||||
|
|
||||||
|
Please make sure to read the relevant section before making your contribution! It will make it a lot easier for us maintainers to make the most of it and smooth out the experience for all involved. 💚
|
||||||
|
|
||||||
|
The [Project Team](#join-the-project-team) looks forward to your contributions.~
|
||||||
|
|
||||||
|
## How do I...
|
||||||
|
|
||||||
|
* Ask or Say Something 🤔🐛😱
|
||||||
|
* [Request Support](#request-support)
|
||||||
|
* [Report an Error or Bug](#report-an-error-or-bug)
|
||||||
|
* [Request a Feature](#request-a-feature)
|
||||||
|
* Make Something 🤓👩🏽💻📜🍳
|
||||||
|
* [Project Setup](#project-setup)
|
||||||
|
* [Contribute Documentation](#contribute-documentation)
|
||||||
|
* [Contribute Code](#contribute-code)
|
||||||
|
* Manage Something ✅🙆🏼💃👔
|
||||||
|
* [Provide Support on Issues](#provide-support-on-issues)
|
||||||
|
* [Label Issues](#label-issues)
|
||||||
|
* [Clean Up Issues and PRs](#clean-up-issues-and-prs)
|
||||||
|
* [Review Pull Requests](#review-pull-requests)
|
||||||
|
* [Merge Pull Requests](#merge-pull-requests)
|
||||||
|
* [Tag a Release](#tag-a-release)
|
||||||
|
* [Join the Project Team](#join-the-project-team)
|
||||||
|
* [Add a Guide Like This One To My Project](#attribution) 🤖😻👻
|
||||||
|
|
||||||
|
## Request Support
|
||||||
|
|
||||||
|
If you have a question about this project, how to use it, or just need clarification about something:
|
||||||
|
|
||||||
|
* Open an Issue at https://github.com/daviddarnes/garth/issues
|
||||||
|
* Provide as much context as you can about what you're running into.
|
||||||
|
* Provide project and platform versions (jekyll, ruby, etc), depending on what seems relevant. If not, please be ready to provide that information if maintainers ask for it.
|
||||||
|
|
||||||
|
Once it's filed:
|
||||||
|
|
||||||
|
* The project team will [label the issue](#label-issues).
|
||||||
|
* Someone will try to have a response soon.
|
||||||
|
* If you or the maintainers don't respond to an issue for 30 days, the [issue will be closed](#clean-up-issues-and-prs). If you want to come back to it, reply (once, please), and we'll reopen the existing issue. Please avoid filing new issues as extensions of one you already made.
|
||||||
|
|
||||||
|
## Report an Error or Bug
|
||||||
|
|
||||||
|
If you run into an error or bug with the project:
|
||||||
|
|
||||||
|
* Open an Issue at https://github.com/daviddarnes/garth/issues
|
||||||
|
* Include *reproduction steps* that someone else can follow to recreate the bug or error on their own.
|
||||||
|
* Provide project and platform versions (jekyll, ruby, etc), depending on what seems relevant. If not, please be ready to provide that information if maintainers ask for it.
|
||||||
|
|
||||||
|
Once it's filed:
|
||||||
|
|
||||||
|
* The project team will [label the issue](#label-issues).
|
||||||
|
* A team member will try to reproduce the issue with your provided steps. If there are no repro steps or no obvious way to reproduce the issue, the team will ask you for those steps and mark the issue as `needs-repro`. Bugs with the `needs-repro` tag will not be addressed until they are reproduced.
|
||||||
|
* If the team is able to reproduce the issue, it will be marked `needs-fix`, as well as possibly other tags (such as `critical`), and the issue will be left to be [implemented by someone](#contribute-code).
|
||||||
|
* If you or the maintainers don't respond to an issue for 30 days, the [issue will be closed](#clean-up-issues-and-prs). If you want to come back to it, reply (once, please), and we'll reopen the existing issue. Please avoid filing new issues as extensions of one you already made.
|
||||||
|
* `critical` issues may be left open, depending on perceived immediacy and severity, even past the 30 day deadline.
|
||||||
|
|
||||||
|
## Request a Feature
|
||||||
|
|
||||||
|
If the project doesn't do something you need or want it to do:
|
||||||
|
|
||||||
|
* Open an Issue at https://github.com/daviddarnes/garth/issues
|
||||||
|
* Provide as much context as you can about what you're running into.
|
||||||
|
* Please try and be clear about why existing features and alternatives would not work for you.
|
||||||
|
|
||||||
|
Once it's filed:
|
||||||
|
|
||||||
|
* The project team will [label the issue](#label-issues).
|
||||||
|
* The project team will evaluate the feature request, possibly asking you more questions to understand its purpose and any relevant requirements. If the issue is closed, the team will convey their reasoning and suggest an alternative path forward.
|
||||||
|
* If the feature request is accepted, it will be marked for implementation with `feature-accepted`, which can then be done by either by a core team member or by anyone in the community who wants to [contribute code](#contribute-code).
|
||||||
|
|
||||||
|
Note: The team is unlikely to be able to accept every single feature request that is filed. Please understand if they need to say no.
|
||||||
|
|
||||||
|
## Project Setup
|
||||||
|
|
||||||
|
So you wanna contribute some code! That's great! This project uses GitHub Pull Requests to manage contributions, so [read up on how to fork a GitHub project and file a PR](https://guides.github.com/activities/forking) if you've never done it before.
|
||||||
|
|
||||||
|
If this seems like a lot or you aren't able to do all this setup, you might also be able to [edit the files directly](https://help.github.com/articles/editing-files-in-another-user-s-repository/) without having to do any of this setup. Yes, [even code](#contribute-code).
|
||||||
|
|
||||||
|
If you want to go the usual route and run the project locally, though:
|
||||||
|
|
||||||
|
* [Install bundler](hhttp://bundler.io/#getting-started)
|
||||||
|
* [Fork the project](https://guides.github.com/activities/forking/#fork)
|
||||||
|
|
||||||
|
Then in your terminal:
|
||||||
|
* `$ bundle install`
|
||||||
|
* `$ bundle exec jekyll serve --watch`
|
||||||
|
|
||||||
|
And you should be ready to go!
|
||||||
|
|
||||||
|
## Contribute Documentation
|
||||||
|
|
||||||
|
Documentation is a super important, critical part of this project. Docs are how we keep track of what we're doing, how, and why. It's how we stay on the same page about our policies. And it's how we tell others everything they need in order to be able to use this project -- or contribute to it. So thank you in advance.
|
||||||
|
|
||||||
|
Documentation contributions of any size are welcome! Feel free to file a PR even if you're just rewording a sentence to be more clear, or fixing a spelling mistake!
|
||||||
|
|
||||||
|
To contribute documentation:
|
||||||
|
|
||||||
|
* [Set up the project](#project-setup).
|
||||||
|
* Edit or add any relevant documentation.
|
||||||
|
* Make sure your changes are formatted correctly and consistently with the rest of the documentation.
|
||||||
|
* Re-read what you wrote, and run a spellchecker on it to make sure you didn't miss anything.
|
||||||
|
* In your commit message(s), begin the first line with `docs: `. For example: `docs: Adding a doc contrib section to CONTRIBUTING.md`.
|
||||||
|
* Write clear, concise commit message(s) using [conventional-changelog format](https://github.com/conventional-changelog/conventional-changelog-angular/blob/master/convention.md). Documentation commits should use `docs(<component>): <message>`.
|
||||||
|
* Go to https://github.com/daviddarnes/garth/pulls and open a new pull request with your changes.
|
||||||
|
* If your PR is connected to an open issue, add a line in your PR's description that says `Fixes: #123`, where `#123` is the number of the issue you're fixing.
|
||||||
|
|
||||||
|
Once you've filed the PR:
|
||||||
|
|
||||||
|
* One or more maintainers will use GitHub's review feature to review your PR.
|
||||||
|
* If the maintainer asks for any changes, edit your changes, push, and ask for another review.
|
||||||
|
* If the maintainer decides to pass on your PR, they will thank you for the contribution and explain why they won't be accepting the changes. That's ok! We still really appreciate you taking the time to do it, and we don't take that lightly. 💚
|
||||||
|
* If your PR gets accepted, it will be marked as such, and merged into the `master` branch soon after. Your contribution will be distributed to the masses next time the maintainers [tag a release](#tag-a-release)
|
||||||
|
|
||||||
|
## Contribute Code
|
||||||
|
|
||||||
|
We like code commits a lot! They're super handy, and they keep the project going and doing the work it needs to do to be useful to others.
|
||||||
|
|
||||||
|
Code contributions of just about any size are acceptable!
|
||||||
|
|
||||||
|
The main difference between code contributions and documentation contributions is that contributing code requires inclusion of relevant tests for the code being added or changed. Contributions without accompanying tests will be held off until a test is added, unless the maintainers consider the specific tests to be either impossible, or way too much of a burden for such a contribution.
|
||||||
|
|
||||||
|
To contribute code:
|
||||||
|
|
||||||
|
* [Set up the project](#project-setup).
|
||||||
|
* Make any necessary changes to the source code.
|
||||||
|
* Include any [additional documentation](#contribute-documentation) the changes might need.
|
||||||
|
* Write clear, concise commit message(s) using [conventional-changelog format](https://github.com/conventional-changelog/conventional-changelog-angular/blob/master/convention.md).
|
||||||
|
* Go to https://github.com/daviddarnes/garth/pulls and open a new pull request with your changes.
|
||||||
|
* If your PR is connected to an open issue, add a line in your PR's description that says `Fixes: #123`, where `#123` is the number of the issue you're fixing.
|
||||||
|
|
||||||
|
Once you've filed the PR:
|
||||||
|
|
||||||
|
* One or more maintainers will use GitHub's review feature to review your PR.
|
||||||
|
* If the maintainer asks for any changes, edit your changes, push, and ask for another review. Additional tags (such as `needs tests`) will be added depending on the review.
|
||||||
|
* If the maintainer decides to pass on your PR, they will thank you for the contribution and explain why they won't be accepting the changes. That's ok! We still really appreciate you taking the time to do it, and we don't take that lightly. 💚
|
||||||
|
* If your PR gets accepted, it will be marked as such, and merged into the `master` branch soon after. Your contribution will be distributed to the masses next time the maintainers publish an update.
|
||||||
|
|
||||||
|
## Provide Support on Issues
|
||||||
|
|
||||||
|
[Needs Collaborator](#join-the-project-team): none
|
||||||
|
|
||||||
|
Helping out other users with their questions is a really awesome way of contributing to any community. It's not uncommon for most of the issues on an open source projects being support-related questions by users trying to understand something they ran into, or find their way around a known bug.
|
||||||
|
|
||||||
|
Sometimes, the `support` label will be added to things that turn out to actually be other things, like bugs or feature requests. In that case, suss out the details with the person who filed the original issue, add a comment explaining what the bug is, and change the label from `support` to `bug` or `feature`. If you can't do this yourself, @mention a maintainer so they can do it.
|
||||||
|
|
||||||
|
In order to help other folks out with their questions:
|
||||||
|
|
||||||
|
* Go to the issue tracker and [filter open issues by the `support` label](https://github.com/daviddarnes/garth/issues?q=is%3Aopen+is%3Aissue+label%3Asupport).
|
||||||
|
* Read through the list until you find something that you're familiar enough with to give an answer to.
|
||||||
|
* Respond to the issue with whatever details are needed to clarify the question, or get more details about what's going on.
|
||||||
|
* Once the discussion wraps up and things are clarified, either close the issue, or ask the original issue filer (or a maintainer) to close it for you.
|
||||||
|
|
||||||
|
Some notes on picking up support issues:
|
||||||
|
|
||||||
|
* Avoid responding to issues you don't know you can answer accurately.
|
||||||
|
* As much as possible, try to refer to past issues with accepted answers. Link to them from your replies with the `#123` format.
|
||||||
|
* Be kind and patient with users -- often, folks who have run into confusing things might be upset or impatient. This is ok. Try to understand where they're coming from, and if you're too uncomfortable with the tone, feel free to stay away or withdraw from the issue. (note: if the user is outright hostile or is violating the CoC, [refer to the Code of Conduct](CODE_OF_CONDUCT.md) to resolve the conflict).
|
||||||
|
|
||||||
|
## Label Issues
|
||||||
|
|
||||||
|
[Needs Collaborator](#join-the-project-team): Issue Tracker
|
||||||
|
|
||||||
|
One of the most important tasks in handling issues is labelling them usefully and accurately. All other tasks involving issues ultimately rely on the issue being classified in such a way that relevant parties looking to do their own tasks can find them quickly and easily.
|
||||||
|
|
||||||
|
In order to label issues, [open up the list of unlabelled issues](https://github.com/daviddarnes/garth/issues?q=is%3Aopen+is%3Aissue+no%3Alabel) and, **from newest to oldest**, read through each one and apply issue labels according to the table below. If you're unsure about what label to apply, skip the issue and try the next one: don't feel obligated to label each and every issue yourself!
|
||||||
|
|
||||||
|
Label | Apply When | Notes
|
||||||
|
--- | --- | ---
|
||||||
|
`bug` | Cases where the code (or documentation) is behaving in a way it wasn't intended to. | If something is happening that surprises the *user* but does not go against the way the code is designed, it should use the `enhancement` label.
|
||||||
|
`critical` | Added to `bug` issues if the problem described makes the code completely unusable in a common situation. |
|
||||||
|
`documentation` | Added to issues or pull requests that affect any of the documentation for the project. | Can be combined with other labels, such as `bug` or `enhancement`.
|
||||||
|
`duplicate` | Added to issues or PRs that refer to the exact same issue as another one that's been previously labeled. | Duplicate issues should be marked and closed right away, with a message referencing the issue it's a duplicate of (with `#123`)
|
||||||
|
`enhancement` | Added to [feature requests](#request-a-feature), PRs, or documentation issues that are purely additive: the code or docs currently work as expected, but a change is being requested or suggested. |
|
||||||
|
`help wanted` | Applied by [Committers](#join-the-project-team) to issues and PRs that they would like to get outside help for. Generally, this means it's lower priority for the maintainer team to itself implement, but that the community is encouraged to pick up if they so desire | Never applied on first-pass labelling.
|
||||||
|
`in progress` | Applied by [Committers](#join-the-project-team) to PRs that are pending some work before they're ready for review. | The original PR submitter should @mention the team member that applied the label once the PR is complete.
|
||||||
|
`starter` | Applied by [Committers](#join-the-project-team) to issues that they consider good introductions to the project for people who have not contributed before. These are not necessarily "easy", but rather focused around how much context is necessary in order to understand what needs to be done for this project in particular. | Existing project members are expected to stay away from these unless they increase in priority.
|
||||||
|
`support` | This issue is either asking a question about how to use the project, clarifying the reason for unexpected behaviour, or possibly reporting a `bug` but does not have enough detail yet to determine whether it would count as such. | The label should be switched to `bug` if reliable reproduction steps are provided. Issues primarily with unintended configurations of a user's environment are not considered bugs, even if they cause crashes.
|
||||||
|
`wontfix` | Labellers may apply this label to issues that clearly have nothing at all to do with the project or are otherwise entirely outside of its scope/sphere of influence. [Committers](#join-the-project-team) may apply this label and close an issue or PR if they decide to pass on an otherwise relevant issue. | The issue or PR should be closed as soon as the label is applied, and a clear explanation provided of why the label was used. Contributors are free to contest the labelling, but the decision ultimately falls on committers as to whether to accept something or not.
|
||||||
|
|
||||||
|
## Clean Up Issues and PRs
|
||||||
|
|
||||||
|
[Needs Collaborator](#join-the-project-team): Issue Tracker
|
||||||
|
|
||||||
|
Issues and PRs can go stale after a while. Maybe they're abandoned. Maybe the team will just plain not have time to address them any time soon.
|
||||||
|
|
||||||
|
In these cases, they should be closed until they're brought up again or the interaction starts over.
|
||||||
|
|
||||||
|
To clean up issues and PRs:
|
||||||
|
|
||||||
|
* Search the issue tracker for issues or PRs, and add the term `updated:<=YYYY-MM-DD`, where the date is 30 days before today.
|
||||||
|
* Go through each issue *from oldest to newest*, and close them if **all of the following are true**:
|
||||||
|
* not opened by a maintainer
|
||||||
|
* not marked as `critical`
|
||||||
|
* not marked as `starter` or `help wanted` (these might stick around for a while, in general, as they're intended to be available)
|
||||||
|
* no explicit messages in the comments asking for it to be left open
|
||||||
|
* does not belong to a milestone
|
||||||
|
* Leave a message when closing saying "Cleaning up stale issue. Please reopen or ping us if and when you're ready to resume this. See https://github.com/daviddarnes/garth/blob/latest/CONTRIBUTING.md#clean-up-issues-and-prs for more details."
|
||||||
|
|
||||||
|
## Review Pull Requests
|
||||||
|
|
||||||
|
[Needs Collaborator](#join-the-project-team): Issue Tracker
|
||||||
|
|
||||||
|
While anyone can comment on a PR, add feedback, etc, PRs are only *approved* by team members with Issue Tracker or higher permissions.
|
||||||
|
|
||||||
|
PR reviews use [GitHub's own review feature](https://help.github.com/articles/about-pull-request-reviews/), which manages comments, approval, and review iteration.
|
||||||
|
|
||||||
|
Some notes:
|
||||||
|
|
||||||
|
* You may ask for minor changes ("nitpicks"), but consider whether they are really blockers to merging: try to err on the side of "approve, with comments".
|
||||||
|
* *ALL PULL REQUESTS* should be covered by a test: either by a previously-failing test, an existing test that covers the entire functionality of the submitted code, or new tests to verify any new/changed behaviour. All tests must also pass and follow established conventions. Test coverage should not drop, unless the specific case is considered reasonable by maintainers.
|
||||||
|
* Please make sure you're familiar with the code or documentation being updated, unless it's a minor change (spellchecking, minor formatting, etc). You may @mention another project member who you think is better suited for the review, but still provide a non-approving review of your own.
|
||||||
|
* Be extra kind: people who submit code/doc contributions are putting themselves in a pretty vulnerable position, and have put time and care into what they've done (even if that's not obvious to you!) -- always respond with respect, be understanding, but don't feel like you need to sacrifice your standards for their sake, either. Just don't be a jerk about it?
|
||||||
|
|
||||||
|
## Join the Project Team
|
||||||
|
|
||||||
|
### Ways to Join
|
||||||
|
|
||||||
|
There are many ways to contribute! Most of them don't require any official status unless otherwise noted. That said, there's a couple of positions that grant special repository abilities, and this section describes how they're granted and what they do.
|
||||||
|
|
||||||
|
All of the below positions are granted based on the project team's needs, as well as their consensus opinion about whether they would like to work with the person and think that they would fit well into that position. The process is relatively informal, and it's likely that people who express interest in participating can just be granted the permissions they'd like.
|
||||||
|
|
||||||
|
You can spot a collaborator on the repo by looking for the `[Collaborator]` or `[Owner]` tags next to their names.
|
||||||
|
|
||||||
|
Permission | Description
|
||||||
|
--- | ---
|
||||||
|
Issue Tracker | Granted to contributors who express a strong interest in spending time on the project's issue tracker. These tasks are mainly [labelling issues](#label-issues), [cleaning up old ones](#clean-up-issues-and-prs), and [reviewing pull requests](#review-pull-requests), as well as all the usual things non-team-member contributors can do. Issue handlers should not merge pull requests, tag releases, or directly commit code themselves: that should still be done through the usual pull request process. Becoming an Issue Handler means the project team trusts you to understand enough of the team's process and context to implement it on the issue tracker.
|
||||||
|
Committer | Granted to contributors who want to handle the actual pull request merges, tagging new versions, etc. Committers should have a good level of familiarity with the codebase, and enough context to understand the implications of various changes, as well as a good sense of the will and expectations of the project team.
|
||||||
|
Admin/Owner | Granted to people ultimately responsible for the project, its community, etc.
|
||||||
|
|
||||||
|
## Attribution
|
||||||
|
|
||||||
|
This guide was generated using the WeAllJS `CONTRIBUTING.md` generator. [Make your own](https://npm.im/weallcontribute)!
|
||||||
46
README.md
46
README.md
@ -7,30 +7,48 @@
|
|||||||
|
|
||||||
## Contents
|
## Contents
|
||||||
- [Installation](#installation)
|
- [Installation](#installation)
|
||||||
|
- [Customising](#customising)
|
||||||
- [Site settings](#site-settings)
|
- [Site settings](#site-settings)
|
||||||
- [Page layouts](#page-layouts)
|
- [Page layouts](#page-layouts)
|
||||||
- [Credits](#credits)
|
- [Credits](#credits)
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
### As a Fork
|
### As a Jekyll theme
|
||||||
|
|
||||||
|
1. Add `gem "garth-jekyll-theme"` to your `Gemfile` to add the theme as a dependancy
|
||||||
|
2. Run the command `bundle install` in the root of project to install the theme and its dependancies
|
||||||
|
3. Add `theme: garth-jekyll-theme` to your `_config.yml` file to set the site theme
|
||||||
|
4. Run `bundle exec jekyll serve` to build and serve your site
|
||||||
|
5. Done! Use the example [`_config.yml`](https://github.com/daviddarnes/garth/blob/master/_config.yml) file to set site-wide options
|
||||||
|
|
||||||
|
### As a GitHub Pages remote theme
|
||||||
|
|
||||||
|
1. Add `gem "jekyll-remote-theme"` to your `Gemfile` to add the theme as a dependancy
|
||||||
|
2. Run the command `bundle install` in the root of project to install the jekyll remote theme gem as a dependancy
|
||||||
|
3. Add `jekyll-remote-theme` to the list of `plugins` in your `_config.yml` file
|
||||||
|
4. Add `remote_theme: daviddarnes/garth` to your `_config.yml` file to set the site theme
|
||||||
|
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)
|
1. [Fork the repo](https://github.com/daviddarnes/garth#fork-destination-box)
|
||||||
2. Clone down the repo with `$ git clone git@github.com:username/reponame.git`
|
2. Replace the `Gemfile` with one stating all the gems used in your project
|
||||||
3. Delete the `demo/` folder and `screenshot.png` files
|
3. Delete the following unnecessary files/folders: `CODE_OF_CONDUCT.md`, `CONTRIBUTING.md`, `LICENSE`, `screenshot.png`, `CNAME` and `garth-jekyll-theme.gemspec`
|
||||||
4. Change the `CNAME` record to your projects' record
|
4. Run the command `bundle install` in the root of project to install the jekyll remote theme gem as a dependancy
|
||||||
5. Install bundler with `$ gem install bundler`
|
5. Run `bundle exec jekyll serve` to build and serve your site
|
||||||
6. Install gems with `$ bundle install`
|
6. Done! Use the example [`_config.yml`](https://github.com/daviddarnes/garth/blob/master/_config.yml) file to set site-wide options
|
||||||
7. Run Jekyll with `$ bundle exec jekyll serve --watch`
|
|
||||||
8. Begin hacking for your project
|
|
||||||
|
|
||||||
### As a Jekyll 3.3 theme gem
|
## Customising
|
||||||
|
|
||||||
1. Download the starter `/demo` content, [quick download link](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/daviddarnes/garth/tree/master/demo)
|
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, simply 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.
|
||||||
2. Install bundler with `$ gem install bundler`
|
|
||||||
3. Install gems with `$ bundle install`
|
To add your own styles copy the [`styles.scss`](https://github.com/daviddarnes/garth/blob/master/assets/styles.scss) into your own project with the same file path (`assets/styles.scss`). From there you can add your own styles, you can even optionally ignore the theme styles by removing the `@import "garth";` line.
|
||||||
4. Run Jekyll with `$ bundle exec jekyll serve --watch`
|
|
||||||
5. Begin hacking for your project
|
If you're just looking to set your own colours copy the [`_colors.scss`](https://github.com/daviddarnes/garth/blob/master/_sass/_colors.scss) file into your project at the same file path (`_sass/_settings.scss`) and change variables however you wish. The settings are a mixture of custom variables and settings from [Sassline](https://medium.com/@jakegiltsoff/sassline-v2-0-e424b2881e7e) - follow the link to find out how to configure the typographic settings.
|
||||||
|
|
||||||
## Site settings
|
## Site settings
|
||||||
|
|
||||||
|
|||||||
13
_config.yml
13
_config.yml
@ -10,16 +10,17 @@
|
|||||||
# 1. Files excluded from Jekyll builds
|
# 1. Files excluded from Jekyll builds
|
||||||
exclude:
|
exclude:
|
||||||
- README.md
|
- README.md
|
||||||
|
- CODE_OF_CONDUCT.md
|
||||||
|
- CONTRIBUTING.md
|
||||||
- screenshot.png
|
- screenshot.png
|
||||||
- LICENSE
|
- LICENSE
|
||||||
- CNAME
|
- CNAME
|
||||||
- Gemfile
|
- Gemfile
|
||||||
- Gemfile.lock
|
- Gemfile.lock
|
||||||
- demo/*
|
|
||||||
- garth-jekyll-theme.gemspec
|
- garth-jekyll-theme.gemspec
|
||||||
|
|
||||||
# 2. Installed Gems
|
# 2. Installed Gems
|
||||||
gems:
|
plugins:
|
||||||
- jekyll-paginate
|
- jekyll-paginate
|
||||||
|
|
||||||
# 3. Gem settings
|
# 3. Gem settings
|
||||||
@ -36,9 +37,9 @@ timezone: Europe/London # Timezone for blog posts and alike
|
|||||||
# 5. Collections
|
# 5. Collections
|
||||||
collections:
|
collections:
|
||||||
posts:
|
posts:
|
||||||
title: Welcome # Needed for Siteleaf
|
title: Blog # Needed for Siteleaf
|
||||||
output: true
|
output: true
|
||||||
description: "This is just a demo, find out more [about Garth](/about/)" # The post list page content
|
description: "This is just a demo, find out more [about Garth](about)" # The post list page content
|
||||||
|
|
||||||
# 6. Jekyll collections settings
|
# 6. Jekyll collections settings
|
||||||
defaults:
|
defaults:
|
||||||
@ -58,6 +59,8 @@ defaults:
|
|||||||
# 7. Site settings
|
# 7. Site settings
|
||||||
encoding: utf-8 # Make sure the encoding is right
|
encoding: utf-8 # Make sure the encoding is right
|
||||||
title: "Garth" # Site name or title
|
title: "Garth" # Site name or title
|
||||||
logo: "https://www.gravatar.com/avatar/6c0377abcf4da91cdd35dea4554b2a4c?s=500" # Site logo
|
logo: "/assets/logo.svg" # Site logo
|
||||||
description: "A stupidly simple theme for Jekyll, using the official Jekyll theme implementation" # Site description and default description
|
description: "A stupidly simple theme for Jekyll, using the official Jekyll theme implementation" # Site description and default description
|
||||||
url: "https://garth.darn.es" # Site url
|
url: "https://garth.darn.es" # Site url
|
||||||
|
baseurl: "/toast"
|
||||||
|
lang: en-GB
|
||||||
|
|||||||
@ -5,7 +5,7 @@
|
|||||||
<li class="item item--post">
|
<li class="item item--post">
|
||||||
<article class="article article--post typeset">
|
<article class="article article--post typeset">
|
||||||
|
|
||||||
<h2><a href="{{ page.url }}" title="{{ page.title }}">{{ page.title }}</a></h2>
|
<h2><a href="{{ site.baseurl }}{{ page.url }}">{{ page.title }}</a></h2>
|
||||||
{% include post-meta.html %}
|
{% include post-meta.html %}
|
||||||
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
||||||
|
|
||||||
@ -22,7 +22,7 @@
|
|||||||
<li class="item item--post">
|
<li class="item item--post">
|
||||||
<article class="article article--post typeset">
|
<article class="article article--post typeset">
|
||||||
|
|
||||||
<h2><a href="{{ page.url }}" title="{{ page.title }}">{{ page.title }}</a></h2>
|
<h2><a href="{{ site.baseurl }}{{ page.url }}">{{ page.title }}</a></h2>
|
||||||
{% include post-meta.html %}
|
{% include post-meta.html %}
|
||||||
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
{{ page.excerpt | markdownify | truncatewords: 60 }}
|
||||||
|
|
||||||
|
|||||||
@ -1,3 +1,15 @@
|
|||||||
|
{% if page.categories %}
|
||||||
|
{% capture categories %}
|
||||||
|
{% for category in page.categories %}
|
||||||
|
<span class="label label--category"><a href="{{ site.baseurl }}/categories#{{ category | downcase }}">{{ category }}</a></span>{% if forloop.last == false %},{% endif %}
|
||||||
|
{% endfor %}
|
||||||
|
{% endcapture %}
|
||||||
|
{% elsif page.category %}
|
||||||
|
{% capture categories %}
|
||||||
|
<span class="label label--category"><a href="{{ site.baseurl }}/categories#{{ page.category | downcase }}">{{ page.category }}</a></span>
|
||||||
|
{% endcapture %}
|
||||||
|
{% endif %}
|
||||||
|
|
||||||
<small class="small post-meta">
|
<small class="small post-meta">
|
||||||
{% if page.category %}<span class="label label--category">{{ page.category }}</span> · {% endif %}<time datetime="{{ page.date | date_to_xmlschema }}" class="time">{{ page.date | date_to_string }}</time>
|
{{ categories | append: " · " }}<time datetime="{{ page.date | date_to_xmlschema }}" class="time">{{ page.date | date_to_string }}</time>
|
||||||
</small>
|
</small>
|
||||||
|
|||||||
@ -1,7 +1,7 @@
|
|||||||
<nav class="nav nav--paginator">
|
<nav class="nav nav--paginator">
|
||||||
|
|
||||||
{% if paginator.previous_page %}
|
{% if paginator.previous_page %}
|
||||||
<a href="{{ paginator.previous_page_path }}" class="pagination pagination--previous">← Previous</a>
|
<a href="{{ site.baseurl }}{{ paginator.previous_page_path }}" class="pagination pagination--previous">← Previous</a>
|
||||||
{% else %}
|
{% else %}
|
||||||
<span class="pagination pagination--previous">← Previous</span>
|
<span class="pagination pagination--previous">← Previous</span>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
@ -9,7 +9,7 @@
|
|||||||
<span class="pagination pagination--counter">Page: {{ paginator.page }} of {{ paginator.total_pages }}</span>
|
<span class="pagination pagination--counter">Page: {{ paginator.page }} of {{ paginator.total_pages }}</span>
|
||||||
|
|
||||||
{% if paginator.next_page %}
|
{% if paginator.next_page %}
|
||||||
<a href="{{ paginator.next_page_path }}" class="pagination pagination--next">Next →</a>
|
<a href="{{ site.baseurl }}{{ paginator.next_page_path }}" class="pagination pagination--next">Next →</a>
|
||||||
{% else %}
|
{% else %}
|
||||||
<span class="pagination pagination--next">Next →</span>
|
<span class="pagination pagination--next">Next →</span>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|||||||
@ -1,6 +1,6 @@
|
|||||||
<header class="header">
|
<header class="header">
|
||||||
<div class="container">
|
<div class="container">
|
||||||
{% include site-logo.html %}
|
{% if site.logo %}{% include site-logo.html %}{% endif %}
|
||||||
{% include site-nav.html %}
|
{% include site-nav.html %}
|
||||||
</div>
|
</div>
|
||||||
</header>
|
</header>
|
||||||
|
|||||||
@ -1,3 +1,3 @@
|
|||||||
<a class="logo" href="{{ site.url }}" title="{{ site.title }}">
|
<a class="logo" href="{{ site.baseurl }}/">
|
||||||
<img src="{{ site.logo }}" alt="{{ site.title }} logo"/>
|
<img src="{{ site.baseurl }}{{ site.logo }}" alt="{{ site.title }} logo"/>
|
||||||
</a>
|
</a>
|
||||||
|
|||||||
@ -5,9 +5,9 @@
|
|||||||
<li class="item item--nav{% if item.url == page.url %} item--current{% endif %}">
|
<li class="item item--nav{% if item.url == page.url %} item--current{% endif %}">
|
||||||
{% if item.collectionpage %}
|
{% if item.collectionpage %}
|
||||||
{% assign collectiondata = site.collections | where: "label", item.collectionpage | first %}
|
{% assign collectiondata = site.collections | where: "label", item.collectionpage | first %}
|
||||||
<a href="{{ item.url }}">{{ collectiondata.title }}</a>
|
<a href="{{ site.baseurl }}{{ item.url }}">{{ collectiondata.title }}</a>
|
||||||
{% else %}
|
{% else %}
|
||||||
<a href="{{ item.url }}">{{ item.title }}</a>
|
<a href="{{ site.baseurl }}{{ item.url }}">{{ item.title }}</a>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</li>
|
</li>
|
||||||
{% endunless %}
|
{% endunless %}
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
<!DOCTYPE html>
|
<!DOCTYPE html>
|
||||||
<html lang="en-GB">
|
<html lang="{{ site.lang | default: "en-US" }}">
|
||||||
<head>
|
<head>
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||||
{% if page.collectionpage %}
|
{% if page.collectionpage %}
|
||||||
|
|||||||
@ -1,9 +1,10 @@
|
|||||||
// Colours
|
// Colours
|
||||||
$color__site--background: #ffefc8;
|
$bodyColour: #46412A;
|
||||||
$color__site--heading: darken(#46412A, 5%);
|
$headingColour: darken($bodyColour, 5%);
|
||||||
$color__site--body: #46412A;
|
$linkColour: #5B5BFF;
|
||||||
$color__site--captions: lighten($color__site--heading, 40%);
|
$hoverColour: darken($linkColour, 10%);
|
||||||
$color__site--link: #5B5BFF;
|
$captionColour: lighten($headingColour, 40%);
|
||||||
$color__site--link--hover: darken($color__site--link, 10%);
|
$white: #fff;
|
||||||
$color__site--link--current: desaturate($color__site--link, 100%);
|
|
||||||
$color__site--accent: #5B5BFF;
|
$backgroundColour: #ffefc8;
|
||||||
|
$codeBackgroundColour: darken($backgroundColour, 5%);
|
||||||
|
|||||||
@ -4,4 +4,3 @@
|
|||||||
@import "sassline-base/modular-scale";
|
@import "sassline-base/modular-scale";
|
||||||
@import "sassline-base/mixins";
|
@import "sassline-base/mixins";
|
||||||
@import "sassline-base/typography";
|
@import "sassline-base/typography";
|
||||||
@import "sassline-base/layouts";
|
|
||||||
|
|||||||
168
_sass/_theme.scss
Normal file
168
_sass/_theme.scss
Normal file
@ -0,0 +1,168 @@
|
|||||||
|
// Structural elements
|
||||||
|
body {
|
||||||
|
background: $backgroundColour;
|
||||||
|
color: $bodyColour;
|
||||||
|
height: 100%;
|
||||||
|
display: flex;
|
||||||
|
@include flex-direction(column);
|
||||||
|
overflow-x: hidden;
|
||||||
|
}
|
||||||
|
|
||||||
|
.container {
|
||||||
|
width: 90%;
|
||||||
|
max-width: 900px;
|
||||||
|
margin: 0 auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Header, feature and footer
|
||||||
|
.header,
|
||||||
|
.footer {
|
||||||
|
.container {
|
||||||
|
padding: 1rem 0;
|
||||||
|
@include flexbox;
|
||||||
|
@include flex-direction(column);
|
||||||
|
@include align-items(center);
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
@include breakpoint(break-1) {
|
||||||
|
.container {
|
||||||
|
@include flex-direction(row);
|
||||||
|
@include justify-content(space-between);
|
||||||
|
text-align: inherit;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.header {
|
||||||
|
@include flex(0, 0, auto);
|
||||||
|
background: darken($backgroundColour, 10%);
|
||||||
|
}
|
||||||
|
|
||||||
|
.logo {
|
||||||
|
display: inline-block;
|
||||||
|
line-height: 0;
|
||||||
|
border-radius: 100%;
|
||||||
|
overflow: hidden;
|
||||||
|
img {
|
||||||
|
width: 4rem;
|
||||||
|
height: 4rem;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.small {
|
||||||
|
padding-top: .6rem;
|
||||||
|
color: $captionColour;
|
||||||
|
display: inline-block;
|
||||||
|
}
|
||||||
|
|
||||||
|
.footer {
|
||||||
|
border-top: 1px solid darken($backgroundColour, 15%);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Nav and copyright
|
||||||
|
.nav {
|
||||||
|
&--paginator {
|
||||||
|
@include flexbox;
|
||||||
|
@include justify-content(center);
|
||||||
|
color: $captionColour;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.pagination {
|
||||||
|
margin: 0 1rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Main content
|
||||||
|
.main {
|
||||||
|
@include flexbox;
|
||||||
|
@include flex-direction(column);
|
||||||
|
@include flex(1, 0, auto);
|
||||||
|
margin-bottom: 1.6rem;
|
||||||
|
@include breakpoint(break-1) {
|
||||||
|
@include flex-direction(row);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Lists
|
||||||
|
.list {
|
||||||
|
&--posts {
|
||||||
|
list-style: none;
|
||||||
|
}
|
||||||
|
&--nav {
|
||||||
|
list-style: none;
|
||||||
|
}
|
||||||
|
.item--post {
|
||||||
|
margin-left: 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.item {
|
||||||
|
&--nav {
|
||||||
|
display: inline-block;
|
||||||
|
margin-left: 1rem;
|
||||||
|
&:first-of-type {
|
||||||
|
margin-left: 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
&--current {
|
||||||
|
a {
|
||||||
|
color: desaturate($linkColour, 100%);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Images and media elements
|
||||||
|
img {
|
||||||
|
max-width: 100%;
|
||||||
|
height: auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
audio,
|
||||||
|
video {
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Text selection
|
||||||
|
::selection {
|
||||||
|
background: $headingColour;
|
||||||
|
color: $white;
|
||||||
|
text-shadow: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Sassline overrides
|
||||||
|
.typeset {
|
||||||
|
.button,
|
||||||
|
button {
|
||||||
|
background-image: none;
|
||||||
|
text-shadow: none;
|
||||||
|
color: lighten(invert($bodyColour), 15%);
|
||||||
|
&:hover,
|
||||||
|
&:active,
|
||||||
|
&:focus {
|
||||||
|
background-image: none;
|
||||||
|
color: lighten(invert($bodyColour), 15%);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
hr {
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
|
li {
|
||||||
|
margin-bottom: .3em;
|
||||||
|
> p {
|
||||||
|
padding: 0;
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
pre {
|
||||||
|
white-space: pre;
|
||||||
|
overflow-x: scroll;
|
||||||
|
}
|
||||||
|
}
|
||||||
11
_sass/garth.scss
Normal file
11
_sass/garth.scss
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
@charset "utf-8";
|
||||||
|
|
||||||
|
// Import frameworks & theme styles
|
||||||
|
@import
|
||||||
|
"normalize",
|
||||||
|
"colors",
|
||||||
|
"sassline-base",
|
||||||
|
"syntax",
|
||||||
|
"flex",
|
||||||
|
"theme"
|
||||||
|
;
|
||||||
@ -1,282 +0,0 @@
|
|||||||
// Layouts
|
|
||||||
// ---------------------------------------
|
|
||||||
|
|
||||||
// Container.
|
|
||||||
.section {
|
|
||||||
@include clearfix;
|
|
||||||
|
|
||||||
margin: 0 auto;
|
|
||||||
position: relative;
|
|
||||||
width: 94%;
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
@include maxwidth(3);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
@include maxwidth(4);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Single column (based on measure for typeset content).
|
|
||||||
.single-measure {
|
|
||||||
@include measure(all);
|
|
||||||
|
|
||||||
margin: 0 auto;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Base column styles.
|
|
||||||
.column {
|
|
||||||
@include measure(0);
|
|
||||||
|
|
||||||
margin: 0 auto;
|
|
||||||
width: 100%;
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
float: left;
|
|
||||||
margin: initial;
|
|
||||||
max-width: initial;
|
|
||||||
padding-left: map-get($gutterwidths, small);
|
|
||||||
padding-right: map-get($gutterwidths, small);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
padding-left: map-get($gutterwidths, medium);
|
|
||||||
padding-right: map-get($gutterwidths, medium);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Two columns.
|
|
||||||
.column--duo {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
width: 50%;
|
|
||||||
|
|
||||||
&:nth-of-type(2n+3) {
|
|
||||||
clear: left;
|
|
||||||
}
|
|
||||||
|
|
||||||
&:nth-of-type(n+3) {
|
|
||||||
margin-top: 3rem;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Three columns.
|
|
||||||
.column--trio {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
width: 33.333%;
|
|
||||||
|
|
||||||
&:nth-of-type(3n+4) {
|
|
||||||
clear: left;
|
|
||||||
}
|
|
||||||
|
|
||||||
&:nth-of-type(n+4) {
|
|
||||||
margin-top: 3rem;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Four columns. Two at smaller breakpoints.
|
|
||||||
.column--quad {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
width: 50%;
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-2) {
|
|
||||||
width: 25%;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Two column layout with a main text column and a sidebar.
|
|
||||||
|
|
||||||
// Main column.
|
|
||||||
.column--main {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
@include ideal-measure(1, small);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-2) {
|
|
||||||
@include ideal-measure(2, small);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
@include ideal-measure(3, medium);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
@include ideal-measure(4, medium);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sidebar.
|
|
||||||
.column--sidebar {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
@include ideal-measure(1, small, false);
|
|
||||||
|
|
||||||
padding-right: map-get($gutterwidths, medium);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-2) {
|
|
||||||
@include ideal-measure(2, small, false);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
@include ideal-measure(3, medium, false);
|
|
||||||
|
|
||||||
padding-right: map-get($gutterwidths, large);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
@include ideal-measure(4, medium, false);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// If sidebar on the right side.
|
|
||||||
.column--main + .column--sidebar {
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
padding-left: map-get($gutterwidths, medium);
|
|
||||||
padding-right: map-get($gutterwidths, small);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
padding-left: map-get($gutterwidths, large);
|
|
||||||
padding-right: map-get($gutterwidths, medium);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Set the main text one level down in the modular scale for narrower columns.
|
|
||||||
.column--trio,
|
|
||||||
.column--quad,
|
|
||||||
.column--sidebar {
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
|
|
||||||
p {
|
|
||||||
@include sassline($fontsize: eta, $font: $bodytype, $lineheight: 2, $below: 2, $breakpoint: 3);
|
|
||||||
}
|
|
||||||
|
|
||||||
li {
|
|
||||||
@include fontsize(eta, 3);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
|
|
||||||
p {
|
|
||||||
@include sassline($fontsize: eta, $font: $bodytype, $lineheight: 2, $below: 2, $breakpoint: 4);
|
|
||||||
}
|
|
||||||
|
|
||||||
li {
|
|
||||||
@include fontsize(eta, 4);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Main column on the right with inline sidenotes.
|
|
||||||
// The sidenotes will move out the column into the sidebar position aligned to the baseline.
|
|
||||||
.column--right {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
@include ideal-measure(1, small);
|
|
||||||
@include ideal-measure(1, small, false, margin-left);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-2) {
|
|
||||||
@include ideal-measure(2, small);
|
|
||||||
@include ideal-measure(2, small, false, margin-left);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
@include ideal-measure(3, medium);
|
|
||||||
@include ideal-measure(3, medium, false, margin-left);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
@include ideal-measure(4, medium);
|
|
||||||
@include ideal-measure(4, medium, false, margin-left);
|
|
||||||
}
|
|
||||||
|
|
||||||
.sidenote {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
@include ideal-measure(1, small, false);
|
|
||||||
|
|
||||||
left: 0;
|
|
||||||
padding-left: map-get($gutterwidths, small);
|
|
||||||
padding-right: map-get($gutterwidths, medium);
|
|
||||||
position: absolute;
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-2) {
|
|
||||||
@include ideal-measure(2, small, false);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
@include ideal-measure(3, medium, false);
|
|
||||||
|
|
||||||
padding-right: map-get($gutterwidths, large);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
@include ideal-measure(4, medium, false);
|
|
||||||
|
|
||||||
padding-left: map-get($gutterwidths, medium);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Main column on the left with inline sidenotes.
|
|
||||||
.column--left {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
@include ideal-measure(1, small);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-2) {
|
|
||||||
@include ideal-measure(2, small);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
@include ideal-measure(3, medium);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
@include ideal-measure(4, medium);
|
|
||||||
}
|
|
||||||
|
|
||||||
.sidenote {
|
|
||||||
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
@include ideal-measure(1, small, false);
|
|
||||||
@include ideal-measure(1, small, true, left);
|
|
||||||
|
|
||||||
padding-left: map-get($gutterwidths, medium);
|
|
||||||
padding-right: map-get($gutterwidths, small);
|
|
||||||
position: absolute;
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-2) {
|
|
||||||
@include ideal-measure(2, small, false);
|
|
||||||
@include ideal-measure(2, small, true, left);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-3) {
|
|
||||||
@include ideal-measure(3, medium, false);
|
|
||||||
@include ideal-measure(3, medium, true, left);
|
|
||||||
|
|
||||||
padding-left: map-get($gutterwidths, large);
|
|
||||||
}
|
|
||||||
|
|
||||||
@include breakpoint(break-4) {
|
|
||||||
@include ideal-measure(4, medium, false);
|
|
||||||
@include ideal-measure(4, medium, true, left);
|
|
||||||
|
|
||||||
padding-right: map-get($gutterwidths, medium);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -94,15 +94,3 @@ $white: #FFFFFF !default;
|
|||||||
// Background colours.
|
// Background colours.
|
||||||
$backgroundColour: #FCFCFC !default;
|
$backgroundColour: #FCFCFC !default;
|
||||||
$codeBackgroundColour: #F5F4F2 !default;
|
$codeBackgroundColour: #F5F4F2 !default;
|
||||||
|
|
||||||
|
|
||||||
// Alembic reassigned variables
|
|
||||||
$headingColour: $color__site--heading;
|
|
||||||
$bodyColour: $color__site--body;
|
|
||||||
$linkColour: $color__site--link;
|
|
||||||
$hoverColour: $color__site--link--hover;
|
|
||||||
$captionColour: $color__site--captions;
|
|
||||||
$white: #fff;
|
|
||||||
|
|
||||||
$backgroundColour: $color__site--background;
|
|
||||||
$codeBackgroundColour: darken($color__site--background, 5%);
|
|
||||||
|
|||||||
1
assets/logo.svg
Normal file
1
assets/logo.svg
Normal file
@ -0,0 +1 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 42 42"><g fill="none" fill-rule="evenodd"><path fill="#8549FC" fill-rule="nonzero" d="M11 16.21V26c.4.31 1.1.64 1.99.93A27.1 27.1 0 0 0 21 28c3.08 0 5.95-.4 8.01-1.07A7.1 7.1 0 0 0 31 26v-9.79C28.85 17.3 25.17 18 21 18s-7.85-.71-10-1.79zM33 14v12c0 2.2-5.37 4-12 4S9 28.2 9 26V14c0-2.2 5.37-4 12-4s12 1.8 12 4zm-3.99-.93A27.1 27.1 0 0 0 21 12c-3.08 0-5.95.4-8.01 1.07-.9.3-1.58.62-1.99.93.4.31 1.1.64 1.99.93A27.1 27.1 0 0 0 21 16c3.08 0 5.95-.4 8.01-1.07A7.1 7.1 0 0 0 31 14a7.1 7.1 0 0 0-1.99-.93zM15 24.5a1 1 0 0 1-2 0v-5a1 1 0 0 1 2 0v5zm7 1a1 1 0 0 1-2 0v-5a1 1 0 0 1 2 0v5zm7-1a1 1 0 0 1-2 0v-5a1 1 0 0 1 2 0v5z"/><rect width="42" height="42"/></g></svg>
|
||||||
|
After Width: | Height: | Size: 714 B |
@ -2,170 +2,4 @@
|
|||||||
title: false
|
title: false
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@import "garth";
|
||||||
// Frameworks & Imports
|
|
||||||
@charset "utf-8";
|
|
||||||
@import "colors.scss";
|
|
||||||
@import "normalize";
|
|
||||||
@import "sassline-base";
|
|
||||||
@import "syntax";
|
|
||||||
@import "flex";
|
|
||||||
|
|
||||||
|
|
||||||
// Structural elements
|
|
||||||
body {
|
|
||||||
background: $color__site--background;
|
|
||||||
color: $color__site--body;
|
|
||||||
height: 100%;
|
|
||||||
display: flex;
|
|
||||||
@include flex-direction(column);
|
|
||||||
overflow-x: hidden;
|
|
||||||
}
|
|
||||||
|
|
||||||
.container {
|
|
||||||
width: 90%;
|
|
||||||
max-width: 900px;
|
|
||||||
margin: 0 auto;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// Header, feature and footer
|
|
||||||
.header,
|
|
||||||
.footer {
|
|
||||||
.container {
|
|
||||||
padding: 1rem 0;
|
|
||||||
@include flexbox;
|
|
||||||
@include flex-direction(column);
|
|
||||||
@include align-items(center);
|
|
||||||
text-align: center;
|
|
||||||
}
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
.container {
|
|
||||||
@include flex-direction(row);
|
|
||||||
@include justify-content(space-between);
|
|
||||||
text-align: inherit;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.header {
|
|
||||||
@include flex(0, 0, auto);
|
|
||||||
background: darken($color__site--background, 10%);
|
|
||||||
}
|
|
||||||
|
|
||||||
.logo {
|
|
||||||
display: inline-block;
|
|
||||||
line-height: 0;
|
|
||||||
border-radius: 100%;
|
|
||||||
overflow: hidden;
|
|
||||||
img {
|
|
||||||
width: 4rem;
|
|
||||||
height: 4rem;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.small {
|
|
||||||
padding-top: .6rem;
|
|
||||||
color: $color__site--captions;
|
|
||||||
display: inline-block;
|
|
||||||
}
|
|
||||||
|
|
||||||
.footer {
|
|
||||||
border-top: 1px solid darken($color__site--background, 15%);
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// Nav and copyright
|
|
||||||
.nav {
|
|
||||||
&--paginator {
|
|
||||||
@include flexbox;
|
|
||||||
@include justify-content(center);
|
|
||||||
color: $color__site--captions;
|
|
||||||
text-align: center;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.pagination {
|
|
||||||
margin: 0 1rem;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// Main content
|
|
||||||
.main {
|
|
||||||
@include flexbox;
|
|
||||||
@include flex-direction(column);
|
|
||||||
@include flex(1, 0, auto);
|
|
||||||
margin-bottom: 1.6rem;
|
|
||||||
@include breakpoint(break-1) {
|
|
||||||
@include flex-direction(row);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// Lists
|
|
||||||
.list {
|
|
||||||
&--posts {
|
|
||||||
list-style: none;
|
|
||||||
}
|
|
||||||
&--nav {
|
|
||||||
list-style: none;
|
|
||||||
}
|
|
||||||
.item--post {
|
|
||||||
margin-left: 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.item {
|
|
||||||
&--nav {
|
|
||||||
display: inline-block;
|
|
||||||
margin-left: 1rem;
|
|
||||||
&:first-of-type {
|
|
||||||
margin-left: 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
&--current {
|
|
||||||
a {
|
|
||||||
color: $color__site--link--current;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// Images and media elements
|
|
||||||
img {
|
|
||||||
max-width: 100%;
|
|
||||||
height: auto;
|
|
||||||
}
|
|
||||||
|
|
||||||
audio,
|
|
||||||
video {
|
|
||||||
width: 100%;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// Text selection
|
|
||||||
::selection {
|
|
||||||
background: $color__site--heading;
|
|
||||||
color: $color__site--background;
|
|
||||||
text-shadow: none;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// Sassline overrides
|
|
||||||
.typeset {
|
|
||||||
.button,
|
|
||||||
button {
|
|
||||||
background-image: none;
|
|
||||||
text-shadow: none;
|
|
||||||
color: lighten(invert($color__site--body), 15%);
|
|
||||||
&:hover,
|
|
||||||
&:active,
|
|
||||||
&:focus {
|
|
||||||
background-image: none;
|
|
||||||
color: lighten(invert($color__site--body), 15%);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
hr {
|
|
||||||
width: 100%;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|||||||
@ -1,7 +0,0 @@
|
|||||||
---
|
|
||||||
title: "404"
|
|
||||||
excerpt: "Page Not Found"
|
|
||||||
permalink: 404.html
|
|
||||||
---
|
|
||||||
|
|
||||||
Sorry, but the page could not be found.
|
|
||||||
12
demo/Gemfile
12
demo/Gemfile
@ -1,12 +0,0 @@
|
|||||||
source "https://rubygems.org"
|
|
||||||
|
|
||||||
# Make sure Jekyll 3.3 is running
|
|
||||||
gem "jekyll", "~> 3.3"
|
|
||||||
|
|
||||||
# The theme for the site
|
|
||||||
gem "garth-jekyll-theme", "~> 0.5"
|
|
||||||
|
|
||||||
# The plugins for the site
|
|
||||||
group :jekyll_plugins do
|
|
||||||
gem "jekyll-paginate"
|
|
||||||
end
|
|
||||||
@ -1,63 +0,0 @@
|
|||||||
# Site configuration
|
|
||||||
# 1. Files excluded from Jekyll builds
|
|
||||||
# 2. Installed Gems
|
|
||||||
# 3. Gem settings
|
|
||||||
# 4. Jekyll settings
|
|
||||||
# 5. Collections
|
|
||||||
# 6. Jekyll collections settings
|
|
||||||
# 7. Site settings
|
|
||||||
|
|
||||||
# 1. Files excluded from Jekyll builds
|
|
||||||
exclude:
|
|
||||||
- README.md
|
|
||||||
- screenshot.png
|
|
||||||
- LICENSE
|
|
||||||
- CNAME
|
|
||||||
- Gemfile
|
|
||||||
- Gemfile.lock
|
|
||||||
|
|
||||||
# 2. Installed Gems
|
|
||||||
gems:
|
|
||||||
- jekyll-paginate
|
|
||||||
|
|
||||||
theme: garth-jekyll-theme
|
|
||||||
|
|
||||||
# 3. Gem settings
|
|
||||||
paginate: 2 # jekyll-paginate > items per page
|
|
||||||
paginate_path: blog/page:num # jekyll-paginate > blog page
|
|
||||||
|
|
||||||
# 4. Jekyll settings
|
|
||||||
sass:
|
|
||||||
style: compressed # Style compression
|
|
||||||
permalink: pretty # Permalink style (/YYYY/MM/DD/page-name/)
|
|
||||||
excerpt_separator: <!-- more --> # Marks end of excerpt in posts
|
|
||||||
timezone: Europe/London # Timezone for blog posts and alike
|
|
||||||
|
|
||||||
# 5. Collections
|
|
||||||
collections:
|
|
||||||
posts:
|
|
||||||
title: Welcome # Needed for Siteleaf
|
|
||||||
output: true
|
|
||||||
description: "This is just a demo, find out more [about Garth](/about/)" # The post list page content
|
|
||||||
|
|
||||||
# 6. Jekyll collections settings
|
|
||||||
defaults:
|
|
||||||
-
|
|
||||||
scope:
|
|
||||||
path: ""
|
|
||||||
type: pages
|
|
||||||
values:
|
|
||||||
layout: page # Default layout
|
|
||||||
-
|
|
||||||
scope:
|
|
||||||
path: ""
|
|
||||||
type: posts
|
|
||||||
values:
|
|
||||||
layout: post # Default layout
|
|
||||||
|
|
||||||
# 7. Site settings
|
|
||||||
encoding: utf-8 # Make sure the encoding is right
|
|
||||||
title: "Garth" # Site name or title
|
|
||||||
logo: "https://www.gravatar.com/avatar/6c0377abcf4da91cdd35dea4554b2a4c?s=500" # Site logo
|
|
||||||
description: "A stupidly simple theme for Jekyll, using the official Jekyll theme implementation" # Site description and default description
|
|
||||||
url: "https://garth.darn.es" # Site url
|
|
||||||
@ -1,14 +0,0 @@
|
|||||||
---
|
|
||||||
title: What was Wayne's World?
|
|
||||||
category: General
|
|
||||||
---
|
|
||||||
|
|
||||||
Wayne's World is a 1992 American comedy film directed by Penelope Spheeris and starring Mike Myers as Wayne Campbell and Dana Carvey as Garth Algar. The film was adapted from a sketch of the same name on NBC's Saturday Night Live.
|
|
||||||
|
|
||||||
<!-- more -->
|
|
||||||
|
|
||||||
The film grossed US$121.6 million in its theatrical run, placing it as the tenth highest-grossing film of 1992 and the highest-grossing of the 11 films based on Saturday Night Live skits. It was filmed in 34 days.
|
|
||||||
|
|
||||||
Wayne's World was Myers' feature film debut. It also features Rob Lowe, Tia Carrere, Lara Flynn Boyle, Brian Doyle-Murray, Robert Patrick (spoofing his role in Terminator 2: Judgment Day), Chris Farley, Ed O'Neill, Ione Skye, Meat Loaf, and Alice Cooper. Wayne's World was released on February 14, 1992, and was a critical and commercial success. A sequel, Wayne's World 2, was released on December 10, 1993. In 2000, readers of Total Film magazine voted Wayne's World the 41st-greatest comedy film of all time.
|
|
||||||
|
|
||||||
_Originally from [Wayne's World (film) - Wikipedia](https://en.wikipedia.org/wiki/Wayne%27s_World_(film))_
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
---
|
|
||||||
title: Who is Mike Myers?
|
|
||||||
category: People
|
|
||||||
---
|
|
||||||
|
|
||||||
Michael John "Mike" Myers (born May 25, 1963) is a Canadian-born actor, comedian, screenwriter, and film producer, who also holds UK and US citizenship.[1] He is known for his run as a featured performer on Saturday Night Live from 1989 to 1995, and for playing the title roles in the Wayne's World, Austin Powers, and Shrek films. He also directed the documentary film Supermensch: The Legend of Shep Gordon, and had a small role in Quentin Tarantino's Inglourious Basterds in 2009.
|
|
||||||
|
|
||||||
<!-- more -->
|
|
||||||
|
|
||||||
Myers was born on May 25, 1963 in Scarborough, Ontario, the son of English-born parents Eric Myers (1922–1991), an insurance agent, and his wife, Alice E. (née Hind; born 1926), an office supervisor and a veteran of the Royal Air Force.
|
|
||||||
|
|
||||||
Both his parents were from Liverpool and he has two older brothers, Paul, an indie rock singer-songwriter, broadcaster and author, and Peter, a Sears Canada employee.
|
|
||||||
|
|
||||||
The family is of English, Scottish and Irish ancestry. Myers was raised Protestant.
|
|
||||||
|
|
||||||
Myers reportedly holds Canadian, U.S. and British citizenship.
|
|
||||||
|
|
||||||
Myers grew up in North York and then Scarborough, where he attended Sir John A. MacDonald Collegiate Institute and then graduated from Stephen Leacock Collegiate Institute in 1982.
|
|
||||||
|
|
||||||
_Originally from [Mike Myers - Wikipedia](https://en.wikipedia.org/wiki/Mike_Myers)_
|
|
||||||
@ -1,14 +0,0 @@
|
|||||||
---
|
|
||||||
title: Who is Dana Carvey?
|
|
||||||
category: People
|
|
||||||
---
|
|
||||||
|
|
||||||
Dana Thomas Carvey (born June 2, 1955) is an American actor and stand-up comedian known for his work as a cast member on Saturday Night Live and for playing the role of Garth Algar in the Wayne's World films.
|
|
||||||
|
|
||||||
<!-- more -->
|
|
||||||
|
|
||||||
Carvey was born in Missoula, Montana, the son of Billie Dahl, a schoolteacher, and Bud Carvey, a high-school business teacher. Carvey is the brother of Brad Carvey, the engineer/designer of the Video Toaster. The character Garth Algar is loosely based on Brad. Carvey has English, German, Irish, Norwegian, and Swedish ancestry, and was raised Lutheran. When he was three years old, his family moved to San Carlos, California, in the San Francisco Bay Area. He received his first drum kit at an early age. He attended Tierra Linda Junior High in San Carlos, Carlmont High School in Belmont, California (where he was a member of the Central Coast Section champion cross country team), College of San Mateo in San Mateo, California, and received his bachelor's degree in broadcast communications from San Francisco State University.
|
|
||||||
|
|
||||||
He had a minor role in Halloween II, and co-starred on One of the Boys in 1982, a short-lived television sitcom that also starred Mickey Rooney, Nathan Lane, and Meg Ryan. In 1984, Carvey had a small role in Rob Reiner's film This Is Spinal Tap, in which he played a mime, with fellow comedian Billy Crystal (who tells him "Mime is money!"). He also appeared in the short-lived film-based action television series Blue Thunder.
|
|
||||||
|
|
||||||
_Originally from [Dana Carvey - Wikipedia](https://en.wikipedia.org/wiki/Dana_Carvey)_
|
|
||||||
@ -1,30 +0,0 @@
|
|||||||
---
|
|
||||||
title: About Garth
|
|
||||||
---
|
|
||||||
|
|
||||||
A stupidly simple 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)
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### As a Fork
|
|
||||||
|
|
||||||
1. [Fork the repo](https://github.com/daviddarnes/garth#fork-destination-box)
|
|
||||||
2. Clone down the repo with `$ git clone git@github.com:username/reponame.git`
|
|
||||||
3. Delete the `demo/` folder and `screenshot.png` files
|
|
||||||
4. Change the `CNAME` record to your projects' record
|
|
||||||
5. Install bundler with `$ gem install bundler`
|
|
||||||
6. Install gems with `$ bundle install`
|
|
||||||
7. Run Jekyll with `$ bundle exec jekyll serve --watch`
|
|
||||||
8. Begin hacking for your project
|
|
||||||
|
|
||||||
### As a Jekyll 3.3 theme gem
|
|
||||||
|
|
||||||
1. Download the starter `/demo` content, [quick download link](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/daviddarnes/garth/tree/master/demo)
|
|
||||||
2. Install bundler with `$ gem install bundler`
|
|
||||||
3. Install gems with `$ bundle install`
|
|
||||||
4. Run Jekyll with `$ bundle exec jekyll serve --watch`
|
|
||||||
5. Begin hacking for your project
|
|
||||||
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
Gem::Specification.new do |spec|
|
Gem::Specification.new do |spec|
|
||||||
spec.name = "garth-jekyll-theme"
|
spec.name = "garth-jekyll-theme"
|
||||||
spec.version = "0.5.0"
|
spec.version = "1.0.0"
|
||||||
spec.authors = ["David Darnes"]
|
spec.authors = ["David Darnes"]
|
||||||
spec.email = ["me@daviddarnes.com"]
|
spec.email = ["me@daviddarnes.com"]
|
||||||
|
|
||||||
@ -11,10 +11,12 @@ Gem::Specification.new do |spec|
|
|||||||
spec.homepage = "https://garth.darn.es"
|
spec.homepage = "https://garth.darn.es"
|
||||||
spec.license = "MIT"
|
spec.license = "MIT"
|
||||||
|
|
||||||
|
spec.metadata["plugin_type"] = "theme"
|
||||||
|
|
||||||
spec.files = `git ls-files -z`.split("\x0").select { |f| f.match(%r{^(assets|_layouts|_includes|_sass|LICENSE|README)}i) }
|
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.3"
|
spec.add_runtime_dependency "jekyll", "~> 3.6"
|
||||||
spec.add_runtime_dependency "jekyll-paginate", "~> 1.1"
|
spec.add_runtime_dependency "jekyll-paginate", "~> 1.1"
|
||||||
|
|
||||||
spec.add_development_dependency "bundler", "~> 1.12"
|
spec.add_development_dependency "bundler", "~> 1.14"
|
||||||
end
|
end
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user