{"id":19889457,"url":"https://github.com/theyorkshiredev/hugo-bts4","last_synced_at":"2026-05-09T20:09:48.791Z","repository":{"id":119564457,"uuid":"153915408","full_name":"TheYorkshireDev/hugo-bts4","owner":"TheYorkshireDev","description":"Minmal Hugo Theme with BootStrap 4","archived":false,"fork":false,"pushed_at":"2019-02-11T21:46:25.000Z","size":91,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-11T19:23:08.618Z","etag":null,"topics":["hugo","hugo-theme","minimal","theme"],"latest_commit_sha":null,"homepage":"","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/TheYorkshireDev.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":"2018-10-20T14:44:07.000Z","updated_at":"2019-06-27T20:00:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"e34b9c6e-738a-4e9c-8491-b6243f170131","html_url":"https://github.com/TheYorkshireDev/hugo-bts4","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheYorkshireDev%2Fhugo-bts4","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheYorkshireDev%2Fhugo-bts4/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheYorkshireDev%2Fhugo-bts4/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheYorkshireDev%2Fhugo-bts4/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheYorkshireDev","download_url":"https://codeload.github.com/TheYorkshireDev/hugo-bts4/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241317601,"owners_count":19943202,"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":["hugo","hugo-theme","minimal","theme"],"created_at":"2024-11-12T18:10:15.774Z","updated_at":"2025-11-25T01:03:23.423Z","avatar_url":"https://github.com/TheYorkshireDev.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hugo-zero\n\nThe `hugo-zero` theme is intended for basic websites, blogging or a combination of both. This is different to most Hugo themes which focus solely on blogging. \n \n**NOTE:** The **basic website** mentioned above refer to websites with a single level of navigation/structure, such as a homepage, about page and so on **without** further sub-pages.\n\n## Installation\n\nIn your Hugo site `themes` directory, run:\n\n```\n$ git clone https://github.com/TheYorkshireDev/hugo-zero.git\n```\n\nNext, open `config.toml` in the base of the Hugo site and ensure the theme option is set to `hugo-zero`:\n\n```\ntheme = \"hugo-zero\"\n```\n\nFor more information read the official [setup guide](https://gohugo.io/themes/installing-and-using-themes/) of Hugo.\n\n## Basic Instructions\n\nThe `hugo-zero` theme has a few page templates which you should understand before using the theme. Since this theme is for Hugo you have your usual `list` and `single` pages for use with listing sub-pages and displaying indivdual posts. This is nothing new for Hugo themes and we haven't done anything fancy with these templates.\n\nWe have however added the `main` template, this is for the non-blogpost webpages such as a homepage or about page on a website using `hugo-zero`. A guide for which templates should be used on certain pages are below:\n\n| Page           | URI Route     | Template | Explicit Declaration |\n|----------------|---------------|----------|----------------------|\n| Homepage       | `/`           | main     | Yes                  |\n| About          | `/about`      | main     | Yes                  |\n| Contact        | `/contact`    | main     | Yes                  |\n| All Blog Posts | `/blog`       | list     | No                   |\n| Blog Post 1    | `/blog/post1` | single   | No                   |\n| Blog Post 2    | `/blog/post2` | single   | No                   |\n\nFor those pages such as a homepage or about page which should use the `main` template you need to add `layout: \"main\"` to the front matter of the said page.\n\n## Configuration\n\n### Config.toml example\n\n```toml\nbaseurl = \"/\"\ntitle = \"Hugo Zero\"\nlanguageCode = \"en-us\"\ntheme = \"hugo-zero\"\n```\n\n### Front Matter example\n\n```yaml\n---\ntitle: \"Example article title\"\ndate: \"2018-10-22\"\ndescription: \"Example article description\"\n---\n```\n\n### Settings\n\n#### Code Syntax Highlighting\n\nIf you are going to use code syntax highlighting within the theme it is recommeded to set `pygmentsUseClasses`. The syntax styling was developed with this flag set to true hence there could be unforeseen style issues otherwise.\n\n```toml\npygmentsUseClasses=true\n```\n\n#### Site Author\n\nWe should define the website author in the `config.toml` file, that way we can set the `author` meta data in the header.\n\n```toml\n[author]\n    name = \"Bob Smith\"\n```\n\n#### Accent Color\n\nWhen on the website using a mobile device Chrome, Opera and Firefox OS allow you to choose the colour of the browser theme. You can read more about it [here](https://developers.google.com/web/fundamentals/design-and-ux/browser-customization/#meta_theme_color_for_chrome_and_opera).\n\nTo specify what color the theme should become we can set `[params.color]` in in the `config.toml` file.\n\n```toml\n[params.color]\n    accent = \"#38bb6c\"\n```\n\n#### NavBar Logo\n\nThe NavBar on your website can display either the site title or a logo. By default the site title will be used but if you specify a logo in the `config.toml` that will be displayed instead.\n\n```toml\n[params]\n    navbarLogo = \"http://placehold.it/150x50?text=Hugo-Zero\"\n    navbarLogoAlt = \"Logo for Hugo Zero test website\"\n```\n\n#### NavBar Links\n\nTo add items to the Navbar you must add `[[params.menu]]` items to the `config.toml`, for example to add About and Contact you would add:\n\n```toml\n[[params.menu]]\n    name = \"About\"\n    url  = \"/about\"\n\n[[params.menu]]\n    name = \"Contact\"\n    url  = \"/contact\"\n```\n\n#### GitHub Links\n\nIf the posts are hosted on GitHub (or any other site) you can specify the path to the file allowing others to contribute. Note the path should not include a file, that will be appended automatically.\n\n```toml\n[params.github_contribution]\n    link = \"https://github.com/path-to-file/\"\n```\n\n#### Footer Links\n\nThe footer is split into three sections; `info`, `social`, `quicklinks`.\n\nAll items on the footer are detailed under `[params.footer]` within the `config.toml`.\n\nThe `info` section is designed to detail the website author, an example is below:\n```toml\n[params.footer]\n    info = \"© Bill Smith\"\n```\n\nThe `social` section displays social media icons which will link to the relevant websites/accounts. The first attribute specifies the font awesome icon classes and the second attribute is the url to the external website, an example is below:\n```toml\n[params.footer]\n    [[params.footer.social]]\n      icon = \"fab fa-twitter\"\n      link = \"https://twitter.com\"\n\n    [[params.footer.social]]\n      icon = \"fab fa-instagram\"\n      link = \"https://www.instagram.com\"\n\n    [[params.footer.social]]\n        icon = \"fas fa-envelope\"\n        link = \"mailto:blah@gmail.com\"\n```\n\nThe `quicklinks` section displays a list of links which will be displayed on the footer, an example of adding two links is:\n```toml\n[params.footer]\n    [[params.footer.quicklinks]]\n      text = \"Legal Notice\"\n      link = \"/legal\"\n\n    [[params.footer.quicklinks]]\n      text = \"Credits\"\n      link = \"/credits\"\n```\n\n## Contributing\n\nHave you found a bug or got an idea for a new feature? Feel free to use the [issue tracker](https://github.com/TheYorkshireDev/hugo-zero/issues) to let me know or make a contribution directly with a [pull request](https://github.com/TheYorkshireDev/hugo-zero/pulls).\n\n## License\n\nThis theme is released under the [MIT license](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheyorkshiredev%2Fhugo-bts4","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheyorkshiredev%2Fhugo-bts4","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheyorkshiredev%2Fhugo-bts4/lists"}