my-mzharp
Boilerplate for Harp with Gulp support, responsive images and a simple blog structure.
- Setup boilerplate:
harp init my-harp --boilerplate marzeelabs/mz-harp - Navigate inside the new directory with
cd my-harp - Install all dependencies with
npm install - Install gulp and harp globally with
npm install -g gulp harpso you get the CLIs available
This will get you a copy of the repository locally and also download all node dependencies such as harp, Gulp, jimp, Browsersync, etc.
In order to serve your local copy of the website, while on the project directory, just do gulp and everything will be handled for you.
The default task for gulp will:
- Create responsive versions of the blog's images with jimp
- Minify and concatenate the multiple JS scripts with uglify
- Build the static files for the website in the www dir with harp
- Serve the website in localhost:3333 with harp and Browsersync
The default gulp tasks take care of processing the images in various sizes for the responsive image markup, as well as replacing the code in the compiled HTML. All that is required is for the author to add the image files in the _posts-images directory and include the base image (also copied to public/images/posts/) in the post - e.g. alt
For development guidelines, please check the harp documentation at http://harpjs.com/docs/development/
In order to review the static site, this boilerplate is integrated with Heroku's pipelines, which spins up a new site for each pull request and commit.
Travis is also setup to automatically build the website and deploy the static files to a branch on Github:
- Install the Travis CLI tool with
gem install travis. - Log in to Travis with
travis login. - Create a new RSA key with
ssh-keygen -t rsa -C "Deploy key for <repo>" -f deploy_key(don't use a passphrase!). - Put the contents of the generated file deploy_key.pub into https://github.com///settings/keys as new deploy key with write access. You can delete this file, you won't need it anymore.
- Use the Travis CLI to encrypt your file with
travis encrypt-file deploy_key --add. The add option should automatically update your .travis.yml file with a line starting with "openssl aes-256" in the "before_install" section. - Delete the previously generated deploy_key file - do not commit it to the repository! The only file you must commit is the encrypted file deploy_key.enc.
- Configure the DEPLOY_FROM and DEPLOY_TO branches in scripts/deploy.sh and the git username and email you want to show up in the deploy commits.
- When a PR is successfully merged to the DEPLOY_FROM branch you chose, Travis will build the website and commit the result to your chosen DEPLOY_TO branch. Don't forget that Travis must be set up to build PRs AND pushes.
Made by Marzee Labs