How to build with github

1. Foreword

GitHub is one of the most popular open source version control systems that can be used for collaborative development, project management, and code hosting. Sometimes we can also build a personal or team's static website based on GitHub Pages.

This article mainly introduces how to use GitHub to build your own personal or team static website, including specific steps such as creating a GitHub account, creating a warehouse, using Jekyll to generate a website, and binding a domain name.

2. Create a GitHub account

First we need to go to the GitHub official website and register a GitHub account. If you already have a GitHub account, you can skip this step.

After creating a GitHub account, we can choose to create a new warehouse.

3. Create a repository

Click the “New Repository” button on the GitHub homepage.

Enter your website name in the “Repository name” input box, for example “my-awesome-website”.

Next, we need to select the type of warehouse. Since we want to build a static website, select the "Public" type.

Finally click “Create Repository” to complete the creation of the warehouse.

4. Use Jekyll to generate a website

Next, we need to use Jekyll to generate a website. Jekyll is a simple and easy-to-use static website generator, similar to WordPress and other CMS systems, but it does not require support for databases and server-side scripts. Instead, it generates static web pages through Markdown or HTML template languages.

We can clone a Jekyll template, which provides us with the basic website structure and design:

git clone https://github.com/barryclark/jekyll-now.git

After the cloning is completed, we need to copy all the files in this repository to our own in the warehouse. Then create a new file named "_config.yml" in your own warehouse and enter the following content:

title: My Awesome Website
description: A description of my awesome website.

5. Bind the domain name

Now, we have successfully built our own static website, and can view the website by visiting your own warehouse address.

However, we may want to use our own domain name to access the website instead of using GitHub's default domain name. Therefore, in this section, we will explain how to bind your own domain name to GitHub Pages.

1. First, we need to purchase a domain name. There are many domain name registrars to choose from, such as GoDaddy, Namecheap, and others. We can choose to register a domain name with a .com, .net, .org, .co, etc. suffix.
2. Next, find the domain name resolution management page in the domain name registrar's console. Here, we need to add a CNAME record to resolve the domain name to our GitHub Pages repository.

Suppose our domain name is "mydomain.com". So, we need to add a CNAME record to resolve “www.mydomain.com” to our GitHub Pages repository.

3. Next, in our GitHub Pages repository, we need to add a “CNAME” file. Enter the domain name we want to bind in this file, which is "www.mydomain.com".
4. Finally, in the console of the domain name registrar, set the DNS server of the domain name to the GitHub Pages default DNS server:

ns1.p19.dynect.net
ns2.p19.dynect.net
ns3.p19.dynect.net
ns4.p19.dynect.net

5. Wait for a while, and then you can You can view the website you built by accessing your own domain name.

6. Summary

This article mainly introduces how to use GitHub to build your own personal or team static website. We need to first create a GitHub account and create a new repository. We then generated the website by cloning the Jekyll template and adding a file called “_config.yml”. Finally, we also explained how to bind your domain name to GitHub Pages to access your website.

The above is the detailed content of How to build with github. For more information, please follow other related articles on the PHP Chinese website!