{"id":14979180,"url":"https://github.com/fongandrew/hydeout","last_synced_at":"2025-05-13T21:07:06.077Z","repository":{"id":21480363,"uuid":"93000052","full_name":"fongandrew/hydeout","owner":"fongandrew","description":"A refreshed version of Hyde for Jekyll 3.x and 4.x","archived":false,"fork":false,"pushed_at":"2025-04-14T21:36:31.000Z","size":482,"stargazers_count":604,"open_issues_count":15,"forks_count":775,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-05-10T13:50:34.678Z","etag":null,"topics":["github-pages","jekyll","jekyll-theme","jekyll-themes","ruby-gem"],"latest_commit_sha":null,"homepage":"https://fongandrew.github.io/hydeout/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fongandrew.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2017-06-01T00:22:41.000Z","updated_at":"2025-05-05T12:32:32.000Z","dependencies_parsed_at":"2024-06-19T03:55:37.607Z","dependency_job_id":"c27e7a9c-b723-473f-b206-ae3a09984f30","html_url":"https://github.com/fongandrew/hydeout","commit_stats":{"total_commits":220,"total_committers":37,"mean_commits":5.945945945945946,"dds":0.5772727272727273,"last_synced_commit":"265598d905fea02a55815ecce02c0d40ae9c13cc"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fongandrew%2Fhydeout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fongandrew%2Fhydeout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fongandrew%2Fhydeout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fongandrew%2Fhydeout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fongandrew","download_url":"https://codeload.github.com/fongandrew/hydeout/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254028798,"owners_count":22002277,"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":["github-pages","jekyll","jekyll-theme","jekyll-themes","ruby-gem"],"created_at":"2024-09-24T13:59:31.898Z","updated_at":"2025-05-13T21:07:01.068Z","avatar_url":"https://github.com/fongandrew.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hydeout\n\nHydeout updates the original [Hyde](https://github.com/poole/hyde)\ntheme for [Jekyll](http://jekyllrb.com) 3.x and 4.x and adds new functionality.\n\n![Desktop](/_screenshots/1.png?raw=true)\n\u003cimg alt=\"Mobile home page\" src=\"/_screenshots/2.png?raw=true\" width=\"300px\" /\u003e\n\u003cimg alt=\"Mobile post page\" src=\"/_screenshots/3.png?raw=true\" width=\"300px\" /\u003e\n\n## ⚠️ IMPORTANT: Branch Information ⚠️\n\n### 👉 For Jekyll 4.x Users (Recommended for New Projects)\n\n**Use the [jekyll-v4 branch](https://github.com/fongandrew/hydeout/tree/jekyll-v4) for all new projects.**\n\nThe jekyll-v4 branch is actively maintained (well, at least more maintained than this branch) and includes full support for Jekyll 4.x with improvements and bug fixes.\n\n```bash\n# Clone with jekyll-v4 branch (recommended)\ngit clone -b jekyll-v4 https://github.com/fongandrew/hydeout.git\n```\n\n### Current Branch: Jekyll 3.x Support (master)\n\n**You're currently viewing the README for the legacy Jekyll 3.x version (master branch).**\n\nThis master branch is maintained for legacy support and compatibility with older GitHub Pages deployments. It will remain on Jekyll 3.x for as long as [GitHub Pages continues to support this version](https://pages.github.com/versions/).\n\nThe master branch exists primarily to avoid breaking existing GitHub Pages sites that use `remote_theme: fongandrew/hydeout` in their `_config.yml` files (see usage below). [See the GitHub instructions for more details.](https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site/).\n\n## Usage details\n\nHydeout uses pagination, so if you have an `index.md`, you'll need to swap\nit with an `index.html` that uses the `index` layout:\n\n```\n---\nlayout: index\ntitle: Home\n---\n```\n\nYou'll also need to add a setting to `_config.yml` telling Jekyll how many posts\nto include per page (e.g. `paginate: 5`).\n\n### Keep It Simple\n\nIn keeping with the original Hyde theme, Hydeout aims to keep the overall\ndesign lightweight and plugin-free. JavaScript is currently limited only\nto Disqus and Google Analytics (and is only loaded if you provide configuration\nvariables).\n\nHydeout makes heavy use of Flexbox in its CSS. If Flexbox is not available,\nthe CSS degrades into a single column layout.\n\n### Customization\n\nHydeout replaces Hyde's class-based theming with the use\nof the following SASS variables:\n\n```scss\n$sidebar-bg-color: #202020 !default;\n$sidebar-fg-color: white !default;\n$sidebar-sticky: true !default;\n$layout-reverse: false !default;\n$link-color: #268bd2 !default;\n```\n\nTo override these variables, create your own `assets/css/main.scss` file.\nDefine your own variables, then import in Hydeout's SCSS, like so:\n\n```scss\n---\n# Jekyll needs front matter for SCSS files\n---\n\n$sidebar-bg-color: #ac4142;\n$link-color: #ac4142;\n$sidebar-sticky: false;\n@import \"hydeout\";\n```\n\nSee the [_variables](_sass/hydeout/_variables.scss) file for other variables\nyou can override.\n\nYou can see the full set of partials you can replace in the\n[`_includes`](_includes) folder, but there are a few worth noting:\n\n* `_includes/copyright.html` - Insert your own copyright here.\n\n* `_includes/custom-head.html` - Insert custom head tags (e.g. to load your\n  own stylesheets)\n\n* `_includes/custom-foot.html` - Insert custom elements at the end of the\n  body (e.g. for custom JS)\n\n* `_includes/custom-nav-links.html` - Additional nav links to insert at the\n  end of the list of links in the sidebar.\n\n  Pro-tip: The `nav`s in the sidebar are flexboxes. Use the `order` property\n  to order your links.\n\n* `_includes/custom-icon-links.html`- Additional icon links to insert at the\n  end of the icon links at the bottom of the sidebar. You can use the `order`\n  property to re-order.\n\n* `_includes/favicons.html` - Replace references to `favicon.ico` and\n  `favicon.png` with your own favicons references.\n\n* `_includes/font-includes.html` - The Abril Fatface font used for the site\n  title is loaded here. If you're overriding that font in the CSS, be sure\n  to also remove the font load reference here.\n\n### New Features\n\n* Hydeout adds a new tags page (accessible in the sidebar). Just create a\n  new page with the tags layout:\n\n  ```\n  ---\n  layout: tags\n  title: Tags\n  ---\n  ```\n\n* Hydeout adds a new \"category\" layout for dedicated category pages.\n  Category pages are automatically added to the sidebar. All other pages\n  must have `sidebar_link: true` in their front matter to show up in\n  the sidebar. To create a category page, use the `category` layout\"\n\n  ```\n  ---\n  layout: category\n  title: My Category\n  ---\n\n  Description of \"My Category\"\n  ```\n\n* You can control how pages are sorted by using the `sidebar_sort_order`\n  parameter in the front matter. This works for both category and non-category\n  pages, although non-category pages will always come first. Take a look at\n  [`_includes/sidebar-nav-links.html`](./_includes/sidebar-nav-links.html) if\n  you want to customize this behavior.\n\n  ```\n  ---\n  layout: page\n  title: My page\n  sidebar_sort_order: 123\n  ---\n\n  Some content.\n  ```\n\n* A simple redirect-to-Google search is available. Just create a page with\n  the `search` layout.\n\n  ```\n  ---\n  layout: search\n  title: Google Search\n  ---\n  ```\n\n* Disqus integration is ready out of the box. Just add the following to\n  your config file:\n\n  ```yaml\n  disqus:\n    shortname: my-disqus-shortname\n  ```\n\n  If you don't want Disqus or want to use something else, override\n  `comments.html`.\n\n* For Google Analytics support, define a `google_analytics` variable with\n  your property ID in your config file.\n\nThere's also a bunch of minor tweaks and adjustments throughout the\ntheme. Hope this works for you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffongandrew%2Fhydeout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffongandrew%2Fhydeout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffongandrew%2Fhydeout/lists"}