Welcome
github-learning-lab opened this issue · 1 comments
Let's build your first webpage
HTML is the markup language that forms the backbone of the internet. In this course, you will learn how to build a clean, stunning webpage using HTML which you can set as your browser's default start page. This is only the first step in your journey, but it will form an important foundation in your journey as a new developer.
What is HTML?
HTML stands for Hyper Text Markup Language. HTML is not a programming language. It is simply a way to describe the structure of your website. Your web browser reads the HTML document and displays it in the window.
Where does your website begin?
When someone enters your web address, the web standards will automatically look for a file called index.html and display it in your browser. Most people call this your home page.
Step 1: Hosting your webpage
It isn't enough to simply create a webpage on GitHub. You must deploy your webpage to a web host that is connected to the internet. For this course we will use GitHub Pages, but you could publish the HTML to any static host.
⌨️ Activity: Turn on GitHub Pages
- Under your repository name, click Settings.
- In the GitHub Pages section, use the Select source drop-down menu to select
main
as your GitHub Pages publishing source. - Return to this issue.
I may take up to a minute to respond as I wait for GitHub Pages to create a deployment of your repository. If you don't see anything after a minute, refresh this page.
For more information, see Configuring a publishing source for GitHub Pages in the GitHub Help.
I'll respond in this issue after GitHub Pages has finished deploying your site.
Step 2: Open a pull request
GitHub Pages is now serving your web page at: https://n-c-m.github.io/intro-html/
It's not very special looking yet, is it? Web hosts (and GitHub Pages) look for a file titled index.html
and serve that up. Since there's no index.html
file in our repository, GitHub Pages displays the contents of the README by default. Let's change this by adding the index.html
file to our repository.
⌨️ Activity: Add index.html
To help you get started, I have already created an index.html
file for you on a branch called: add-index
. All you need to do is create the pull request. Don't worry, I'll help you!
- Create a pull request. You can either use this direct link, or go to the Code tab, click on New Pull Request, select base: main, and compare: add-index.
- Add a descriptive title to your pull request, something like "Add the index.html file".
- Add a descriptive body to your pull request.
- Click Create pull request.