{"id":15200096,"url":"https://github.com/michaelnordmeyer/jekyll-theme-emojification","last_synced_at":"2026-02-06T03:32:24.361Z","repository":{"id":215650452,"uuid":"738637329","full_name":"michaelnordmeyer/jekyll-theme-emojification","owner":"michaelnordmeyer","description":"A simple and minimal single-author theme with configurable big emoji as the header link, and configurable background colors, which can be chosen for each post or page","archived":false,"fork":false,"pushed_at":"2025-12-24T16:00:10.000Z","size":391,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-26T06:57:02.204Z","etag":null,"topics":["colorful","github-pages","github-pages-theme","jekyll","jekyll-theme","minimal","minimal-theme","minimalism","minimalist","minimalistic","minimalistic-theme"],"latest_commit_sha":null,"homepage":"https://jekyll-theme-emojification.michaelnordmeyer.com/","language":"HTML","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/michaelnordmeyer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-01-03T17:30:28.000Z","updated_at":"2025-12-24T16:00:13.000Z","dependencies_parsed_at":"2025-12-24T18:06:29.124Z","dependency_job_id":null,"html_url":"https://github.com/michaelnordmeyer/jekyll-theme-emojification","commit_stats":{"total_commits":61,"total_committers":1,"mean_commits":61.0,"dds":0.0,"last_synced_commit":"e138194e40ccb72e94ac72f297c656207597a760"},"previous_names":["michaelnordmeyer/jekyll-theme-emojification"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/michaelnordmeyer/jekyll-theme-emojification","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelnordmeyer%2Fjekyll-theme-emojification","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelnordmeyer%2Fjekyll-theme-emojification/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelnordmeyer%2Fjekyll-theme-emojification/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelnordmeyer%2Fjekyll-theme-emojification/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michaelnordmeyer","download_url":"https://codeload.github.com/michaelnordmeyer/jekyll-theme-emojification/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelnordmeyer%2Fjekyll-theme-emojification/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29148162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T02:39:25.012Z","status":"ssl_error","status_checked_at":"2026-02-06T02:37:22.784Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["colorful","github-pages","github-pages-theme","jekyll","jekyll-theme","minimal","minimal-theme","minimalism","minimalist","minimalistic","minimalistic-theme"],"created_at":"2024-09-28T02:41:23.551Z","updated_at":"2026-02-06T03:32:24.353Z","avatar_url":"https://github.com/michaelnordmeyer.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Jekyll Theme Emojification](repo-card.png)\n\n# 🤩 Jekyll Theme Emojification 🤩\n\nA simple and minimal single-author theme with configurable big emoji as the header link, and configurable background colors, which can be chosen for each post or page.\n\n[Demo site with examples](https://jekyll-theme-emojification.michaelnordmeyer.com/)\n\nThe demo site has useful samples and shows how many color/emoji combinations are possible. [I run a muted version of the theme using `grey` as the main color on my own site](https://michaelnordmeyer.com/).\n\n## Compatibility\n\nCompatible with Jekyll \u003e= 3.9.3 and GitHub Pages.\n\n## Limited, But Useful Features\n\n- Clean, minimalist design\n  - Single-column\n  - Single-author\n  - No visible authors, categories, or tags on posts or pages\n  - No header, footer, or menu\n  - No pagination for the home page to effectively be the archive and allow for searching all titles in-browser\n- Posts\n- Pages\n- Fancy category pages (also on GitHub Pages, where additional plugins are not allowed)\n- A styled redirection page, which will be used by the optional plugin [Jekyll Redirect From](https://github.com/jekyll/jekyll-redirect-from)\n- Built-in feed and sitemap creation (no dependency to jekyll-feed and jekyll-sitemap)\n- Theme-color matching favicons\n- Optional colorful index pages\n- Header images\n- Optional descriptions or excerpts in feed, SEO tags, and on category and home pages\n- Content warnings for embedded videos\n- Hidden semantic info for embedding and SEO like Open Graph, JSON-LD, and inline Microdata. No need for the `jekyll-seo-tag` plugin\n- Minimal build and load times\n- Custom header and footer to add snippets\n\n## Additional Features\n\nSome features cannot be applied automatically due to how Jekyll integrates gem-based or remote themes. They have to be copied manually to your site’s root directory and are included in the [demo repository](https://github.com/michaelnordmeyer/jekyll-theme-emojification-demo).\n\n- Category settings, and category and feed pages, e.g. `_data/categories.yml`, `colors/index.md`, and `colors/feed.xml`\n- Custom error pages from directory `error`\n- Settings from `_config.yml`\n- Draft, build, and deploy support via `Rakefile.rb`, including creating a UUID for posts\n\nOnly the categories and custom error pages need to be edited, if you want to (category name, color, emoji, title, permalink, maybe extra textual content).\n\n## Minutiae\n\n### Category Pages and Feeds\n\nFor categories to be properly working, the site needs category directories having index and feed files for each category. E.g. for the category \"Features\" a directory called `features` with an `index.md` and `feed.xml` with at least the following content:\n\n```yaml\n---\ndescription: \"A description for the head's meta description tag created by this theme\"\ncategory: manuals\nlayout: category\npermalink: /:path/\nsitemap: false\n---\n```\n\nThe name of the category has to match the corresponding category in `_data/categories.yml` and the category itself. The category is either declared by adding the key `category` to a post's front matter, but it is more convenient to have all posts of a certain category in a `_posts` subdirectory of the category, e.g. `features/_posts` for category `features`.\n\nUsed categories have to be linked manually, because there is no menu.\n\nThe category icons and displayed titles are defined in `_data/categories.yml` and have to match the category name’s slug as well.\n\nFeeds for categories are automatically linked on the bottom of index pages and are embedded in the HTML page’s `\u003chead\u003e`. They have to exist next to the above mentioned `index.md` as `feed.xml`.\n\nFor this automatism to work, posts and pages can only belong to a single category, which, if it is to be declared manually, with the key `category:`. `categories:` doesn’t work.\n\n### Header Image Support\n\nA header image is displayed after the title on posts and pages, if `featured_image` is added to the file's frontmatter.\n\n```yaml\n---\nfeatured_image:\n  path: /images/sample-image.jpg\n  alt: The description of the image\n  title: The title of the image\n---\n```\n\nThis image is also used in `feed.xml` and SEO tags as the displayed image.\n\n### Descriptions\n\nThe descriptions are declared in the post's frontmatter:\n\n```yaml\ndescription: \"A helpful description.\"\n```\n\nThey should be limited to 160 characters, because some of the places where they are used are effectively limited in length. If no descriptions are declared, then page’s `excerpt` will be used. This is either the manual declared one or Jekyll will create one automatically.\n\n#### Enabling Descriptions on the Home Page\n\nTo display post descriptions on the home page, simply add the following to your `_config.yml`:\n\n```yaml\ntheme_settings:\n  show_descriptions: true\n```\n\n### Favicons\n\nThere can be several favicons for a site running this theme, because it is possible to use different background colors, and the favicon should reflect the color theme. But there is also a site-wide favicon, which should reflect the style of the home page, and is used in the Atom feed.\n\nIcons are embedded in pixel format and as SVG in a data URL. Pixel format for Safari browsers, SVG for the rest. Because your favicons are displayed in many 3rd-party apps, websites, and other places, a SVG-only or data-URL-only version wouldn't suffice. I recommend to use webp as the pixel format as it is widely supported and has the best file size to image quality ratio.\n\n#### Customizing Favicons\n\nIcons should be named `\u003ccolor\u003e.\u003cimage-type-extension\u003e` without the preceding hash of a hex color, be in either jpg, png, webp image pixel format and SVG format at 180×180 resolution, and be located in `/assets/icons/`. [Theme-matching icons can be easily generated from Unicode glyphs](https://michaelnordmeyer.com/generating-favicons-from-unicode-glyphs), if custom colors are used.\n\nShell scripts for creating those icons are included in the directory `_tools`. They use the star (★) by default. As mentioned in the linked article above, for other fonts or glyphs it might need some positioning to adjust for the metrics of the used font. For the SVG variant a custom representation has to be drawn. These scripts need the free `convert` from ImageMagick to create the webp icons and `base64` to create the data URL.\n\nIcons for the default theme colors are included in webp and SVG format.\n\n### Remove Content from Search Engines\n\nIf some posts or pages should not appear in search engines, they can be removed from the `sitemap.xml`, which helps search engines to find content. Additionally, a hidden header disallowing the indexing is added to the content, which respectable search engines follow. Add this to frontmatter to achieve this:\n\n```yaml\n---\nsitemap: false\n---\n```\n\n### Custom header and footer to add snippets\n\nWhen put in the directory `_includes`, `custom-header.html` and `custom-footer.html` allow to put custom snippets in it.\n\n### Language Direction\n\nSupport for right-to-left languages through `lang_direction: rtl` in `_config.yml` under the key `theme_settings`.\n\n## Installation\n\nInstallation from Gem is recommended, but using a remote theme is also possible, even though it will increase build times a little, depending on your internet connection and the size of the theme download, because it will be downloaded during each build. Gems are installed locally.\n\nGitHub Pages gem users need to use the remote theme method.\n\n### Installation from Gem\n\nAdd this line to your Jekyll site's `Gemfile`:\n\n```ruby\ngem \"jekyll-theme-emojification\", group: [:jekyll_plugins]\n```\n\nThen run `bundle` in your terminal.\n\n```sh\nbundle\n```\n\nAlso add the theme to your Jekyll site's `_config.yml`:\n\n```yaml\ntheme: jekyll-theme-emojification\n```\n\nMake sure that this is the only `theme:` in `_config.yml`, and that there are no other `remote-theme:`.\n\n### Installation as Remote Theme\n\nAdd this line to your Jekyll site's `Gemfile`:\n\n```ruby\ngem \"jekyll-remote-theme\", group: [:jekyll_plugins]\n```\n\nThen run `bundle` in your terminal.\n\n```sh\nbundle\n```\n\nFinally add the remote theme to your Jekyll site's `_config.yml`:\n\n```yaml\nremote_theme: michaelnordmeyer/jekyll-theme-emojification\n```\n\nMake sure that this is the only `remote_theme:` in `_config.yml`, and that there are no other `theme:`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelnordmeyer%2Fjekyll-theme-emojification","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelnordmeyer%2Fjekyll-theme-emojification","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelnordmeyer%2Fjekyll-theme-emojification/lists"}