Create a GitHub technology blog full guide

Source: Internet
Author: User

description : First, you need to register a github account, it is best to take a meaningful name, such as full spelling, nickname all spell, if occupied, you can add meaningful numbers.
This article assumes that the user name is tiemaocsdn

1. Register your account:

Address: https://github.com/
Enter your account, email, password, and then click the Register button.

Figure 1 Step 1th

2. Initial Setup
After the registration is complete , select Free account to complete the setup.

Figure 2 Step 2nd

2.1 Verifying mailboxes
Please open your e-mail address to view the confirmation email sent to you, you need to verify the mailbox, the subsequent generation of the personal page will be accepted and published.

3. Create a page warehouse
Address: Https://github.com/new
The name of the warehouse needs to correspond to your account, such as Tiemaocsdn.github.io
Enter basic information, then click Create Warehouse.

Figure 3 Step 3rd

4. Go to the Project Settings page
Because this project is dedicated to put the page, so the master branch can be. If you have a warehouse page that you need to set up in the gh-pages Branch, refer to the resources mentioned at the end of this article for more information.

Figure 4 Step 4th


5. Go to the automatic page builder
In the Settings page, drop down to the bottom, the default branch (master) is not in the tube.

Figure 5 Step 5th


6.1 Creating user pages (i.e. Technology blog site)
Enter some content, you can edit it yourself, or you can load it from the Readme:

Figure 6-1 第6-1 Step


6.2 Continue, select theme

Figure 6-2 第6-2 Step


7. Select a theme, then publish
As shown, in fact these later you can modify the replacement yourself, this just generates some css,html,img into your warehouse inside.

Figure 7 Step 7th


8. View Effects
Now you can access your home page on your Github.io, for example:
http://tiemaocsdn.github.io/
The page effect looks like this:

Figure 8 Step 8th

9. CNAME binding domain Name

To this step, in fact, it is very clear, http://tiemaocsdn.github.io/such a domain name, it points to the site/page just built. If this domain name is too dirt to do?

Actually very good to do, spend money to buy a favorite domain name mapping past just fine. Create a file under the root path, the filename is the uppercase "CNAME", note that there is no suffix. Because tiemaocsdn didn't buy a domain name, take another.

This is similar to the following:

Https://github.com/renfufei/renfufei.github.io/blob/master/CNAME

Inside the content, is to visit this Xxx.github.io will redirect to this domain name, so in fact this address can be any value. But to make sense, we can define a fixed domain name, for example:

Blog.cncounter.com

The content of the file is only one line, so when accessing Http://renfufei.github.io, the browser receives the redirect instruction and jumps to the domain name specified in the CNAME.

The approximate response header and status code are as follows, you can also use Chrome to open the network, tick the Preserve log to keep the log to see the relevant information:

Request url:http://renfufei.github.io/request method:getstatus code:301 Moved permanentlylocation:http:// Blog.cncounter.com/server:github.com

This is clear, when visiting this site, if the domain name is not blog.cncounter.com, then will jump to http://blog.cncounter.com/, personal malicious speculation, even if you set the content of the CNAME file to Www.baidu.com is also feasible, so that when the visit to the direct jump to Baidu.
But what if http://blog.cncounter.com/is empty? That's all you need to promise yourself.

Of course, if this is the end, then this article is a piece of paper.
If you hold this domain name, you can also cname the corresponding record of the domain name to "Renfufei.github.io". Remember, Renfufei.github.io is already an address that can be explicitly located on the Internet, so DNS records can be mapped to this path entirely.

For example, the following record, in DNS, a record that is directly specifying an IP. The CNAME is renamed, pointing to another domain name. Host record is a prefix, for example: blog, and cncounter.com stitching together is blog.cncounter.com, if you want to map www.cncounter.com , then the host record is www , the record type is CNAME, the record value is Renfufei.github.io, if you want to map http://cncounter.com this root domain name also, then the record type is a CNAME, the host record is an English at: "@". You can map multiple domain names to your own site such as Xxxxx.github.io, but in principle you will jump to the domain name in your new CNAME file. "Rest assured that the cycle will not die ... ". All right, congratulations!

10. The Warehouse page

Once you've created a personal or an organization's GitHub home page, you have a fixed two-level domain name.

Then, each project can use Page Builder to generate a page for a project. Of course, the pages used in the project are not the master branch, but a branch called gh-pages . GH is the abbreviation for GitHub and GitHub automatically parses the page below.

The corresponding access path is similar to http://xxx.github.io/project-name/. Example: http://blog.cncounter.com/cncounter/

The corresponding branches are: https://github.com/cncounter/cncounter/tree/gh-pages

Interested you can take a look at it, the way it is generated is basically the same as above. Of course, GitHub is now revised, the new version of the layout, Settings was moved to the top, but the basic operation is still unchanged.

Precautions:

    • If you are reporting 404, or any other error, please wait a moment, or check your email to see if the build failed.
    • For example, because I did not verify the mailbox initially, I received several notifications of failed releases (such as the following MailTips).
    • Each time you submit (or submit an online change) file to this repository, GitHub will automatically build and publish it for you.
    • So, there is a problem, please modify and submit a file, try it again!
The page build failed with the following error:you need a verified email address in your GitHub account to publish Pages.y ou can verify your email addresses from your Settings panel:    https://github.com/settings/emailsIf all Questio NS Please contact us at https://github.com/contact.


The following is part of the reference:

You can quickly create a Web site for projects, users (such as your account), or organizations (Organization, such as Alibaba), via GitHub's page auto generator, which is actually a technical blog.

Generate Web pages for users/organizations

To generate a user/organization Site page, you need to create a warehouse (repository, code base), named: Username.github.io or Orgname.github.io; The user name or organization name must be your own account/or the organization to which it belongs, Otherwise, the GitHub Pages site will not build (build, build, compile) for you. GitHub's page Auto generator can be seen through the Warehouse Settings page (Settings page). You can read more about the user and organization pages.

warning : The GitHub page site is public on the Internet, even if the repository it belongs to is private. If you have sensitive data in the page repository, you may need to remove them before publishing.

Reference Address :

    • Categories/github Pages Basics
    • User, Organization, and Project Pages
    • Creating Pages with the automatic generator

If you see this here, if you are logged in and if you feel helpful, please click on the "Top" button below.

If there is a problem, there are suggestions, please leave a message.

Give it a try!

Github.io Technology Blog Benefits : Blogging, you can define your own js,css, images, embed iframe display code examples, what you can customize, what tags are allowed, and in other technical blog sites, because of security restrictions, many are not allowed.

If you are interested in learning about git and using this powerful tool and project/code management idea, then it is recommended that you read this series of articles, speaking in a clear, lively and interesting: http://www.worldhello.net/gotgithub/01- Explore-github/010-what-is-github.html

Getting Started with git in Windows:

      1. Directory
      2. Installing and configuring Git
      3. Installation and Configuration Tortoisegit
      4. Git and tortoisegit basic operations
      5. markdown Example
      6. Solve the tortoisegit strange bad file number problem
      7. Join QQ Group GitHub home: 225932282

Create a GitHub technology blog full guide

Contact Us

The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.