#Github pages how to

You will see that the GitHub Pages settings are currently disabled. On the menu on the left hand side, click on Pages The default branch automatically created with a new github repository is called main.Ĭlick on the repository’s Settings tab (the one with the little cog/gear icon) as shown on the figure below: A branch is one version of your project (the files in your repository) that can contain its own set of commits - you can have many branches (versions) of your repository. You may have never heard about Git branches and wonder what they are. We now need to tell GitHub Pages that this branch contains our website files. You may have noticed that when we created our repository in previous episode, by default GitHub created a branch called main and stored our files there. You can do so from your repository’s Settings page, as explained below. In order to tell GitHub that your repository contains a website that needs rendering you need to configure GitHub Pages settings. One important file you should already have is README.md, which will become the homepage of your project website (until we add the index file later on). Let’s continue from the GitHub repository we have created in the previous episode. GitLab offers very similar services but GitHub pages is the simplest approach. This is particularly helpful for collaborating on a project website.

There are other services available to create and publish websites but one of the main advantages of GitHub Pages is that you can version control your website and therefore keep track of all your changes. Optionally runs the files through a build process, combines them and publishes them as a website.Īny changes you do to the files in your website’s GitHub repository

Hosting service by GitHub that takes files (Markdown, HTML, CSS, JavaScript, etc.)įrom your GitHub repository which is configured as a website,

Service just for that called GitHub Pages.

#Github pages how to

Now that you know how to create Markdown files, let’s see how to turn them into Web pages. Publish Markdown files as HTML on the Web with GitHub Pages