# [Jekyll::Hive](https://github.com/inertia186/jekyll-hive)
Liquid tag for displaying Hive content in Jekyll sites: `{% hive %}`.
## Installation
Add this line to your application's Gemfile:
```bash
gem 'jekyll-hive'
```
And then execute:
```bash
bundle
```
Or install it yourself as:
```bash
gem install jekyll-hive
```
Then add the following to your site's `_config.yml`:
```yml
plugins:
- jekyll-hive
```
💡 If you are using a Jekyll version less than 3.5.0, use the `gems` key instead of `plugins`.
## Usage
Use the tag as follows in your Jekyll pages, posts and collections:
```liquid
{% hive author/permlink %}
```
This will place the associated content on the page.
## Note About Turbolinks
If you're using Turbolinks on your Jekyll site, you should consider adding the following line to your main includes, e.g. `_includes/head.html`:
```html
```
## Jekyll Build
When building your site with jekyll, you can continue to use the default command:
```bash
jekyll build
```
If you would like to provide an alternate node:
```bash
NODE_URL=https://anyx.io jekyll build
```
## Jekyll Clean
To completely rebuild your site without cache:
```bash
rm -rf .jekyll-hive-cache && jekyll clean && jekyll build
```
## Troubleshooting
#### I saw several messages like:
```
Retrying: stoodkev/how-to-use-hivejs-or-other-modules-referencing-core-node-js-modules-on-react-native (Failed to open TCP connection to api.hive.blog:443 (getaddrinfo: nodename nor servname provided, or not known))
Retrying: stoodkev/how-to-use-hivejs-or-other-modules-referencing-core-node-js-modules-on-react-native (Failed to open TCP connection to api.openhive.network:443 (getaddrinfo: nodename nor servname provided, or not known))
.
.
.
Gave up on: stoodkev/how-to-use-hivejs-or-other-modules-referencing-core-node-js-modules-on-react-native
```
Check your internet connection or provide an alternate node:
```
NODE_URL=https://anyx.io jekyll build
```
#### The post has changed on the blockchain, but `jekyll-hive` won't update to the latest post revision.
The cached copy is out of date. Try deleting the related post from the cache or remove the entire cache:
```
rm -rf .jekyll-hive-cache
```
## Contributing
1. Fork it ( https://github.com/inertia186/jekyll-hive/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request
---
## Get in touch!
If you're using Jekyll::Hive, I'd love to hear from you. Drop me a line and tell me what you think! I'm [@inertia](https://hive.blog/@inertia) on Hive.
## License
I don't believe in intellectual "property". If you do, consider Jekyll::Hive as licensed under a Creative Commons [](http://creativecommons.org/publicdomain/zero/1.0/) License.
