{"id":15200104,"url":"https://github.com/questionlp/termina-plex","last_synced_at":"2025-10-28T16:31:31.726Z","repository":{"id":229363662,"uuid":"776277641","full_name":"questionlp/termina-plex","owner":"questionlp","description":"Terminal-inspired theme for Jekyll based on a port of the Nightfall theme for Hugo.","archived":false,"fork":false,"pushed_at":"2024-08-03T17:56:58.000Z","size":12849,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-09-29T02:41:20.635Z","etag":null,"topics":["dark-mode","ibm-plex","jekyll","jekyll-theme","light-mode","themes"],"latest_commit_sha":null,"homepage":"https://questionlp.github.io/termina-plex/","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/questionlp.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":"2024-03-23T04:07:07.000Z","updated_at":"2024-08-03T17:56:22.000Z","dependencies_parsed_at":"2024-08-03T18:58:14.047Z","dependency_job_id":null,"html_url":"https://github.com/questionlp/termina-plex","commit_stats":null,"previous_names":["questionlp/termina-plex"],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Ftermina-plex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Ftermina-plex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Ftermina-plex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Ftermina-plex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/questionlp","download_url":"https://codeload.github.com/questionlp/termina-plex/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219859166,"owners_count":16556037,"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":["dark-mode","ibm-plex","jekyll","jekyll-theme","light-mode","themes"],"created_at":"2024-09-28T02:41:26.848Z","updated_at":"2025-10-28T16:31:25.323Z","avatar_url":"https://github.com/questionlp.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Termina Plex\n\nTermina Plex is a [Jekyll](https://jekyllrb.com) theme that is a port of the [Nightfall](https://github.com/LordMathis/hugo-theme-nightfall) theme for [Hugo](https://gohugo.io), developed by [Matúš Námešný](https://namesny.com). This theme uses some of the foundational code provided by the [Minima](https://jekyll.github.io/minima/) theme for Jekyll.\n\nThe theme is designed with a minimal default landing page and a separate page for listing available blog posts. It also features the [IBM Plex](https://ibm.com/plex) Sans and IBM Plex Mono typefaces throughout the design and includes the necessary web font files in the theme bundle.\n\nBy the default, the theme respects the `prefers-color-scheme` value provided by the browser. A color scheme toggle is included in the header that allows the viewer to switch between light and dark mode. Once toggled, the value is stored in the local storage using [Web Storage API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API).\n\n## Installation\n\nAdd this line to your Jekyll site's Gemfile to install:\n\n```ruby\ngem \"termina-plex\"\n```\n\nTo install the theme from GitHub, add this line to your Jekyll site's Gemfile:\n\n```ruby\ngem \"termina-plex\", git: \"https://github.com/questionlp/termina-plex.git\"\n```\n\nAnd then execute:\n\n```bash\nbundle\n```\n\n## Site Structure\n\nThe main index page, `index.html` is designed to be a simple landing page with the name of the site author and a list of social links. The file uses the `index` layout.\n\nThe more traditional blog post listing page is designed to be hosted under `/blog` with the `blog/index.html` using the more traditional `home` layout. The layout supports pagination, by way of the jekyll-paginate plugin, and can be configured with the `paginate` and `paginate_path` settings in `_config.yml`.\n\nFor pagination to work with the post listing page hosted under `/blog`, the `paginate_path` setting should start with `/blog/`.\n\nIf you want to change the path for the post listing page, the `blog_path` setting can be set to the preferred path. The `paginate_path` setting should also be updated to reflect the correct path.\n\n## Index Page Author Pronouns\n\nAuthor pronouns set using the `site.author.pronouns` configuration setting and will be displayed below the author name on pages that use the `index` layout.\n\n## Google and Umami Analytics\n\nThis theme provides support for Google and Umami Analytics by setting appropriate site configuration values.\n\n### Google Analytics\n\nTo automatically add the necessary Google tag to the site, add the following line to the top level of `_config.yml`:\n\n```yaml\ngoogle_analytics: G-XXXXX\n```\n\nReplace `G-XXXXX` with the appropriate measurement ID.\n\n### Umami Analytics\n\nTo automatically add the necessary Umami analytics tag to the site, add the following lines to the top level of `_config.yml`:\n\n```yaml\numami_analytics:\n  url: \"https://example.org/umami.js\"\n  data_website_id: \"abc\"\n```\n\nReplace the `url` and `data_website_id` with the appropriate values for your Umami Analytics instance.\n\nAdditional parameters can be set in the tag by providing the appropriate values for the following keys under `umami_analytics`:\n\n| Umami Tag Parameter | Site Configuration |\n| --- | --- |\n| data-host-url | data_host_url |\n| data-auto-track | data_auto_track |\n| data-domains | data_domains |\n\n## Theme Configuration\n\nTheme specific configuration is done within the `termina-plex` section of the `_config.yml` file.\n\nThe date format used by the theme is defined by the `termina-plex.date_format` setting. The value needs to be in [valid `strftime` format](https://docs.ruby-lang.org/en/master/strftime_formatting_rdoc.html). The theme defaults to `%d %b %Y`.\n\nThe title displayed in the header of the page with display the site title, defined by the `site.title` configuration value, if neither the `termina-plex.username` or the `termina-plex.hostname` settings are configured. When either of the settings are configured, a Bash-like prompt is built using the configured values.\n\nThe links displayed in the header of the page are defined in the `termina-plex.header_links` setting. Each link is defined as an object with a `name` and a `url` key. The value of the `name` key will be transformed to lowercase via CSS.\n\nThe social links displayed under the site title in the main section of the landing page are defined by the `termina-plex.social_links` setting. Each link is defined as an object with a `name` and `url` key. An optional `rel` key is available if link-based validation is required by applications like Mastodon. As with the header link names, the link names will also be transformed to lowercase via CSS.\n\nTo set a site-wide `fediverse:creator` meta tag for article tagline support in Mastodon, define the `termina-plex.fediverse_creator` setting with the full account name including the initial `@`.\n\nIf centered tables are preferred, the `termina-plex.centered_tables` setting can be set to `true`. By default, it uses the user agent's default alignment.\n\nBy default, the theme will transform post titles to be capitalized on pages that use the `home` layout. If you prefer to have post titles not be transformed, you can set `termina-plex.standard_titles` to `true`.\n\n## Screenshots\n\n![Screenshot of the Termina Plex theme for Jekyll showing the landing page in dark mode](/screenshots/termina-plex-01-landing-page-dark.png)\n\n![Screenshot of the Termina Plex theme for Jekyll showing the landing page in light mode](/screenshots/termina-plex-02-landing-page-light.png)\n\n![Screenshot of the Termina Plex theme for Jekyll showing a listing blog posts in dark mode](/screenshots/termina-plex-03-blog-post-listing-dark.png)\n\n![Screenshot of the Termina Plex theme for Jekyll showing a listing blog posts in light mode](/screenshots/termina-plex-04-blog-post-listing-light.png)\n\n![Screenshot of the Termina Plex theme for Jekyll showing a blog post in dark mode](/screenshots/termina-plex-05-blog-post-dark.png)\n\n![Screenshot of the Termina Plex theme for Jekyll showing a blog post in light mode](/screenshots/termina-plex-06-blog-post-light.png)\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n\nBoth the original Nightfall and the Minina themes are licensed under the terms of the MIT License.\n\nThe included IBM Plex font files are licensed under the terms of the [SIL Open Font License, Version 1.1](https://github.com/IBM/plex/blob/master/LICENSE.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestionlp%2Ftermina-plex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquestionlp%2Ftermina-plex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestionlp%2Ftermina-plex/lists"}