Hanuman is a minimal yet powerful Jekyll theme for your blogs and websites.
It is built using the open source AMP Start framework and can be customized as per your requirements.
AMP stands for Accelerated Mobile Pages, a Google-backed project designed as an open standard for any publisher to have pages load quickly on mobile devices.
There are different ways to install the theme -
Push the contents of the destination folder (mentioned in _config.yml. eg - destination: ../hanuman-pages/) to the gh-pages branch(if project page) or master branch(if user page) of your repository.
gem install travison your terminal.
travis encrypt 'GIT_NAME="YOUR_USERNAME" GIT_EMAIL="YOUR_EMAIL" GH_TOKEN=YOUR_TOKEN'
Add this line to your Jekyll site's
And add this line to your Jekyll site's
And then execute:
Or install it yourself as:
$ gem install hanuman
You'll also need to copy or create the _config.yml file just like in this repository. Similarly, you'll need to have a navigation.yml and author.yml in your _data directory.
bundle exec jekyll serve inside your cloned repository. Push the contents of the resulting _site to your Github Pages repository.
source "https://rubygems.org" gem "github-pages", group: :jekyll_plugins gem "jekyll-remote-theme"
Update the bundled gems using
remote_theme: "hanuman" to your
jekyll-remote-theme to the plugins array of your
plugins: - jekyll-remote-theme
Update _config.yml with your respective settings like updating your site's name, description etc...
AMP has a limitation that you can only use inline css. All the CSS for this theme is in the styles.scss file in the includes directory.
In the styles.scss file in the includes directory, you can change the hex value of $theme-color to the color you would like your site to use.
Author information is present in the author.yml file in the _data folder. You can update the fields of that file as per your requirements.
Sidenav can be updated from the navigation.yml file in the _data folder.
You can write posts just as you would in Jekyll, the only difference being that AMP has some strict guidelines on including external content.
You cannot use Markdown format or normal HTML tags. AMP provides its own custom tags for images, videos etc...
<amp-img src="welcome.jpg" alt="Welcome" height="400" width="800"></amp-img>
<amp-youtube data-videoid="mGENRKrdoGY" layout="responsive" width="480" height="270"></amp-youtube>
Some AMP components require you to specify external scripts before using them. You can specify these scripts in the head.html file in the includes directory after the already imported scripts and then use these components in any post.
AMP provides built-in validator to validate your pages so that they can rendered quickly.
You can access this validator by opening the Developer Console in your browser and adding #development=1 to any url of your site.
Example - http://localhost:4000/#development=1
If you have errors on your page, AMP will list those for you in the console. If you do not have any errors, you'll get a message "AMP Validation Successful" on your console.
Bug reports and pull requests are welcome on GitHub at https://awesomeopensource.com/project/samanyougarg/hanuman. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
To submit a pull request -
Hanuman is based on amplify jekyll theme. Thank You.
The theme is available as open source under the terms of the MIT License.