{"id":14972385,"url":"https://github.com/carlesloriente/bootstrap-theme-jekyll","last_synced_at":"2025-10-26T19:30:23.079Z","repository":{"id":223693444,"uuid":"761267599","full_name":"carlesloriente/bootstrap-theme-jekyll","owner":"carlesloriente","description":"NOCC Jekyll Bundle. A fully featured bundle site for Jekyll created by Carles Loriente. Features a homepage, about page, tags cloud page, gallery of images page, examples post pages with comments powered by Disqus and a contact form powered by Formspree. Using the NOCC Bootstrap theme npm package.","archived":false,"fork":false,"pushed_at":"2025-01-31T08:51:11.000Z","size":20013,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-31T09:30:34.103Z","etag":null,"topics":["bootstrap","bootstrap-5","bootstrap-theme","bootstrap5","github-pages","jekyll","jekyll-plugin","jekyll-theme"],"latest_commit_sha":null,"homepage":"https://bootstrap-theme.notesoncloudcomputing.com/","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/carlesloriente.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["carlesloriente"],"ko_fi":"carlesloriente"}},"created_at":"2024-02-21T14:54:54.000Z","updated_at":"2025-01-18T23:04:04.000Z","dependencies_parsed_at":"2025-01-31T09:26:45.703Z","dependency_job_id":"47d88628-d5b3-43a6-b3d9-4423a7ddb3e0","html_url":"https://github.com/carlesloriente/bootstrap-theme-jekyll","commit_stats":{"total_commits":34,"total_committers":2,"mean_commits":17.0,"dds":"0.11764705882352944","last_synced_commit":"f09cf1ed780cdf8ec9cbe9c2f39c72577a669451"},"previous_names":["carlesloriente/bootstrap-theme-jekyll"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlesloriente%2Fbootstrap-theme-jekyll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlesloriente%2Fbootstrap-theme-jekyll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlesloriente%2Fbootstrap-theme-jekyll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlesloriente%2Fbootstrap-theme-jekyll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/carlesloriente","download_url":"https://codeload.github.com/carlesloriente/bootstrap-theme-jekyll/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238386182,"owners_count":19463312,"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":["bootstrap","bootstrap-5","bootstrap-theme","bootstrap5","github-pages","jekyll","jekyll-plugin","jekyll-theme"],"created_at":"2024-09-24T13:46:50.364Z","updated_at":"2025-10-26T19:30:22.230Z","avatar_url":"https://github.com/carlesloriente.png","language":"HTML","funding_links":["https://github.com/sponsors/carlesloriente","https://ko-fi.com/carlesloriente"],"categories":[],"sub_categories":[],"readme":"# NOCC Jekyll Bundle\n\n![NOCC Jekyll Bundle webshots](/assets/images/nocc-showcase.webp)\n\n[NOCC Jekyll Bundle](https://bootstrap-theme.notesoncloudcomputing.com/). A fully featured bundle site for [Jekyll](https://jekyllrb.com/) created by [Carles Loriente](https://github.com/carlesloriente).\nFeatures a homepage, about page, tags cloud page, gallery of images page, examples post pages with comments powered by [Disqus](https://disqus.com/) and a contact form powered by [Formspree](https://formspree.io/).\nUsing the [NOCC Bootstrap theme](https://www.npmjs.com/package/nocc-bootstrap-theme) npm package.\n\n## Table of contents\n\n- [NOCC Jekyll Bundle](#nocc-jekyll-bundle)\n  - [Table of contents](#table-of-contents)\n  - [Features](#features)\n  - [Installation](#installation)\n    - [Configuration](#configuration)\n    - [Add your content](#add-your-content)\n    - [Setup local environment](#setup-local-environment)\n      - [Use HTTPS](#use-https)\n    - [Host your site](#host-your-site)\n      - [in GitHub-Pages](#in-github-pages)\n      - [in Amazon S3 bucket](#in-amazon-s3-bucket)\n  - [Bugs and Issues](#bugs-and-issues)\n  - [Contributing](#contributing)\n  - [Creator](#creator)\n  - [Thanks](#thanks)\n  - [Copyright and License](#copyright-and-license)\n\n## Features\n\n1. **A complete website ready to roll out**\n2. **It uses a theme build for Bootstrap 5**\n3. **Local and remote environments built-in**\n4. **Extensive use of SVG and WeBP**\n5. **Static site with dynamic features**\n\n## Installation\n\nJust follow the instructions below, and then you can change the content of the pages and site settings.\n\n- [Download the package](https://github.com/carlesloriente/bootstrap-theme-jekyll/archive/refs/heads/main.zip) or clone the project running the command:\n\n```bash\n   git clone --recursive git@github.com:carlesloriente/bootstrap-theme-jekyll.git\n```\n\n- Install the NOCC npm package, run the command:\n\n```bash\n  npm install nocc-bootstrap-theme --save\n```\n\n- Install Ruby Gems and other dependencies, run the command:\n\n```bash\n  sh bin/install.sh\n```\n\n### Configuration\n\n1. Update with your settings the configuration file `_config.yml`:\n   - `landing` (Setting for the theme landing site, please set to `false`)\n   - `title`\n   - `author`\n   - `url`\n   - `timezone`\n   - `description`\n   - `full_description` (Setting for the theme landing site, please set to `false`)\n   - `gh_repository` (Optional; if not needed, comment it out)\n   - `email` (Set to a working email address, and then if you want to enable the contact form, create a free account at [Formspree](https://formspree.io))\n   - `formemail` (fill in with your Formspree code; after that, fill out and send the form on the contact page, check your email and verify if you are receiving the messages)\n   - `twitter_username` (Optional; if not needed, comment it out)\n   - `github_username` (Optional; if not needed, comment it out)\n   - `facebook_username` (Optional; if not needed, comment it out)\n   - `instagram_username` (Optional; if not needed, comment it out)\n   - `linkedin_username` (Optional; if not needed, comment it out)\n   - `kofi` (Optional; if not needed, comment it out)\n   - `google_site_verification` (Optional; if not needed, comment it out)\n   - `google_analytics` (Optional; if not needed, comment it out)\n   - `disqus_shortname` (To enable the comments feature, create a free account at [Disqus](https://disqus.com), and fill in with your Disqus shortname, if not needed; comment it out)\n\n### Add your content\n\nYou need to create new posts/articles inside the folder named `_posts`. The files should be in markdown format. Use one of the sample files to learn more about the syntax and [Front Matter](https://jekyllrb.com/docs/front-matter/) settings. Remove the unwanted files.\n\n\u003e **\u0026#9940;** Posts should be named YEAR-MONTH-DAY-title.MARKUP (Note the MARKUP extension, which is usually .md or .markdown).\n\n### Setup local environment\n\nUse the Jekyll build and web server command `bundle exec jekyll serve` or set up the local development environment (*recommended*).\n\n#### Use HTTPS\n\nSuppose you want to use HTTPS in your environment and eliminate browser warnings when developing. In that case, the bundle comes with handy pre-generated certs.\n\nNavigate to folder `bin/certs` and execute the following command to validate certs and update the CA trust DB.\n\n```bash\n  openssl verify -CAfile ca_selfsigned.crt wildcard.local.crt \u0026\u0026 sudo cp ca_selfsigned.crt /etc/pki/ca-trust/source/anchors/ \u0026\u0026 sudo update-ca-trust\n```\n\n- Modify your /etc/hosts file adding `127.0.0.1 bootstrap-theme.local`. Depending on your setup, there will already be an entry for 127.0.0.1; add bootstrap-theme.local after the last argument.\n- Execute the command `sh bin/build-local.sh`, which will build the site files, launch the Webrick web server using the `_site_local` folder as webroot, and open your browser.\n- For the first time only, you must make your browser trust the wildcard domain cert.\n  - Mozilla Firefox: After opening the URL `https://bootstrap-theme.local:8000`, the message \"Warning: Potential Security Risk Ahead\" is shown; click the `Advanced` button and then `Accept Risk \u0026 Continue`.\n\n\u003e **\u0026#9432;** Check this gist to create your own CA and wildcard cert.\n\n### Host your site\n\n#### in GitHub-Pages\n\nYou can host your site using GitHub Pages. Follow the [official guide](https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site).\n\n\u003e **\u0026#9432;** GitHub Pages hosting is free; you need an account and repository.\n\n#### in Amazon S3 bucket\n\nYou can host the site using an S3 Bucket; please follow the [AWS guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html).\n\n## Bugs and Issues\n\nHave a bug or an issue with this template? [Open a new issue](https://github.com/carlesloriente/bootstrap-theme-jekyll/issues) here on GitHub!\n\n## Contributing\n\nNew contributors are always welcome! Check out [CONTRIBUTING.md](https://github.com/carlesloriente/bootstrap-theme-jekyll/blob/main/CONTRIBUTING.md) to get involved.\n\n## Creator\n\n**[Carles Loriente](https://www.linkedin.com/in/carles-loriente/)** is the creator and maintainer of the NOCC Bootstrap theme.\n\n- [Linkedin](https://www.linkedin.com/in/carles-loriente)\n- [Twitter](https://twitter.com/godarthvader)\n- [GitHub](https://github.com/carlesloriente)\n\n## Thanks\n\n[Bootstrap 5](https://getbootstrap.com/) framework created by [Mark Otto](https://twitter.com/mdo) and [Jacob Thorton](https://twitter.com/fat).\n\n## Copyright and License\n\nCopyright (c) 2024 Carles Loriente. The code released under the [MIT](https://github.com/carlesloriente/bootstrap-theme-jekyll/blob/main/LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlesloriente%2Fbootstrap-theme-jekyll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarlesloriente%2Fbootstrap-theme-jekyll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlesloriente%2Fbootstrap-theme-jekyll/lists"}