Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/carlesloriente/carlesloriente.github.io

The notesoncloudcomputing.com website, created with Jekyll, using the NOCC Bootstrap Theme and hosted on GitHub pages. This repository contains all the website's files.
https://github.com/carlesloriente/carlesloriente.github.io

bootstrap cloud-computing github-pages jekyll notes website

Last synced: 22 days ago
JSON representation

The notesoncloudcomputing.com website, created with Jekyll, using the NOCC Bootstrap Theme and hosted on GitHub pages. This repository contains all the website's files.

Host: GitHub
URL: https://github.com/carlesloriente/carlesloriente.github.io
Owner: carlesloriente
License: mit
Created: 2019-09-13T15:06:03.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2024-05-30T09:18:00.000Z (6 months ago)
Last Synced: 2024-10-12T06:52:30.225Z (about 1 month ago)
Topics: bootstrap, cloud-computing, github-pages, jekyll, notes, website
Language: HTML
Homepage: https://www.notesoncloudcomputing.com/
Size: 106 MB
Stars: 5
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: CODEOWNERS
- Security: SECURITY.md

Awesome Lists containing this project

README

        # Let's make this project even better for everyone. Sponsorship fuels new features! 🎉

[![Become a sponsor today](https://img.shields.io/static/v1?label=Become a sponsor today&message=❤&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/carlesloriente/sponsorships?sponsor=carlesloriente&preview=true&frequency=recurring&amount=5)

## Help me raise these numbers

[![Stars](https://img.shields.io/github/stars/carlesloriente/carlesloriente.github.io?style=social)](https://github.com/carlesloriente/carlesloriente.github.io/stargazers)

[![Followers](https://img.shields.io/github/followers/carlesloriente.svg?style=social)](https://github.com/carlesloriente)

[![Sponsors](https://img.shields.io/github/sponsors/carlesloriente?style=social)](https://github.com/sponsors/carlesloriente)

Enjoy! 😃

---

## NOCC Jekyll Bundle

![NOCC Jekyll Bundle webshots](/assets/images/nocc-theme-showroom.png)

[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).

Features 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/).

Using the [NOCC Bootstrap theme](https://www.npmjs.com/package/nocc-bootstrap-theme) npm package.

## Features

1. **A complete website ready to roll out**

2. **It uses a theme build for Bootstrap 5**

3. **Local and remote environments built-in**

4. **Extensive use of SVG and WeBP**

5. **Static site with dynamic features**

## How it works

## Installation & Configuration

Just follow the instructions below, and then you can change the content of the pages and site settings.

1. [Download the package](https://github.com/carlesloriente/bootstrap-theme-jekyll/archive/refs/heads/main.zip) or clone the project running the command:

```bash

   git clone --recursive [email protected]:carlesloriente/bootstrap-theme-jekyll.git

```

2. Install the NOCC npm package, run the command:

```bash

  npm install nocc-bootstrap-theme --save

```

3. Install Ruby Gems and other dependencies, run the command:

```bash

  sh bin/install.sh

```

1. Update with your settings the configuration file `_config.yml`:

   - `landing` (Setting for the theme landing site, please set to `false`)

   - `title`

   - `author`

   - `url`

   - `timezone`

   - `description`

   - `full_description` (Setting for the theme landing site, please set to `false`)

   - `gh_repository` (Optional; if not needed, comment it out)

   - `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))

   - `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)

   - `twitter_username` (Optional; if not needed, comment it out)

   - `github_username` (Optional; if not needed, comment it out)

   - `facebook_username` (Optional; if not needed, comment it out)

   - `instagram_username` (Optional; if not needed, comment it out)

   - `linkedin_username` (Optional; if not needed, comment it out)

   - `kofi` (Optional; if not needed, comment it out)

   - `google_site_verification` (Optional; if not needed, comment it out)

   - `google_analytics` (Optional; if not needed, comment it out)

   - `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)

### Add your content

You 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.

> **⛔** Posts should be named YEAR-MONTH-DAY-title.MARKUP (Note the MARKUP extension, which is usually .md or .markdown).

### Test your site locally

Use the Jekyll build and web server command `bundle exec jekyll serve` or set up the local development environment (*recommended*).

#### Configure local environment

Suppose 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.

Navigate to folder `bin/certs` and execute the following command to validate certs and update the CA trust DB.

```bash

openssl verify -CAfile ca_selfsigned.crt wildcard.local.crt && sudo cp ca_selfsigned.crt /etc/pki/ca-trust/source/anchors/ && sudo update-ca-trust

```

- 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.

- 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.

- For the first time only, you must make your browser trust the wildcard domain cert.

  - 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 & Continue`.

> **ⓘ** Check this gist to create your own CA and wildcard cert.

### Host your site

#### in GitHub-Pages

You 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).

> **ⓘ** GitHub Pages hosting is free; you need an account and repository.

#### in Amazon S3 bucket

You can host the site using an S3 Bucket; please follow the [AWS guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html).

## Bugs and Issues

Have a bug or an issue with this template? [Open a new issue](https://github.com/carlesloriente/bootstrap-theme-jekyll/issues) here on GitHub!

## Contributing

New contributors are always welcome! Check out [CONTRIBUTING.md](https://github.com/carlesloriente/bootstrap-theme-jekyll/blob/main/CONTRIBUTING.md) to get involved.

## About

**[Carles Loriente](https://www.linkedin.com/in/carles-loriente/)** is the creator and maintainer of the NOCC Jekyll Bundle and the NOCC Bootstrap theme.

- [Linkedin](https://www.linkedin.com/in/carles-loriente)

- [Twitter](https://twitter.com/godarthvader)

- [GitHub](https://github.com/carlesloriente)

[Bootstrap 5](https://getbootstrap.com/) framework created by [Mark Otto](https://twitter.com/mdo) and [Jacob Thorton](https://twitter.com/fat).

## Copyright and License

Copyright (c) 2024 Carles Loriente. The code released under the [MIT](https://github.com/carlesloriente/bootstrap-theme-jekyll/blob/main/LICENSE) license.