{"id":13612567,"url":"https://github.com/awood/hawkins","last_synced_at":"2025-04-13T12:32:14.437Z","repository":{"id":18939286,"uuid":"22158990","full_name":"awood/hawkins","owner":"awood","description":"A Jekyll plugin that incorporates LiveReload","archived":true,"fork":false,"pushed_at":"2022-01-04T20:55:47.000Z","size":297,"stargazers_count":57,"open_issues_count":3,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-24T18:40:56.269Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/awood.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-07-23T16:00:04.000Z","updated_at":"2023-08-31T21:12:00.000Z","dependencies_parsed_at":"2022-08-02T15:00:17.133Z","dependency_job_id":null,"html_url":"https://github.com/awood/hawkins","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awood%2Fhawkins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awood%2Fhawkins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awood%2Fhawkins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awood%2Fhawkins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awood","download_url":"https://codeload.github.com/awood/hawkins/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248714637,"owners_count":21149931,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T20:00:31.693Z","updated_at":"2025-04-13T12:32:14.010Z","avatar_url":"https://github.com/awood.png","language":"JavaScript","funding_links":[],"categories":["Watch \u0026 Live Reload"],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/awood/hawkins.png?branch=master)](https://travis-ci.org/awood/hawkins)\n\n# Archived\nHawkins is no longer necessary.  Jekyll has had LiveReload functionality since v3.7.0.\n\n# Hawkins\nHawkins is a [Jekyll](http://jekyllrb.com) 3.1+ plugin that incorporates\n[LiveReload](http://www.livereload.com) into the Jekyll \"serve\" process.\n\n## How to Use\nAdd the following into your `Gemfile`\n\n```\ngroup :jekyll_plugins do\n  gem 'hawkins'\nend\n```\n\nThen run `jekyll liveserve` to serve your files.  The `liveserve` commands takes\nall the arguments that `serve` does but with a few extras that allow you to\nspecify the port that LiveReload runs on or how long LiveReload will wait.  See\nthe --help for more information.\n\n## How It Works\nHawkins uses a WEBrick servlet that automatically inserts a script tag into a\npage's `head` section.  The script tag points to a LiveReload server running on\nthe same host (by default on port 35729).  That server serves `livereload.js`\nover HTTP and also acts as a WebSockets server that speaks the LiveReload\nprotocol.\n\nIf you don't have a browser that implements WebSockets, you can use the\n`--swf` option that will have Hawkins load a Flash file that implements\nWebSockets.\n\n## Using `--ignore`\n\nLiveReload errs on the side of reloading when it comes to the message it gets.\nIf, for example, a page is ignored but a CSS file linked in the page isn't, the\npage will still be reloaded if the CSS file is contained in the message sent to\nLiveReload.  Additionally, the path matching is very loose so that a message to\nreload \"/\" will always lead the page to reload since every page starts with \"/\".\n\n## A Note on SSL/TLS\nIf you tell Jekyll to serve your files over SSL/TLS (by specifying the\n`--ssl-cert` and `--ssl-key` options), then LiveReload will attempt to use\nSSL/TLS as well.  If you are using a certificate that a browser would not\nnormally accept (e.g.  self-signed or issued by an unknown certificate\nauthority), you will need to create an exception for the server and port\nthat Jekyll is serving content over and also for the server and port that\nLiveReload is running on.  Generally speaking, these exceptions will be\n\"127.0.0.1:4000\" and \"127.0.0.1:35729\".\n\n## A Note on Compatibility\n\nHawkins does not currently work on JRuby.  I'm working on figuring out why, but\nbe forewarned.\n\n## Troubleshooting\nYou can add \"?LR-verbose=true\" onto the URL and LiveReload will log some\nmessages to Firefox's Web Developer Console (or the Chrome equivalent).\n\n## Thanks\nLots of thanks to [guard-livereload](https://github.com/guard/guard-livereload)\nand [rack-livereload](https://github.com/johnbintz/rack-livereload) which\nprovided a lot of the code and ideas that Hawkins uses.  And of course thanks to\nthe Jekyll team and LiveReload team for providing outstanding software.\n\n## Copyright\nCopyright (c) 2014 Alex Wood. See LICENSE.txt for further details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawood%2Fhawkins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawood%2Fhawkins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawood%2Fhawkins/lists"}