{"id":50842881,"url":"https://github.com/amd989/wordpress-theme-terminal","last_synced_at":"2026-06-14T07:35:00.100Z","repository":{"id":352293607,"uuid":"1214355104","full_name":"amd989/wordpress-theme-terminal","owner":"amd989","description":"A simple, retro theme for Wordpress","archived":false,"fork":false,"pushed_at":"2026-04-18T20:13:16.000Z","size":160,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-14T07:34:58.557Z","etag":null,"topics":["blog","css","firacode","minimal","monospace","personal-website","terminal","wordpress","wordpress-theme"],"latest_commit_sha":null,"homepage":"https://blog.alejandro.md","language":"PHP","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/amd989.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"amd989","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"amd989","thanks_dev":null,"custom":null}},"created_at":"2026-04-18T13:11:33.000Z","updated_at":"2026-04-18T20:15:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/amd989/wordpress-theme-terminal","commit_stats":null,"previous_names":["amd989/wordpress-theme-terminal"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/amd989/wordpress-theme-terminal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd989%2Fwordpress-theme-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd989%2Fwordpress-theme-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd989%2Fwordpress-theme-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd989%2Fwordpress-theme-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amd989","download_url":"https://codeload.github.com/amd989/wordpress-theme-terminal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd989%2Fwordpress-theme-terminal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34313515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["blog","css","firacode","minimal","monospace","personal-website","terminal","wordpress","wordpress-theme"],"created_at":"2026-06-14T07:34:59.503Z","updated_at":"2026-06-14T07:35:00.092Z","avatar_url":"https://github.com/amd989.png","language":"PHP","funding_links":["https://ko-fi.com/amd989","https://buymeacoffee.com/amd989"],"categories":[],"sub_categories":[],"readme":"# Terminal — WordPress theme\n\nA minimal retro-terminal blog theme for WordPress. This is a port of [panr/hugo-theme-terminal](https://github.com/panr/hugo-theme-terminal) — the original Hugo theme's CSS, typography, and markup have been preserved; Hugo templating has been rewritten as classic PHP templates.\n\n![Terminal](https://github.com/panr/hugo-theme-terminal/blob/master/images/terminal-theme.png?raw=true)\n\n## Install\n\n```\ncd wp-content/themes\ngit clone https://github.com/amd989/wordpress-theme-terminal.git terminal\n```\n\nThen activate under **Appearance → Themes**.\n\nRequires WordPress 6.0+ and PHP 8.0+.\n\n## Configure\n\nAll options live under **Appearance → Customize → Terminal Theme**:\n\n- **Colors** — accent, background, foreground. Change any of these and the customizer preview updates live via CSS custom properties.\n- **Layout \u0026 Navigation** — container mode (default / full / centered), logo text, site subtitle, keywords, menu \"More\"-dropdown threshold and label.\n- **Post Display** — reading time, last-updated stamp, auto-cover-image, unit labels, date format.\n- **Table of Contents** — site-wide enable + heading text. Individual posts override via the meta box.\n- **Labels** — all user-facing button / heading strings.\n- **Social \u0026 SEO** — Twitter card handles.\n- **Analytics** — Google Analytics Measurement ID.\n\nPer-post overrides live in the **Terminal Options** meta box on the post editor (side column): cover image URL, cover credit, noindex, hide comments, force reading time on this post, TOC on/off, date format override, show-full-content on listings.\n\nAssign a menu to the **Main Navigation** location under **Appearance → Menus**.\n\n## Shortcodes\n\n### Collapsible code block\n\n```\n[code language=\"go\" title=\"example.go\" open=\"true\"]\npackage main\n\nfunc main() {\n    println(\"hello\")\n}\n[/code]\n```\n\nArgument names are preserved from the Hugo theme's `code` shortcode. Prism.js highlights the block client-side; the language identifier is the Prism short name (e.g. `go`, `bash`, `python`, `javascript`).\n\n### Positioned image\n\n```\n[image src=\"https://example.com/img.jpg\" alt=\"Alt text\" position=\"center\" width=\"600\"]\n```\n\nValid positions: `left` (default), `center`, `right`.\n\n### Terms listing\n\n```\n[terminal_terms taxonomy=\"post_tag\"]\n```\n\nAlphabetical list of taxonomy terms with post counts. Replaces Hugo's `terms.html` behavior.\n\n## Syntax highlighting\n\nPrism.js is loaded from jsDelivr with the autoloader plugin, so any language grammar loads on demand the first time it's used. The CSS color mapping in `assets/css/syntax.css` uses the same duotone variables (`--first-tone`, `--second-tone`, `--comment`) derived from your accent color.\n\nTo self-host Prism, drop a custom build from [prismjs.com/download](https://prismjs.com/download) into `assets/js/prism.js` and override the `prism-core` / `prism-autoloader` enqueues from a child theme's `functions.php`.\n\n## Custom CSS overrides\n\nOverride theme CSS variables or add custom rules by editing `assets/css/terminal.css` (pre-bundled, but empty) or by adding a child theme.\n\n### terminal-css theme generator\n\npanr's [terminal-css generator](https://panr.github.io/terminal-css/) produces drop-in color palettes for this theme. Use the **theme** output (the 4-line `:root { --background; --foreground; --accent; }` block) — it's CSS-variable-only and layers cleanly on top of the theme.\n\nTwo ways to apply a generated palette:\n\n- Paste the three hex values directly into **Appearance → Customize → Terminal Theme → Colors**.\n- Or paste the full `:root {…}` block into `assets/css/terminal.css` to version-control the palette alongside the theme.\n\nDo **not** use the generator's \"standalone\" output — that's a full stylesheet meant for pages with no other CSS loaded, and will conflict with the theme's own rules.\n\n## Multi-language\n\nThe theme is translation-ready — UI strings are wrapped in `__()` / `_e()` and shipped with a `.pot` template in `languages/`. For content translation, install Polylang — the language switcher in the header activates automatically when Polylang's functions are present, and no-ops otherwise.\n\n## Development\n\nThere is no build step. CSS is served directly from `assets/css/` in the order Hugo used (fonts → main → header → menu → footer → post → code → buttons → pagination → terms → syntax → gist → terminal). JS is in `assets/js/`. Make changes in place and refresh.\n\nCI runs `php -l` against every `.php` file across supported PHP versions.\n\n### Local test harness\n\n```\ndocker compose up -d\n```\n\nThen open http://localhost:8080, run the WordPress install wizard, and activate **Terminal** under Appearance → Themes. The repo is bind-mounted into `wp-content/themes/terminal`, so edits to `.php` / `.css` / `.js` files are reflected on refresh.\n\nWP-CLI is wired under the `cli` profile:\n\n```\ndocker compose run --rm wpcli wp theme list\ndocker compose run --rm wpcli wp theme activate terminal\n```\n\nStop + wipe:\n\n```\ndocker compose down -v   # -v also removes the db + wp volumes\n```\n\n## Credits\n\n- WordPress theme © 2026 [amd989](https://github.com/amd989) — original PHP templates, customizer integration, meta boxes, shortcodes, and WordPress plumbing.\n- Design inspiration: Hugo theme [terminal](https://github.com/panr/hugo-theme-terminal) © 2024 [panr](https://github.com/panr) — palette, Fira Code typography, duotone code colors, container layout.\n- [Prism.js](https://prismjs.com) © Lea Verou — syntax highlighting.\n- [Fira Code](https://github.com/tonsky/FiraCode) © Nikita Prokopov — SIL Open Font License.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famd989%2Fwordpress-theme-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famd989%2Fwordpress-theme-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famd989%2Fwordpress-theme-terminal/lists"}