{"id":15044749,"url":"https://github.com/ertuil/erblog","last_synced_at":"2026-03-07T22:32:47.462Z","repository":{"id":56623035,"uuid":"224989291","full_name":"ertuil/erblog","owner":"ertuil","description":"A Hugo theme created by ertuil. ","archived":false,"fork":false,"pushed_at":"2025-01-02T06:29:29.000Z","size":25034,"stargazers_count":62,"open_issues_count":1,"forks_count":27,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-17T11:52:05.636Z","etag":null,"topics":["blog","hugo","hugo-blog-theme","hugo-theme","mathjax","mobile-web","theme"],"latest_commit_sha":null,"homepage":"https://www.elliot98.top","language":"CSS","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/ertuil.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING","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}},"created_at":"2019-11-30T09:34:44.000Z","updated_at":"2025-06-04T09:43:55.000Z","dependencies_parsed_at":"2024-09-25T01:54:39.281Z","dependency_job_id":"3eea7eea-a6b8-40ce-a92f-9d0eab342c42","html_url":"https://github.com/ertuil/erblog","commit_stats":{"total_commits":139,"total_committers":8,"mean_commits":17.375,"dds":0.3525179856115108,"last_synced_commit":"b38f867912ef3a47543037142d84d9238444ac72"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ertuil/erblog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertuil%2Ferblog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertuil%2Ferblog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertuil%2Ferblog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertuil%2Ferblog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ertuil","download_url":"https://codeload.github.com/ertuil/erblog/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertuil%2Ferblog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30234665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T19:01:10.287Z","status":"ssl_error","status_checked_at":"2026-03-07T18:59:58.103Z","response_time":53,"last_error":"SSL_read: 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":["blog","hugo","hugo-blog-theme","hugo-theme","mathjax","mobile-web","theme"],"created_at":"2024-09-24T20:50:59.291Z","updated_at":"2026-03-07T22:32:47.430Z","avatar_url":"https://github.com/ertuil.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Erblog\n\n\u003e ⚠️⚠️⚠️ **Note:** Mathjax is not included directly due to the performance considerations now! \n\u003e\n\u003e Use `math: true` in Front Matter to enable Mathjax in each single page.\n\u003e\n\u003e Or set `Params.math: true` to enable it globally.\n\nA personal blog theme powered by [Hugo](https://gohugo.io).\nErblog is written by Ertuil with [layui.js](https://www.layui.com), [font-awssome](https://fontawesome.com), github markdown css and [undraw](https://undraw.co).\n\n![images/screenshot.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/screenshot.png)\n\n\u003e Erblog is also a responsive theme which means it is customed for your mobile platforms. \n\n\u003cimg src=\"https://raw.githubusercontent.com/ertuil/erblog/master/images/mobile.png\" width=\"400px\" alt=\"images/mobile.png\"/\u003e\n\n\n\u003e Now it is possible to change the color of your themes. Use `Params.badge` and `Params.quote` to select one of your favourite color.\n\n\n| Some Pictures | |\n| ---- | ----------- |\n| ![images/color1.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/color1.png) | ![images/color2.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/color2.png) |\n| ![images/color3.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/color3.png) | ![images/list.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/list.png) | \n| ![images/single.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/single.png) | ![images/zone.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/zone.png) |\n\n## 1. Installation\n\nYou can install the theme by git clone.\n\n```\n$ git submodule add https://github.com/ertuil/erblog themes/erblog\n$ git submodule init\n$ git submodule update\n```\n\nNow you can get updates to Erblog in the future by updating the submodule:\n\n```\n$ git submodule update --remote themes/erblog\n```\n\n\u003e [@progressify](https://github.com/progressify) contributed a new style for scrollbar. You can check out the branch called [https://github.com/ertuil/erblog/tree/styled-scrollbar](https://github.com/ertuil/erblog/tree/styled-scrollbar) to use. Here is an example:\n\u003e [https://progressify.dev](https://progressify.dev)\n\u003e Thanks to his contribution.\n\n## 2. Configuration\n\nThere are some basic configuration options you may want to use:\n\n| Name | Description | Default |\n| ---- | ---- | ---- |\n| title | Name of your website | None |\n| googleAnalytics | Google Analytics ID| None |\n| Params.portrait | Path to your portrait | erblog/static/self/img/avatar.jpg |\n| Params.author | Your Name | Authors |\n| Params.description | Description of your Blog | Intro |\n| Params.bio | A Biography for your Blog | None |\n| Params.logo | Your Blog's Logo | None |\n| Params.favicon | The favicon file | /favicon.ico |\n| Params.math | import mathjax globally | false |\n| Params.index_posts_num | The number of posts displayed in Index | 5 | \n| Params.google_search | Enable Google Intra-Site Search Engine | false | \n| Params.badge | The color for badge ('red', 'cyan', 'orange', 'green', 'blue', 'black' and 'gray' are available) | 'red' |\n| Params.quote | The color for quota ('red', 'cyan', 'orange', 'green', 'blue', 'black' and 'gray' are available) | 'green' |\n| Params.notice | Contents of notification | none |\n| Params.notice_color | The color for notification background ('red', 'cyan', 'orange', 'green', 'blue', 'black' and 'gray' are available) | 'red' |\n\nAdd your own custom menus in the `config.toml` like this:\n\n```\n[[menu.main]]\n    url = \"/home/\"\n    name = \"Files\"\n    weight = 6\n\n[[menu.main]]\n    url = \"/dl/\"\n    name = \"Download\"\n    weight = 7\n```\n\nA Menu in the footer is also available:\n\n```\n[[menu.footer]]\n    identifier = \"home\"\n    name = \"home\"\n    url = \"/\"\n    weight = 1\n\n[[menu.footer]]\n    identifier = \"about\"\n    name = \"About\"\n    url = \"/about/\"\n    weight = 2\n```\n\nNow you can add your contacts like this:\n\n```\n# Social icons to be shown on the right-hand side of the navigation bar\n# The \"name\" field should match the name of the icon to be used\n# The list of available icons can be found at http://fontawesome.io/icons/\n\n[[menu.icon]]\n    url = \"mailto:me@xxx.com\"\n    name = \"envelope-o\"\n    weight = 1\n\n[[menu.icon]]\n    url = \"https://github.com/username/\"\n    name = \"github\"\n    weight = 1\n\n[[menu.icon]]\n    url = \"https://twitter.com/username\"\n    name = \"twitter\"\n    weight = 1\n\n[[menu.icon]]\n    url = \"https://www.instagram.com/username/\"\n    name = \"instagram\"\n    weight = 1\n```\n\nFor more details, see the example site.\n\n## 3. Content Management\n\n### 3.1 Posts\n\nThere are three basic sections, 'post', 'zone' and 'gallery'. You may create a new post using the following command:\n\n```\nhugo new post/post_name.md\n```\n\n### 3.2 Zone\n\nA section like facebook\n\n![images/zone.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/zone.png)\n\n```\nhugo new zone/example.md\n```\n\n### 3.3 Gallery\n\nGallery is a simple collection for your photos.\n\n![images/gallery.png](https://raw.githubusercontent.com/ertuil/erblog/master/images/gallery.png)\n\n```\nhugo new gallery/gallery_name.md\n```\n\nYou can upload your files to the `/static` directory and write the contents in `gallery_name.md`:\n\n```\n---\ntitle: \"A gallery\"\ndate: 2019-12-01T13:21:53+08:00\ndraft: false\n---\n\n![0](/avater.jpg)\n![1](/people/1.png)\n![2](/people/2.png)\n![3](/people/3.png)\n```\n\n### 3.4 Add a Zone and Gallery to the Menu\n\nAdd the following content to your `config.toml` file:\n\n```toml\n[[menu.main]]\n    url = \"/zone/\"\n    name = \"Zone\"\n    weight = 1\n\n[[menu.main]]\n    url = \"/gallery/\"\n    name = \"Gallery\"\n    weight = 2\n```\n\n## 4. User-Defined HTML Hooks\n\nThere are two hooks available for you to insert your HTML code.\n\n1. `layouts/partials/self-define.html` renders content **above the footer for every page**.\n2. `layouts/partials/self-define-single.html` renders content **above the footer for every blog post**. This hook is useful to define your *comment modules*, such as gittalk, and Disqus.\n\n### 4.1 Using Hooks to Add Discus Comments\n\nAdd Discus comments to the bottom of each post by inserting the following in the `layouts/partials/self-define-single.html` hook.\n\n```\n{{ template \"_internal/disqus.html\" . }}\n```\n\nFor this to work you will also need to define the `disqusShortName` in your `config.toml`:\n\n``` toml\ndisqusShortName = \"your-disqus-shortname\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fertuil%2Ferblog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fertuil%2Ferblog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fertuil%2Ferblog/lists"}