Minify JavaScript during GitHub Pages build?

10
votes

I have a static website through GitHub Pages, built on Jekyll-Bootstrap. My little website includes a lot of JavaScript, and for maintainability I would like all of the JavaScript to remain human-readable in the GitHub repo.

But for the end-user of my website, I would prefer to minify the JavaScript.

Is there some way to build a hook into the GitHub Pages build process to minify/uglify JavaScript, so that the end user can download smaller files?

4
javascriptperformancebuildgithub-pagesjekyll-bootstrap
Did you explore some way to do this ? Do you have a github repo url ? – David Jacquel
@DavidJacquel My GitHub Pages repo: github.com/theJollySin/thejollysin.github.io Did I explore some way to do this? Yes, but I have not found any way to put a build hook into the GitHub Pages build process, because it is an invisible process to me. But I refuse to believe there is no way to add a build hook, even for a static website. – john_science

4 Answers

10
votes

The GitHub pages build service cannot have any other code running on it other than Jekyll in safe mode and the small number of included plugins. This is done for security.

Your best option is to use an alternative service to build your site and push the result back to GitHub. The source for the site would reside in the master branch and the compiled source in gh-pages.

A suitable service for doing so would be one of many CI services, such as Travis CI. These are typically used to run software test suites on every push to a repo, but can be used to build your website and push the result back to you.

The Jekyll docs have a guide for testing builds on Travis. Pushing the output isn't mentioned. You'll need a script in the after_success derivative in the Travis conf file. An example from a site I maintain.

To authenticate your push the script will need access to your github personal access token. You can't just put this straight in the deploy script as it's a secret. See the Travis docs on encrypting environment variables.

4
votes

If you are using Github to generate the site and display it, there is no option to do this because Github is strict about what it will process - for security.

A workaround is to do your compiling and processing locally, then push the resulting output to to gh-pages - which is happy to simply host static pages.

You can still use github to host the project. You just do not use Github to compile it.

Your dev process might be:

  1. Check you're master and local match.
  2. Do your work in dev mode.
  3. Build in production.
  4. Use grunt or other program to minify/uglify/etc the _site production files - outputting to a separate dist (distribution) folder.
  5. Push the contents of the dist folder to your gh-pages.
  6. Commit changes to the project files back to the master.

I am probably not making much sense, but perhaps this discussion might help more: https://gist.github.com/cobyism/4730490

Have fun!

1
votes

You can try to use my own minifier https://github.com/Mendeo/jekyll-minifier. It is written purely on liquid, so you do not need any additional gems install and it is fully compatible with GitHub Pages.

-1
votes

Netlify is an alternative to GitHub Pages that integrates with GitHub (even private repos) and similarly publishes the output of Jekyll (or other static site generators). There are some limits on the free tier, but most individual users are unlikely to run into them.

You should be able to add one of the Jekyll minifier plugins listed here to accomplish your goals. Here are plugin installation instructions.

Please add a comment if this worked for you! I'd love to hear how it went.