Getting Started with GitHub
Opened this issue · 3 comments
Welcome to your repository!
In this repository 📖, you’ll learn how to write with Markdown 📖, a simple and widely used markup language for formatting text. Here, you’ll start building a static webpage for your customized portfolio.
What is Markdown?
Markdown is a lightweight syntax for writing all types of communication on GitHub, as well as many other places on the web. You can format words as bold or italic, add images, and create lists. Mostly, Markdown is just regular text combined with a few non-alphabetic symbols, such as #
or *
. You can use Markdown with the formatting toolbar in issues đź“– and pull requests đź“–, or you can learn the syntax and type it yourself.
You can use Markdown most places around GitHub:
- Comments in issues and pull requests (like this one!)
- Files with the
.md
or.markdown
extension - Sharing snippets of text in Gists
For more information, see “Writing on GitHub” in the GitHub Help.
Let's get started!
Step 1: Create a Task List
A task list creates checkboxes that can be checked off by people with access đź“– in a repository. They're very useful for tracking issues and pull requests.
If you include a task list in the first comment of an issue or pull request, you'll see a progress indicator in your issue list.
Watch out! The syntax for task lists is very specific. Be sure to include the spaces where required, or else they won't render properly.
Example markup
- [x] Additional markup is supported, including @mentions, #referencess, [links](url), **emphasis**, and <del>HTML tags</del>.
- [x] List syntax is required.
- You can nest lists below, too!
- [x] This item is completed.
- [ ] This item is not complete.
Rendered
- Additional markup is supported, including @mentions, #referencess, links, emphasis, and
HTML tags. - List syntax is required.
- You can nest lists below, too!
- This item is completed.
- This item is not complete.
⌨️ Activity: Add a comment
-
Add a comment to this issue, using Markdown to create a list of items to complete. Your task can include any tasks you wish, or you can use this example:
- [ ] Turn on GitHub Pages - [ ] Outline my portfolio - [ ] Introduce myself to the world
-
Use the Preview tab to check your markdown formatting
-
Click Comment
For a printable version of the steps in this course, check out the Quick Reference Guide.
Watch below your comment for my response
If you perform an expected action and don't see a response from me after a few seconds, refresh the page for your next steps.
- Turn on Github Pages
- Outline my portfolio
- Intoduce myself to the world
Step 2: Turn on GitHub Pages
Nicely done @abhishekkumarjha! At least one task in your Markdown to-do list is correct. ✨
Now let's turn our focus to the content of your portfolio. Because this portfolio will be displayed as a static web page, you'll need to enable GitHub Pages.
⌨️ Activity: Enable GitHub Pages
- Under your repository name, click Settings.
- In the GitHub Pages section, use the Select source drop-down menu to select
master
as your GitHub Pages publishing source. - Click Save.
I may take up to a minute to respond as I wait for GitHub Pages to create a deployment of your repository.
For more information, see Configuring a publishing source for GitHub Pages in the GitHub Help.