{"id":13609380,"url":"https://github.com/samanyougarg/hanuman","last_synced_at":"2025-04-13T05:08:33.113Z","repository":{"id":41553081,"uuid":"113005203","full_name":"samanyougarg/hanuman","owner":"samanyougarg","description":"A responsive, lightning-fast Jekyll theme built using AMP (Accelerated Mobile Pages) to speed up your blogs and websites.","archived":false,"fork":false,"pushed_at":"2020-08-31T18:14:07.000Z","size":15668,"stargazers_count":109,"open_issues_count":3,"forks_count":312,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-13T05:08:29.112Z","etag":null,"topics":["gem","github-page","github-pages","hanuman","jekyll","jekyll-plugin","jekyll-site","jekyll-themes","theme"],"latest_commit_sha":null,"homepage":"https://samanyougarg.github.io/hanuman/","language":"CSS","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/samanyougarg.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":"2017-12-04T06:41:05.000Z","updated_at":"2025-03-06T13:00:03.000Z","dependencies_parsed_at":"2022-08-26T05:10:54.762Z","dependency_job_id":null,"html_url":"https://github.com/samanyougarg/hanuman","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samanyougarg%2Fhanuman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samanyougarg%2Fhanuman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samanyougarg%2Fhanuman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samanyougarg%2Fhanuman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samanyougarg","download_url":"https://codeload.github.com/samanyougarg/hanuman/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665747,"owners_count":21142123,"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":["gem","github-page","github-pages","hanuman","jekyll","jekyll-plugin","jekyll-site","jekyll-themes","theme"],"created_at":"2024-08-01T19:01:34.476Z","updated_at":"2025-04-13T05:08:33.085Z","avatar_url":"https://github.com/samanyougarg.png","language":"CSS","funding_links":["https://www.buymeacoffee.com/samanyougarg"],"categories":["CSS"],"sub_categories":[],"readme":"# HANUMAN Jekyll Theme\n\n[![Build Status](https://travis-ci.org/samanyougarg/hanuman.svg?branch=master)](https://travis-ci.org/samanyougarg/hanuman)\n\nHanuman is a minimal yet powerful Jekyll theme for your blogs and websites.\n\nIt is built using the open source [AMP Start framework](https://www.ampstart.com/) and can be customized as per your requirements.\n\n\u003ca href=\"https://www.buymeacoffee.com/samanyougarg\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" target=\"_blank\"\u003e\u003c/a\u003e\n\n## Live Demo\n## [Hanuman](https://samanyougarg.com/hanuman)\n![Hanuman](/Screenshots/hanuman.jpg \"Hanuman Preview\")\n\n\n## Features\n\n- Minimal\n- Responsive\n- Syntax Highlighting for code\n- Cover Images for homepage and blog posts\n- Social Sharing\n- Simple Navigation Menu\n- Pagination\n- Google Analytics\n- Can be easily installed via \"theme gem\"\n- Github Pages support\n- Easily Customisable\n- Tags\n- Multiple Authors\n\n## What is AMP\n\nAMP stands for [Accelerated Mobile Pages](https://www.ampproject.org/), a Google-backed project designed as an open standard for any publisher to have pages load quickly on mobile devices.\n\n## Installation\n\nThere are different ways to install the theme -\n\n### 1. Cloning the repository and updating settings\n1. Fork this repository and clone the forked repository.\n2. Update the _config.yml file as per your requirements.\n3. Add your posts to the _posts directory.\n4. Deploy to Github Pages or your own server.\n\n#### Deploying to Github Pages\n**Method 1**\n\nPush 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.\n\n**Method 2**\n\n- Set up travis-ci for your fork.\n- Generate your secure token with the travis gem:\n  Run `gem install travis` on your terminal.\n- Grab the GH_TOKEN from https://github.com/settings/tokens\n- Then run `travis encrypt 'GIT_NAME=\"YOUR_USERNAME\" GIT_EMAIL=\"YOUR_EMAIL\" GH_TOKEN=YOUR_TOKEN'`\n- Add the token to your .travis.yml file.\nNow you just need to push the files. Travis will generate the HTML files and automatically push them to your gh-pages branch.\nThis is the setup I am using.\n\n### 2. Ruby Gem Method\nAdd this line to your Jekyll site's `Gemfile`:\n\n```ruby\ngem \"hanuman\"\n```\n\nAnd add this line to your Jekyll site's `_config.yml`:\n\n```yaml\ntheme: hanuman\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install hanuman\n\nYou'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.\n\n#### Deploying to Github Pages\nRun `bundle exec jekyll serve` inside your cloned repository. Push the contents of the resulting _site to your Github Pages repository.\n\n\n### 3. Jekyll Remote Theme\n1. Create or update your Gemfile with the following -\n\n```ruby\nsource \"https://rubygems.org\"\ngem \"github-pages\", group: :jekyll_plugins\ngem \"jekyll-remote-theme\"\n```\n\n2. Update the bundled gems using `bundle` command.\n\n3. Add `remote_theme: \"hanuman\"` to your `_config.yml`.\n\n4. Add `jekyll-remote-theme` to the plugins array of your `_config.yml` -\n\n```yaml\nplugins:\n  - jekyll-remote-theme\n```\n\n## Usage\n\n### _config.yml\nUpdate _config.yml with your respective settings like updating your site's name, description etc...\n\n### Styling\nAMP has a limitation that you can only use inline css.\nAll the CSS for this theme is in the styles.scss file in the includes directory.\n\n#### Changing the Default Color\nIn 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.\n\n### Author Information\nAuthor information is present in the author.yml file in the _data folder. You can update the fields of that file as per your requirements.\n\n### Sidenav\nSidenav can be updated from the navigation.yml file in the _data folder.\n\n## Writing Posts\nYou can write posts just as you would in Jekyll, the only difference being that AMP has some strict guidelines on including external content.\n\nYou cannot use Markdown format or normal HTML tags. AMP provides its own custom tags for images, videos etc...\n\n### Examples -\n\n**Images**\n`\u003camp-img src=\"welcome.jpg\" alt=\"Welcome\" height=\"400\" width=\"800\"\u003e\u003c/amp-img\u003e`\n\n**Videos**\n`\u003camp-youtube data-videoid=\"mGENRKrdoGY\" layout=\"responsive\" width=\"480\" height=\"270\"\u003e\u003c/amp-youtube\u003e`\n\n[See Full AMP Documentation.](https://www.ampproject.org/docs/)\n\n### Using AMP Components\nSome AMP components require you to specify external scripts before using them.\nYou 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.\n\n## Validating your page with AMP\nAMP provides built-in validator to validate your pages so that they can rendered quickly.\n\nYou can access this validator by opening the Developer Console in your browser and adding #development=1 to any url of your site.\n\nExample -\nhttp://localhost:4000/#development=1\n\nIf 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.\n\n## Enabling Google Analytics\n1. Set up your Analytics Tracking ID in _config.yml.\n2. Remove {% comment %} and {% endcomment %} tags in the default.html file in layouts directory.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/samanyougarg/hanuman. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\nTo submit a pull request -\n\n1. Fork/clone the repository.\n2. Develop.\n3. Create a new branch from the master branch.\n4. Open a pull request on Github describing what was fixed or added.\n\n## Thanks\nHanuman is based on [amplify](https://github.com/ageitgey/amplify) jekyll theme. Thank You.\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamanyougarg%2Fhanuman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamanyougarg%2Fhanuman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamanyougarg%2Fhanuman/lists"}