{"id":15287919,"url":"https://github.com/alanorth/hugo-theme-bootstrap4-blog","last_synced_at":"2025-04-09T05:12:32.804Z","repository":{"id":55872060,"uuid":"66769421","full_name":"alanorth/hugo-theme-bootstrap4-blog","owner":"alanorth","description":"A blogging-centric Bootstrap v4 theme for the Hugo static site generator.","archived":false,"fork":false,"pushed_at":"2024-09-17T04:00:39.000Z","size":4463,"stargazers_count":207,"open_issues_count":7,"forks_count":134,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-02T04:05:11.839Z","etag":null,"topics":["blog-theme","bootstrap","hugo","hugo-theme","i18n","responsive-design","rtl","theme"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alanorth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","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":"2016-08-28T13:23:53.000Z","updated_at":"2025-03-02T07:48:30.000Z","dependencies_parsed_at":"2024-10-14T18:41:09.866Z","dependency_job_id":null,"html_url":"https://github.com/alanorth/hugo-theme-bootstrap4-blog","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanorth%2Fhugo-theme-bootstrap4-blog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanorth%2Fhugo-theme-bootstrap4-blog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanorth%2Fhugo-theme-bootstrap4-blog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanorth%2Fhugo-theme-bootstrap4-blog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alanorth","download_url":"https://codeload.github.com/alanorth/hugo-theme-bootstrap4-blog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247980844,"owners_count":21027808,"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":["blog-theme","bootstrap","hugo","hugo-theme","i18n","responsive-design","rtl","theme"],"created_at":"2024-09-30T15:39:34.858Z","updated_at":"2025-04-09T05:12:32.776Z","avatar_url":"https://github.com/alanorth.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hugo Bootstrap v4 Blog [![Build Status](https://ci.mjanja.ch/api/badges/alanorth/hugo-theme-bootstrap4-blog/status.svg)](https://ci.mjanja.ch/alanorth/hugo-theme-bootstrap4-blog) [![builds.sr.ht status](https://builds.sr.ht/~alanorth/hugo-theme-bootstrap4-blog.svg)](https://builds.sr.ht/~alanorth/hugo-theme-bootstrap4-blog?)\nA simple but opinionated [Hugo](https://gohugo.io) theme geared towards blog-style content. Based on the older two-column [Bootstrap blog example](https://v4-alpha.getbootstrap.com/examples/blog/) that was used for several Bootstrap versions, but has now been retired in favor of a \"snarky\" (their words) new example as of version [4.0.0's final release](https://blog.getbootstrap.com/2018/01/18/bootstrap-4/).\n\n![Screenshot](https://raw.githubusercontent.com/alanorth/hugo-theme-bootstrap4-blog/master/screenshot.png \"Screenshot\")\n\nSee [picturingjordan.com](https://picturingjordan.com) for an example of this theme in use.\n\n## Features\n\n- Responsive design\n- Uses Bootstrap v4's [native system font stack](https://getbootstrap.com/docs/4.0/content/reboot/#native-font-stack) to load quickly and look good on all platforms\n- Excellent [structured data](https://developers.google.com/search/docs/guides/intro-structured-data) (JSON-LD), [OpenGraph](http://ogp.me), and [Twitter Card](https://dev.twitter.com/cards/types) metadata support\n- robots.txt linking to XML sitemap (disabled by default, see [Hugo docs](https://gohugo.io/extras/robots-txt/))\n- Basic support for [multi-lingual content](https://gohugo.io/content-management/multilingual/) (added in Hugo 0.17) and user interface translation (i18n), including RTL languages like Arabic and Farsi\n- Supports Google, Bing, and Yandex site verification via meta tags\n- Supports GDPR-compliant Google Analytics (script is not even loaded until *after* the user agrees) with configurable consent banner, see [`exampleSite/config.toml`](https://github.com/alanorth/hugo-theme-bootstrap4-blog/blob/master/exampleSite/config.toml)\n- Supports Disqus comments, see [Hugo docs](https://gohugo.io/extras/comments/)\n- Allow addition of custom `\u003chead\u003e` code in site's `layouts/partials/head-custom.html` (see [#17](https://github.com/alanorth/hugo-theme-bootstrap4-blog/pull/17))\n- Configurable display of summaries of content in list templates.\n- Configurable keywords for every post\n- Supports automatic generation of `\u003cimg\u003e` srcsets for images in [page bundles](https://gohugo.io/content-management/page-bundles/) using a [new figure shortcode](https://cpbotha.net/2020/05/02/drop-in-replacement-for-hugo-figure-shortcode-with-responsive-img-srcset/) (falls back to default Hugo behavior of looking up images in the static directory)\n\n## Usage\nClone the repository to your site's `themes` directory. Refer to [`exampleSite/config.toml`](https://github.com/alanorth/hugo-theme-bootstrap4-blog/blob/master/exampleSite/config.toml) for recommended configuration values.\n\n## Content Suggestions\nA few suggestions to help you get a good looking site quickly:\n\n- Keep blog posts in the `content/posts` directory, for example: `content/posts/my-first-post.md`\n- Keep static pages in the `content` directory, for example: `content/about.md`\n- Keep media like images in the `static` directory, for example: `static/2016/10/screenshot.png`\n- If you want an image to be shown when you share a post on social media, specify at least one image in the post's front matter, for example: `images: [\"/2016/10/screenshot.png\"]`\n- Use the `\u003c!--more--\u003e` tag in posts to control how much of a post is shown on summary pages\n- Disable comments on a post by setting `comments = false` in its frontmatter\n- Disable social sharing icons site wide (or on individual pages/posts) by setting `sharingicons = false`\n- If your content is stored in git, add `enableGitInfo = true` to your site config and Hugo will use git history to set a more accurate modification date in page metadata\n\nSee the source code and structure of [picturingjordan.com](https://github.com/alanorth/picturingjordan.com) to get more ideas.\n\n## Building (For Developers)\nThis theme uses the [Bootstrap](https://getbootstrap.com/) framework. A static version of this is already included, but if you want to bump the version, tweak the style, etc, you'll need to rebuild the assets. Make sure you have Node.js \u003e= v14 installed, and then run the following from inside the theme's directory:\n\n```console\n$ npm install\n$ npm run build\n```\n\n## Contributing\nThere are several ways to help with the development of the theme:\n\n- [Open an issue](https://github.com/alanorth/hugo-theme-bootstrap4-blog/issues/new) on GitHub if you have problems or feature requests\n- Alternatively, tackle one of the [existing issues](https://github.com/alanorth/hugo-theme-bootstrap4-blog/issues) on the issue tracker\n- Fork [the repository](https://github.com/alanorth/hugo-theme-bootstrap4-blog) on GitHub, add features on a \"feature\" branch like `update-bootstrap`, and then send a [pull request](https://github.com/alanorth/hugo-theme-bootstrap4-blog/compare) with your changes\n\n## License\nThis repository contains SASS and HTML code from the [Bootstrap](https://getbootstrap.com) project, which is licensed under the [MIT license](https://tldrlegal.com/license/mit-license) and [CC BY 3.0](https://creativecommons.org/licenses/by/3.0/), and [Font Awesome](https://fontawesome.com/), which uses [various licenses](https://fontawesome.com/license/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanorth%2Fhugo-theme-bootstrap4-blog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falanorth%2Fhugo-theme-bootstrap4-blog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanorth%2Fhugo-theme-bootstrap4-blog/lists"}