Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chaelcodes/jekyll-twitch
Embed Twitch clips, VODs, and broadcasts in your Jekyll sites.
https://github.com/chaelcodes/jekyll-twitch
embed-twitch-clips hacktoberfest jekyll jekyll-plugin ruby
Last synced: about 2 months ago
JSON representation
Embed Twitch clips, VODs, and broadcasts in your Jekyll sites.
- Host: GitHub
- URL: https://github.com/chaelcodes/jekyll-twitch
- Owner: ChaelCodes
- License: mit
- Created: 2021-03-19T15:39:09.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-10-30T20:27:13.000Z (almost 2 years ago)
- Last Synced: 2024-03-16T10:07:53.582Z (6 months ago)
- Topics: embed-twitch-clips, hacktoberfest, jekyll, jekyll-plugin, ruby
- Language: Ruby
- Homepage: https://www.chael.codes/jekyll-twitch/
- Size: 105 KB
- Stars: 8
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-jekyll-plugins - **Jekyll Twitch** - twitch](https://rubygems.org/gems/jekyll-twitch)) - Embed Twitch clips, vods, collections, and even broadcasts! (Tags)
README
# Jekyll::Twitch
This gem allows you to embed twitch channels, clips, collections, and videos in your Jekyll websites. It adds and registers a new twitch liquid tag that accepts a twitch clip, channel, broadcast, or highlight url. It's based on the [Twitch video embeds](https://dev.twitch.tv/docs/embed/video-and-clips).
`{% twitch https://www.twitch.tv/chaelcodes/clip/SpoopySlipperyGrasshopperPogChamp %}`
## [See the DEMO site](https://www.chael.codes/jekyll-twitch/)
Check out the [demo site](https://www.chael.codes/jekyll-twitch/) for install instructions and to review different embed examples.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'jekyll-twitch'
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install jekyll-twitch
Then add Jekyll-Twitch to your `_config.yml` like so:
```
plugins:
- jekyll-twitch
```
## Usage
This is a Jekyll liquid tag, so just put `{% twitch https://www.twitch.tv/chaelcodes/clip/SpoopySlipperyGrasshopperPogChamp %}` to embed your clip, channel, or broadcast.
When building your site, Jekyll no longer substitutes `site.url` for localhost, which means Twitch embeds will not render. You need to supply host and localhost to view clips in development. `jekyll serve --host localhost --port 4000`
All of the below examples are on the demo site with actual embeds. I strongly recommend using that.
### Channel
This channel embed will show the broadcast while the streamer is live, and the channel offline art when they are not.
```
{% twitch https://twitch.tv/ChaelCodes %}
```
### Collection
This embed is used to add a collection of videos to your page or post.
```
{% twitch https://www.twitch.tv/collections/x5bG2TGTeBYIRg %}
```
### Clips
This embed is used to add one Twitch clip to your page or post.
```
{% twitch https://www.twitch.tv/chaelcodes/clip/DeterminedSweetRedpandaDoritosChip-pQiRlDz6rQ9uvuuq %}
```
### Videos
Whether you call them videos, vods, or higlights, this will embed them in your page or psot.
```
{% twitch https://www.twitch.tv/videos/716698136 %}
```
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/ChaelCodes/jekyll-twitch. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/ChaelCodes/jekyll-twitch/blob/main/CODE_OF_CONDUCT.md).
For more details on setting up the local environment, demo site, and releasing a new version, see our [CONTRIBUTING.md](/CONTRIBUTING.md).
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
## Code of Conduct
Everyone interacting in the Jekyll::Twitch project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/ChaelCodes/jekyll-twitch/blob/main/CODE_OF_CONDUCT.md).