{"id":15288524,"url":"https://github.com/zivong/jekyll-theme-hamilton","last_synced_at":"2025-04-05T07:06:03.566Z","repository":{"id":37389606,"uuid":"252984500","full_name":"zivong/jekyll-theme-hamilton","owner":"zivong","description":"A minimal and beautiful Jekyll theme best for writing and note-taking.","archived":false,"fork":false,"pushed_at":"2023-10-18T16:50:37.000Z","size":2503,"stargazers_count":214,"open_issues_count":9,"forks_count":303,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T06:05:44.111Z","etag":null,"topics":["blog","jekyll","jekyll-theme"],"latest_commit_sha":null,"homepage":"https://zivong.blog/jekyll-theme-hamilton/","language":"SCSS","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/zivong.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-04T11:56:55.000Z","updated_at":"2025-03-24T15:39:21.000Z","dependencies_parsed_at":"2024-06-18T18:36:54.862Z","dependency_job_id":"38b7131b-0faf-44fb-bc0e-8f7c5f23274a","html_url":"https://github.com/zivong/jekyll-theme-hamilton","commit_stats":{"total_commits":126,"total_committers":5,"mean_commits":25.2,"dds":0.09523809523809523,"last_synced_commit":"acceac331390f70267ca497a874c4a86159ef305"},"previous_names":["ngzhio/jekyll-theme-hamilton"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zivong%2Fjekyll-theme-hamilton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zivong%2Fjekyll-theme-hamilton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zivong%2Fjekyll-theme-hamilton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zivong%2Fjekyll-theme-hamilton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zivong","download_url":"https://codeload.github.com/zivong/jekyll-theme-hamilton/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247299832,"owners_count":20916190,"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":["blog","jekyll","jekyll-theme"],"created_at":"2024-09-30T15:49:53.253Z","updated_at":"2025-04-05T07:06:03.534Z","avatar_url":"https://github.com/zivong.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hamilton \u003c!-- omit in toc --\u003e\n\nA minimal and beautiful Jekyll theme best for writing and note-taking.\n\nThe original purpose of this theme is to be a replacement of the default Jekyll theme -- [Minima](https://github.com/jekyll/minima). Hamilton is an enhancement of Minima but still, keep in minimal.\n\nPlease check out the [demo](https://ngzhio.github.io/jekyll-theme-hamilton/).\n\n| Skins | Displays |\n| ----- | -------- |\n| Daylight | ![screenshot](screenshot.png) |\n| Sunrise/Sunset | ![screenshot](screenshot-sunrise.png) |\n| Midnight | ![screenshot](screenshot-midnight.png) |\n\n## Features \u003c!-- omit in toc --\u003e\n\n- [Jekyll SEO Tag](https://github.com/jekyll/jekyll-seo-tag)\n- [Jekyll Feed](https://github.com/jekyll/jekyll-feed)\n- [Jekyll Sitemap](https://github.com/jekyll/jekyll-sitemap)\n- [Google Analytics](https://analytics.google.com/)\n- [MathJax](https://www.mathjax.org/)\n- [Disqus](https://disqus.com/)\n- [Font Awesome](https://fontawesome.com/)\n- TOC\n- Customizable head\n- Configurable page navigation\n- Customizable styles and skins\n- Archive pages implemented in pure Liquid\n\n## Table of Contents \u003c!-- omit in toc --\u003e\n\n- [Installation](#installation)\n- [Configuration](#configuration)\n  - [Optional Parameters](#optional-parameters)\n- [Archive Pages](#archive-pages)\n- [MathJax](#mathjax)\n- [TOC](#toc)\n- [Customization](#customization)\n  - [Metadata](#metadata)\n  - [Navigation](#navigation)\n  - [Social Media](#social-media)\n  - [Skins](#skins)\n  - [More Customized Styles](#more-customized-styles)\n- [License](#license)\n\n## Installation\n\nYou can choose one of the following methods to install Hamilton:\n\n- Directly specify the `jekyll-theme-hamilton` gem.\n\n    1. Add `gem 'jekyll-theme-hamilton'` into your `Gemfile`.\n    2. Add the below lines into your `_config.yml`.\n\n        ```yml\n        plugins:\n          - jekyll-theme-hamilton\n        ```\n\n- If your site is hosted on GitHub Pages, you can use [`jekyll-remote-theme`](https://github.com/benbalter/jekyll-remote-theme) to import the master branch of Hamilton.\n\n    1. Add `gem 'jekyll-remote-theme'` into your `Gemfile`.\n    2. Add the below lines into your `_config.yml`.\n\n        ```yml\n        plugins:\n          - jekyll-remote-theme\n\n        remote_theme: ngzhio/jekyll-theme-hamilton\n        ```\n\n## Configuration\n\nAfter installation, you can run `jekyll serve` to check out your site, but before that, *make sure* the below **required parameters** are configured in your `_config.yml`.\n\n| Parameters | Types | Specifications |\n|:---------- |:----- |:-------------- |\n| `title`    | string | The site title |\n| `disqus`   | string | The Disqus shortname; Unless you don't want to enable the comments system, you must specify this parameter. It is used in the production environment. |\n| `google_analytics` | string | The Google Analytics tracking ID; It is used in the production environment. |\n\n### Optional Parameters\n\n| Parameters | Types | Specifications |\n|:---------- |:----- |:-------------- |\n| `author`   | string | The name of the author of the site; It would be showed in the copyright statement. |\n| `avatar`   | string | The avatar of the author of the site. |\n| `email`    | string | The email of the author of the site. |\n| `location` | string | The current living location of the author of the site. |\n| `skin`     | string | The skin name. See more information on the [Customization](#customization) section. |\n| `lang`     | string | The language of the site; The default value is `en`. |\n| `paginate` | int    | The number of posts on each page. |\n| `date_format` | string | The date format; The default value is `%b %-d, %Y`. |\n| `subscribe` | boolean | Show the subsribe feed button. |\n\n## Archive Pages\n\nHamilton implements some archive templates in pure Liquid. For example, if you want to create a category archive page, set the below parameters on that page:\n\n```yml\n---\nlayout: archive-taxonomies\ntype: categories\n---\n```\n\nOr a tag archive page:\n\n```yml\nlayout: archive-taxonomies\ntype: tags\n```\n\nOr archive by years:\n\n```yml\nlayout: archive-years\n```\n\n## MathJax\n\nYou can enable MathJax on each post or page, just set `math: true` on that page.\n\n## TOC\n\nIf you want to show the Table of Contents of a post or page on the left sidebar, just set `toc: true` on that page.\n\n## Customization\n\n### Metadata\n\nYou can create a file `_includes/custom-head.html` in your repository, and add any metadata into that page, e.g. favicons.\n\n### Navigation\n\nYou can create a file `_data/navigation.yml` to configure links to some pages. For example,\n\n```yml\n- title: About\n  url: /about/\n- title: Categories\n  url: /categories/\n- title: Tags\n  url: /tags/\n```\n\nThe navigation bar also supports dropdown submenus:\n\n```yml\n- title: About\n  url: /about/\n- title: Categories\n  url: /categories/\n- title: Tags\n  url: /tags/\n- title: More\n  sublinks:\n    - title: FAQ\n      url: /faq/\n    - title: Docs\n      url: /docs/\n```\n\n### Social Media\n\nYou can create a file `_data/social.yml` to configure links to your social media. For example,\n\n```yml\n- title: Twitter\n  url: https://twitter.com/ngzhio\n  icon: fab fa-twitter\n- title: GitHub\n  url: https://github.com/ngzhio/jekyll-theme-hamilton\n  icon: fab fa-github\n```\n\n### Skins\n\nYou can select a skin by setting `skin` in `_config.yml`. The built-in skins include `daylight`, `midnight`, `sunrise`, and `sunset`. If you don't specify any skin, Hamilton would dynamically select one in these built-in skins according to different hours in a day.\n\nYou can also customize a new skin, for example, a skin called `solarized`. You need to copy [`_sass/hamilton/skins/daylight.scss`](_sass/hamilton/skins/daylight.scss) into your repository and then rename it to `solarized.scss`, and adjust some colors in that file. Finally, specify `skin: solarized` in `_config.yml`.\n\n### More Customized Styles\n\nIf you want to create more CSS styles in your site, creating a file `_sass/hamilton/custom-styles.scss`, and putting your code in there, Hamilton would automatically refer to them.\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](LICENSE.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzivong%2Fjekyll-theme-hamilton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzivong%2Fjekyll-theme-hamilton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzivong%2Fjekyll-theme-hamilton/lists"}