{"id":14979221,"url":"https://github.com/patdryburgh/hitchens","last_synced_at":"2025-05-15T14:04:13.527Z","repository":{"id":37752211,"uuid":"142944909","full_name":"patdryburgh/hitchens","owner":"patdryburgh","description":"An inarguably well-designed Jekyll theme.","archived":false,"fork":false,"pushed_at":"2024-07-19T17:40:07.000Z","size":1070,"stargazers_count":375,"open_issues_count":2,"forks_count":473,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-11T22:38:04.911Z","etag":null,"topics":["jekyll","jekyll-template","jekyll-theme"],"latest_commit_sha":null,"homepage":"https://patdryburgh.github.io/hitchens/","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/patdryburgh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2018-07-31T01:12:09.000Z","updated_at":"2025-04-08T15:31:12.000Z","dependencies_parsed_at":"2023-01-30T23:30:32.282Z","dependency_job_id":"8ccda5e0-4e6e-4723-a95e-afce7789e5e4","html_url":"https://github.com/patdryburgh/hitchens","commit_stats":{"total_commits":99,"total_committers":1,"mean_commits":99.0,"dds":0.0,"last_synced_commit":"e0579ca495c23d44f1d140cc10a303d661ca8316"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdryburgh%2Fhitchens","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdryburgh%2Fhitchens/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdryburgh%2Fhitchens/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdryburgh%2Fhitchens/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patdryburgh","download_url":"https://codeload.github.com/patdryburgh/hitchens/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254355334,"owners_count":22057354,"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":["jekyll","jekyll-template","jekyll-theme"],"created_at":"2024-09-24T13:59:37.221Z","updated_at":"2025-05-15T14:04:13.488Z","avatar_url":"https://github.com/patdryburgh.png","language":"SCSS","funding_links":[],"categories":["SCSS"],"sub_categories":[],"readme":"---\nlayout: page\ntitle: \"Hitchens\"\n---\n\nAn inarguably well-designed [Jekyll](http://jekyllrb.com) theme by [Pat Dryburgh](https://patdryburgh.com).\n\n![Hitchens Preview](https://raw.githubusercontent.com/patdryburgh/hitchens/master/screenshot.png)\n\nUndoubtably one of the great minds of our time, [Christopher Hitchens](https://en.wikipedia.org/wiki/Christopher_Hitchens) challenged his readers to think deeply on topics of politics, religion, war, and science. This Jekyll theme's design is inspired by the trade paperback version his book, [Arguably](https://en.wikipedia.org/wiki/Arguably), and is dedicated to his memory.\n\n## Quick Start\n\nThis theme is, itself, a Jekyll blog, meaning the code base you see has everything you need to run a Jekyll powered blog!\n\nTo get started quickly, follow the instructions below:\n\n1. Click the `Fork` button at the top of [the repository](https://github.com/patdryburgh/hitchens/);\n2. Go to your forked repo's `Settings` screen;\n3. Scroll down to the `GitHub Pages` section;\n4. Under `Source`, select the `Master` branch;\n5. Hit `Save`.\n6. Follow [Jekyll's instructions to configure your new Jekyll site](https://jekyllrb.com/docs/configuration/).\n\n## Manual Installation\n\nIf you've already created your Jekyll site or are comfortable with the command line, you can follow [Jekyll's Quickstart instructions](https://jekyllrb.com/docs/) add this line to your Jekyll site's `Gemfile`:\n\n```ruby\ngem \"hitchens-theme\"\n```\n\nAnd add the following lines to your Jekyll site's `_config.yml`:\n\n```yaml\ntheme: hitchens-theme\n```\n\nDepending on your [site's configuration](https://jekyllrb.com/docs/configuration/options/), you may also need to add:\n\n```yaml\nignore_theme_config: true\n```\n\nAnd then on the command line, execute:\n\n    $ bundle\n\nOr install the theme yourself as:\n\n    $ gem install hitchens-theme\n\n## Usage\n\n### Home Layout\n\nThe `home` layout presents a list of articles ordered chronologically. The theme uses [Jekyll's built-in pagination](https://jekyllrb.com/docs/pagination/#enable-pagination) which can be configured in your `_config.yml` file.\n\nThe masthead of the home page is derived from the `title` and `description` set in your site's `_config.yml` file.\n\n#### Navigation\n\nTo include a navigation menu in your site's masthead and footer:\n\n1. Create a `_data` directory in the root of your site.\n2. Add a `menu.yml` file to the `_data` directory.\n3. Use the following format to list your menu items:\n\n```\n- title: About\n  url: /about.html\n\n- title: Source\n  url: https://github.com/patdryburgh/hitchens\n```\n\nBe sure to start your `url`s with a `/`.\n\n#### Pagination\n\nTo paginate your posts, add the following line to your site's `Gemfile`:\n\n```\ngem \"jekyll-paginate\"\n```\n\nThen, add the following lines to your site's `_config.yml` file:\n\n```\nplugins:\n  - jekyll-paginate\n\npaginate: 20\npaginate_path: \"/page/:num/\"\n```\n\nYou can set the `paginate` and `paginate_path` settings to whatever best suits you.\n\n#### Excerpts\n\nTo show [excerpts](https://jekyllrb.com/docs/posts/#post-excerpts) of your blog posts on the home page, add the following settings to your site's `_config.yml` file:\n\n```\nshow_excerpts: true\n```\n\nBy default, excerpts that have more than 140 characters will be truncated to 20 words. In order to override the number of words you'd like to show for your excerpts, add the following setting to your site's `_config.yml` file:\n\n```\nexcerpt_length: 20\n```\n\nTo disable excerpt truncation entirely, simply set `excerpt_length` to `0` in your site's `_config.yml` file, like so:\n\n```\nexcerpt_length: 0\n```\n\nIf you do this, the theme will still respect Jekyll's `excerpt_separator` feature as [described in the Jekyll documentation](https://jekyllrb.com/docs/posts/#post-excerpts).\n\n\n#### Title-less Posts\n\nIf you want to publish posts that don't have a title, add the following setting to the [front matter](https://jekyllrb.com/docs/frontmatter/) of the post:\n\n```\ntitle: \"\"\n```\n\nWhen you do this, the home page will display a truncated [excerpt](https://jekyllrb.com/docs/posts/#post-excerpts) of the first paragraph of your post.\n\nNote that setting `excerpt_length` in your site's `_config.yml` file will set the length of _all_ excerpts, regardless of whether the post has a title or not. For posts with a title, the excerpt will appear under the title and slightly lighter. For title-less posts, the excerpt will appear as if it were a title.\n\n### Post Layout\n\nA sparsely decorated layout designed to present long-form writing in a manner that's pleasing to read.\n\nTo use the post layout, add the following to your post's [front matter](https://jekyllrb.com/docs/frontmatter/):\n\n```\nlayout: post\n```\n\n### Icons\n\nThe [JSON Feed spec](https://jsonfeed.org/version/1) states that feeds should include an icon. To add your icon, add the following line in your site's `_config.yml` file:\n\n```\nfeed_icon: /assets/images/icon-512.png\n```\n\nThen, replace the `/assets/images/icon-512.png` file with your own image.\n\n### Credits\n\nThe theme credits that appear at the bottom of each page can be turned off by including the following line in your site's `_config.yml` file:\n\n```\nhide_credits: true\n```\n\n### Search\n\nThe theme uses a [custom DuckDuckGo Search Form](https://ddg.patdryburgh.com) that can be turned off by including the following line in your site's `_config.yml` file: \n\n```\nhide_search: true\n```\n\n### Font\n\nI spent a good amount of time trying to identify the font used on the front cover of the trade paperback version of Arguably. Unfortunately, I failed to accurately identify the exact font used. If you happen to know what font is used on the book cover, I would appreciate you [letting me know](mailto:hello@patdryburgh.com) :)\n\nThe theme includes a version of [EB Garamond](https://fonts.google.com/specimen/EB+Garamond), designed by Georg Duffner and Octavio Pardo. It's the closest alternative I could come up with that included an open license to include with the theme.\n\nA [copy of the license](https://github.com/patdryburgh/hitchens/blob/master/assets/fonts/OFL.txt) has been included in the `assets` folder and must be included with any distributions of this theme that include the EB Garamond font files.\n\n## Contributing \u0026 Requesting Features\n\nBug reports, feature requests, and pull requests are welcome on GitHub at [https://github.com/patdryburgh/hitchens](https://github.com/patdryburgh/hitchens).\n\nThis 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\n## Development\n\nTo set up your environment to develop this theme, run `bundle install`.\n\nThe theme is setup just like a normal Jekyll site. To test the theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using the theme. Add pages, documents, data, etc. like normal to test the theme's contents. As you make modifications to the theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.\n\n## License\n\nThe code for this theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\nThe font, EB Garamond, is Copyright 2017 The EB Garamond Project Authors and licensed under the [SIL Open Font License Version 1.1](https://github.com/patdryburgh/hitchens/blob/master/assets/fonts/OFL.txt).\n\nGraphics are released to the public domain.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatdryburgh%2Fhitchens","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatdryburgh%2Fhitchens","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatdryburgh%2Fhitchens/lists"}