Jekyll Auth
A simple way to use GitHub OAuth to serve a protected Jekyll site to your GitHub organization
The problem
Jekyll and GitHub Pages are awesome, right? Static site, lightning fast, everything versioned in Git. What else could you ask for?
But what if you only want to share that site with a select number of people? Before, you were SOL. Now, simply host the site on a free, Heroku Dyno, and whenever someone tries to access it, it will Oauth them against GitHub, and make sure they're a member of your Organization. Pretty cool, huh?
Requirements
- A GitHub account (one per user)
- A GitHub Organization (of which members will have access to the Jekyll site)
- A GitHub Application (you can register one for free)
- A Heroku account (you can technically use this elsewhere, but the instructions are for Heroku)
Under the hood
Every time you push to Heroku, we take advantage of the fact that Heroku automatically runs the rake assets:precompile command (normally used for Rails sites) to build our Jekyll site and store it statically, just like GitHub pages would.
Anytime a request comes in for a page, we run it through Sinatra (using the _site folder as the static file folder, just as public would be normally), and authenticate it using sinatra_auth_github.
If they're in the org, they get the page. Otherwise, all they ever get is the bouncer.
Further reading
-
Jekyll 是一个简单的免费的Blog生成工具，类似WordPress。但是和WordPress又有很大的不同，原因是jekyll只是一个生成静态网页的工具，不需要数据库支持。但是可以配合第三方服务,例如discuz。最关键的是jekyll可以免费部署在Github上，而且可以绑定自己的域名。 快速安装指令： gem install jekylljekyll new my-awesome-sit
-
中文网站 jekyllcn 快速开始 ~ $ gem install jekyll bundler ~ $ jekyll new my-awesome-site ~ $ cd my-awesome-site ~/my-awesome-site $ bundle install ~/my-awesome-site $ bundle exec jekyll serve # => 打开浏览器 http
-
jekyll-admin 是一个 jekyll 插件，为用户提供了传统 CMS（内容管理系统）风格的图形化界面来创作内容和管理 jekyll 网站。 该项目分为两部分。基于 Ruby 的 HTTP API 处理 jekyll 和文件系统的操作部分，以及在这个 API 基础上的基于 JavaScript 的前端部分。 安装： 就像安装其他插件一样，请参阅 jekyll 文档的插件安装部分安装 jek
-
Jekyll的增强版，使用Markdown来写日志。 Jekyll采用静态文件方式管理，不需要数据库即可支持一个独立博客站点，在github-pages平台上被普遍采用。Jekyll-Bootstrap在Jekyll基础上，集成了twitter-bootstrap界面风格和一些实用的插件，并且易于扩展。
-
Jekyll Docker Jekyll Docker is a software image that has Jekyll and many of its dependencies ready to use for you in an encapsulated format. It includes a default set of gems, different image types wi
-
jekyll-katex This is a Jekyll plugin for performing compile-time math rendering via the KaTeX library.KaTeX is a library for rending math on the web using LaTeX, similar to MathJax. KaTeX differs from