Skip to content

davehorsfall/jekyll-startbootstrap-agency

Repository files navigation

Jekyllised - Start Bootstrap Agency

deploy license demo

Agency is one of the most popular HTML themes offered by Start Bootstrap. I have Jekyllised this theme to give web developers and hobbyists a simple and clean implimentation in Jekyll for starting new projects. This template is free and open source, released under the MIT license.

Description

Agency is a HTML/CSS theme built with Bootstrap 5. This theme is perfect for agencies or small businesses looking to set up a simple website for their company. The theme can also be modified and adjusted to fit just about any purpose!

Agency Features

  • Responsive top navigation that collapses and restyled when the page is scrolled
  • Smooth scrolling navigation to optimize the one page website user experience
  • Integration with Font Awesome Icons
  • Portfolio grid with modal windows for each item to showcase more detailed content for each portfolio item
  • About section with a responsive timeline
  • Team member section with profile images and social media links
  • Footer with social links, copyright information, and additional page links
  • SCSS and Pug files included in the source files on GitHub for deeper customization and development

Jekyllised

  • The Agency HTML template has been natively integrated with the Jekyll framework
  • Works with Ruby 2 and 3
  • Portfolio collection - just add new Markdown files to add new portfolio items
  • Team collection - just add new Markdown files to add new team members

Getting Started (i.e. setting up things on your own computer)

Requirements

  • You will need Ruby to use Jekyll. Follow the guides on the Jekyll website to install the requiremtns for your operating system.
  • You will need Git installed to deploy your website to Github Pages. Follow the guide on the Github website to set setup.

Installation

  1. Create your own copy by forking the repositry. Click here to start a new fork. Afterwards, you will have your own version of the template under your Github username.

create-fork forked-repo

  1. Clone your forked repositry. Replace [USERNAME] with your own Github username:
$ git clone git@github.com:[USERNAME]/jekyll-startbootstrap-agency.git
  1. Change directory into the template:
$ cd jekyll-startbootstrap-agency
  1. Install the dependancies in the Gemfile:
$ bundle install 
  1. Start the development server to serve the Jekyll website:
$ bundle exec jekyll serve

The Jekyll website should now be avaliable for you view in your browser. The default location is http://127.0.0.1:4000/.

Deploymemt (i.e. publishing your website online for free using Github Pages)

You can deploy your website for free using features of Github called Pages and Actions. Follow the instructions below to deploy your forked copy of the template.

  1. In your forked copy of the repo, go to the Settings tab at the top, then click the Pages link on the left. Here, we see the options for hosting content from your repo. For the Source option, make sure Deploy from a branch is selected. Then for the Branch option, select the main branch, as shown in the screenshot below.

github-pages-setup

  1. After you make these changes, Github Pages will be setup. By default, an Action called pages build and deployment will be run. You can view this under the Actions tab. However, this default Action will not build the website correctly. On the Actions tab, select the deploy action on the left, and then select Run Workflow and click on the Run Workflow button. See screenshots below for clarification.

github-actions-default-thumb create-fork create-fork

  1. If everything has worked correctly, you will see your deploy Action is run successfully.

github-actions-deploy-success

  1. After the deploy Action has successfully complete, you can return to the Pages link, to see a confirmation that your Jekyll website is live, along with a link to the website. You can make furhter changes to your Github Pages setup. For example, enforce HTTPS, or setup a custom domain. See the Pages documentation for more details.

github-pages-deploy