A Bootstrap 4 start up project for Github Pages and Jekyll.
Go to this repository page on Github and click the Fork button on the top right of the page.
Here we have two possibilities:
You want a user or organization website
In this case your website’s URL will be http://<your username>.github.io where <your username> is your Github user name.
Go in the Settings page of your repository and rename it to <your username>.github.io.
You want a project website
In this case your website’s URL will be http://<your username>.github.io/<whatever you want> where <whatever you want> can be any valid name for a Github repository.
Go in the Settings page of your repository and rename it to <whatever you want>.
Go in the Settings page of your repository, in the Github Pages, under the Source parameter, choose master branch then Save.
Your Github Pages website with customizable Bootstrap 4 is now up and running, you can access it using the URL displayed by Github in the Github Pages settings.
You should at least edit the _config.yml file to edit your website’s metadata, like the title, description and repository URL.
This website uses the Minty Bootstrap theme by default. And you don’t want to use the same theme everyone else uses do you?
You can of course modify anything in the _includes, _layouts and _sass folders to customize both the HTML or CSS of your website, possibly referring to the Bootstrap documentation or the Jekyll documentation when needed. This is a normal part of web development and it is outside the scope of this guide.
But if you don’t know where to start I can recommend you to import a theme from Bootswatch.
_variables.scss and _bootswatch.scss files._variables.scss in _sass/_variables.scss._bootswatch.scss in _sass/_bootstrap_customization.scss.That’s it, you now have a totally different appearance for you website.
You probably don’t want the present guide to be the front page of your website, so you should edit the index.md file. You probably also want to edit or delete the CONTRIBUTING.md, README.md and LICENSE.md files.
Aside from that you can of course create new pages and posts like with any Jekyll website by refering to the Jekyll documentation.
Editing your website’s content or theme directly on Github is completely possible but, due to the time Github Pages takes to update your website, it will probably be much more effective to work using a local Jekyll installation.
To do so:
bundle install at the root of your project to install the necessary Ruby dependencies.bundle exec jekyll serve to launch the test Jekyll web server that will re-compile your work if you edit it.http://localhost:4000 in your web browser to see your work-in-progress website.Please note that, to ensure maximum compatibility with Github Pages, the Gemfile of this project references the github-pages gem, not Jekyll directly. This implies some differences in behavior compared to the official documentation of Jekyll.
Easy Markdown to Github Pages which documents how to publish Markown files to Github Pages in the fastest way.