{"id":17748090,"url":"https://github.com/en9inerd/zola-hacker","last_synced_at":"2026-03-19T23:03:19.873Z","repository":{"id":249683234,"uuid":"831756006","full_name":"en9inerd/zola-hacker","owner":"en9inerd","description":"Hacker is a Zola theme","archived":false,"fork":false,"pushed_at":"2024-08-07T14:33:41.000Z","size":374,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-08-08T17:00:55.996Z","etag":null,"topics":["zola","zola-theme"],"latest_commit_sha":null,"homepage":"https://zola-hacker.enginerd.io","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/en9inerd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-07-21T14:38:06.000Z","updated_at":"2024-08-07T14:33:44.000Z","dependencies_parsed_at":"2024-10-26T12:07:20.123Z","dependency_job_id":"af7448cd-8473-4730-9390-9313b26ffbc7","html_url":"https://github.com/en9inerd/zola-hacker","commit_stats":null,"previous_names":["en9inerd/zola-hacker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/en9inerd%2Fzola-hacker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/en9inerd%2Fzola-hacker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/en9inerd%2Fzola-hacker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/en9inerd%2Fzola-hacker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/en9inerd","download_url":"https://codeload.github.com/en9inerd/zola-hacker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245955201,"owners_count":20699891,"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":["zola","zola-theme"],"created_at":"2024-10-26T10:01:13.004Z","updated_at":"2026-03-19T23:03:19.861Z","avatar_url":"https://github.com/en9inerd.png","language":"HTML","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"# Hacker theme for Zola\n\nZola Hacker is a minimalistic theme for Zola, inspired by the [Hacker theme](https://pages-themes.github.io/hacker/) for Jekyll. It is designed for developers who want to write blogs.\n\n## Demo\n\n[Live Preview](https://zola-hacker.enginerd.io/).\n\n## Requirements\n\nBefore using the theme, you need to install the [Zola](https://www.getzola.org/documentation/getting-started/installation/) ≥ 0.19.1.\n\n## Quick Start\n\n```bash\ngit clone git@github.com:en9inerd/zola-hacker.git\ncd zola-hacker\nzola serve\n# open http://127.0.0.1:1111/ in the browser\n```\n\n## Installation\n\nJust earlier we showed you how to run the theme directly. Now we start to\ninstall the theme in an existing site step by step.\n\n### Step 1: Create a new zola site\n\n```bash\nzola init mysite\n```\n\n### Step 2: Install Zola Hacker Theme\n\nDownload this theme to your themes directory:\n\n```bash\ncd mysite/themes\ngit clone git@github.com:en9inerd/zola-hacker.git\n```\n\nOr install as a submodule:\n\n```bash\ncd mysite\ngit init  # if your project is a git repository already, ignore this command\ngit submodule add git@github.com:en9inerd/zola-hacker.git themes/hacker\n```\n\n### Step 3: Configuration\n\nEnable the theme in your `zola.toml` in the site directory:\n\n```toml\ntheme = \"hacker\"\n```\n\nOr copy the `zola.toml` from the theme directory to your project's\nroot directory:\n\n```bash\ncp themes/hacker/zola.toml zola.toml\n```\n\n### Step 4: Add new content\n\nYou can copy the content from the theme directory to your project:\n\n```bash\ncp -r themes/hacker/content .\n```\n\nYou can modify or add new posts in the `content/posts`, `content/pages` or other\ncontent directories as needed.\n\n### Step 5: Run the project\n\nJust run `zola serve` in the root path of the project:\n\n```bash\nzola serve\n```\n\nThis command will start the Zola development web server accessible by default at\n`http://127.0.0.1:1111`. Saved changes will live reload in the browser.\n\n## Customization\n\nYou can customize your configurations, templates and content for yourself. Look\nat the `zola.toml`, `theme.toml`, `content` files and templates files in this\nrepo for an idea.\n\n### Global Configuration\n\nThere are some configuration options that you can customize in `zola.toml`.\n\n#### Configuration options before `extra` options\n\nSet the tags taxonomy in the `zola.toml`:\n\n```toml\ntaxonomies = [\n    { name = \"tags\" },\n]\n```\n\n#### Configuration options under the `extra`\n\nThe following options should be under the `[extra]` in `zola.toml`\n\n- `language_code` - set HTML file language (default to `en-US`)\n- `title_separator` - the separator to your site title, like `|` and `-` (defaults to `|`)\n- `logo` - path to the logo image\n- `google_analytics` - Google Analytics tracking ID\n- `timeformat` - the timeformat for the blog article published date\n- `timezone` - the timezone for the blog article published date\n- `edit_page` - whether to show the edit page in the github repo for your posts\n- `menu` - set the menu items for your site\n- `contact_form_script_id` - the script id for the contact form based on [Google Script](https://github.com/en9inerd/learn-to-send-email-via-google-script-html-no-server)\n- `[extra.github]` - set the GitHub metadata for your site\n- `[extra.giscus]` - set the Giscus settings for your site to enable the comments. Please use own settings from the [Giscus](https://giscus.app/) website\n- `[extra.opengraph]` - set the Open Graph metadata for your site\n- `[extra.pgp_key]` - set pgp key in the footer for certain pages\n- `social_links` - set the social media links in the footer\n...\n\n### Templates\n\nAll pages extend the `base.html`, and you can customize them as need.\n\n### Shortcodes\n\nThe theme provides some shortcodes to help you write your content:\n\n`contact_form`\nThe `contact_form` shortcode is based on [Google Apps Mail](https://github.com/en9inerd/learn-to-send-email-via-google-script-html-no-server) to send emails without a server.\nIt depends on `contact_form_script_id` in the `zola.toml`.\n\n```markdown\n{{ contact_form() }}\n```\n\n`cv`\nThe `cv` shortcode is used to display the CV in the page. Data for CV is stored in yaml format in the `data/cv` directory.\n\n```markdown\n{{ cv() }}\n```\n\n`github_avatar`\nThe `github_avatar` shortcode is used to display the GitHub avatar image. It depends on `extra.github.username` in the `zola.toml`. Also, you can pass size as an argument.\n\n```markdown\n{{ github_avatar(size=100) }}\n```\n\n`projects`\nThe `projects` shortcode is used to display repositories from GitHub. It depends on `extra.github.username` in the `zola.toml` and `extra.repo_names` in page front matter to filter the repositories.\n\n```markdown\n{{ projects() }}\n```\n\n## Reporting Issues\n\nWe use GitHub Issues as the official bug tracker for the **Zola Hacker Theme**. Please\nsearch [existing issues](https://github.com/en9inerd/zola-hacker/issues). It’s\npossible someone has already reported the same problem.\n\nIf your problem or idea is not addressed yet, [open a new issue](https://github.com/en9inerd/zola-hacker/issues/new).\n\n## License\n\n**Zola Hacker Theme** is distributed under the terms of the\n[MIT license](https://github.com/en9inerd/zola-hacker/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fen9inerd%2Fzola-hacker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fen9inerd%2Fzola-hacker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fen9inerd%2Fzola-hacker/lists"}