assignment's github page

1. Introduction

Submitting Coding Assignments and Using GitHub

Note:  If you are here as part of a course, please read on. Otherwise, submitting coding assignments is not required.

Most assignments that follow are various inaccessible web page widgets that we will ask you to make accessible by rewriting their code (HTML, CSS, or JavaScript). If you are participating here as part of a course, you will need the link to a live web page with your solution. Before the code is reviewed, the page will be checked for accessibility (using ChromeVox and other tools).

It is your decision where you want to host the pages that you will submit for review. If you have your own domain and server space, you can upload completed assignments there and submit the URL. Another option is to submit the URL of a file on GitHub to GitHack ( https://raw.githack.com ), then submit the URL to the output it generates as your assignment submission.

Feel free to download the activity files from our repository now, or if you are going to use GitHub, keep reading for instructions on how to fork it to your own account.

If you don’t have a website, we recommend using GitHub as your platform for submitting assignments. Below we describe GitHub and GitHub Pages. If you are familiar with using GitHub or you have your own web server, you can skip the rest of this page or just scan it.

Set Up a GitHub Account

If you do not already have one, you should create a GitHub account. For any developer, it is an invaluable tool for sharing and collaborating on code development. A GitHub account is free. Though you can download the activity files from GitHub, then unzip them and work from a local directory on your hard drive, we recommend creating a fork of the activity files to your own account and cloning your fork into a local directory. Follow the link below to set up an account, then read on.

Set Up a Local Git Environment

Depending on the operating system you are using, there are specific versions of Git for each platform. You may choose to use a Git client, or you may choose to use Git from the command line. Here we will present command line options. If you choose to use a client, see the documentation associated with the client for details on cloning, committing, pulling, and pushing.

For Windows and Mac users, if you are going to use a client instead of working from a command line, we suggest installing SourceTree. GitHub Desktop is a good alternative if you prefer to use an open source client. Feel free to choose another Git client if you like.

For Linux users you can use your system’s package manager to install Git for command line use. On Ubuntu, for instance, at the command prompt you can run apt-get as the root user to install Git:

#> sudo apt-get install git

If you are using another Linux distribution, use Google to find details on installing Git on your version of Linux.

Assignment Submissions via GitHub

Most of the assignments that follow require submitting a URL to a publicly accessible version of the widgets that are the focus of the activities.

If you need a place to post your activity assignments, GitHub Pages can be a good option. Or, you may just prefer to use GitHub Pages to organize your files so they are not cluttering your web server. You will create a fork of the activity files ( learnaria.github.io ), rename the repository to create your own version, and either upload it to a site of your choosing or use GitHub Pages. The GitHub Pages option is outlined here.

If you choose to use GitHub Pages, follow these steps to create a copy of the files under your own GitHub account.

• Logged into GitHub, find your way to the activity files , and fork that repository. The fork button is at the top right of the GitHub screen while viewing a repository. This creates a copy of the repository under your own GitHub account where you will work from.
• After you have forked the activity files, go into the settings for that repository and change the name from learnaria.github.io to [username].github.io, where username is your GitHub account username. This will automatically create your GitHub Pages website at https://[username].github.io .
• Now you will want to create a clone of your forked activity files repository on your computer, through which you will do your work. From the command line issue the following command to create a clone of the forked version of the activity files you created, where [username] is your GitHub account username. You can also copy the https link from a field that opens when you click on the “Clone or download” button in your repo. #> git clone
• If you are using SourceTree, click on “+ New Repository” and choose “Clone from URL” and enter the above URL into the “Source URL” field. Set the “Destination Path” to your preferred work directory.

You should now have a copy of the activity files available locally that you can edit and commit back as your assignment updates, which become part of your GitHub Pages website.

Note that it can take a few seconds or a minute for changes committed to your GitHub Pages repository to actually show up on the website.

If You Already Have a GitHub Pages Site

To add the files to an existing GitHub Pages site, open the settings for the forked repository you created. In the GitHub Pages section shown in the screenshot below, choose the Source (typically, the master branch) and click Save. This will create a subdirectory under your existing GitHub Pages site with the name of the forked repository (i.e.,  learnaria.github.io ).

You may want to rename the repository to something shorter (e.g., learnaria) before enabling it in GitHub Pages. This would produce a URL to the activity files, something like:

https://[username].github.io/learnaria/

Basic Git Commands

You do not need to be an expert Git user, but you should know a few basic commands if you are working from a command prompt. The commands you’ll likely use are the following:

git status  (displays a list of changed and untracked files)

git add [filename] (prepares a files for committing)

git commit -m “[message]” (describe the nature of the commit)

git push [origin master] (sends the committed change to your GitHub repository master branch)

git diff [filename] (shows the changes in a file)

Of course there are many other potential commands, but these are the most common. If you are using a Git client, such as SourceTree, these commands will be clickable in the UI buttons and menus. For more about using Git from the command line, see the Git Book.

What the Activity Files Look Like

Here is what to expect once you have successfully set up the activity files. You’ll note that the widgets are inaccessible. Your job throughout the activities will be to fix the accessibility of each widget.

Web Accessibility for Developers Copyright © 2019 by The Chang School, Toronto Metropolitan University is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License , except where otherwise noted.

Share This Book

• school Campus Bookshelves
• menu_book Bookshelves
• perm_media Learning Objects
• login Login
• how_to_reg Request Instructor Account
• hub Instructor Commons
• Download Page (PDF)
• Download Full Book (PDF)
• Periodic Table
• Physics Constants
• Scientific Calculator
• Reference & Cite
• Tools expand_more
• Readability

selected template will load here

This action is not available.

2.2: Submitting Coding Assignments and Using GitHub

• Last updated
• Save as PDF
• Page ID 15582

• Digital Education Strategies, The Chang School
• Ryerson University

Note: If you are here as part of a course, please read on. Otherwise, submitting coding assignments is not required.

Most assignments that follow are various inaccessible web page widgets that we will ask you to make accessible by rewriting their code (HTML, CSS, or JavaScript). If you are participating here as part of a course, you will need the link to a live web page with your solution. Before the code is reviewed, the page will be checked for accessibility (using ChromeVox and other tools).

It is your decision where you want to host the pages that you will submit for review. If you have your own domain and server space, you can upload completed assignments there and submit the URL. Another option is to submit the URL of a file on GitHub to GitHack ( https://raw.githack.com ), then submit the URL to the output it generates as your assignment submission.

Feel free to download the activity files from our repository now, or if you are going to use GitHub, keep reading for instructions on how to fork it to your own account.

If you don’t have a website, we recommend using GitHub as your platform for submitting assignments. Below we describe GitHub and GitHub Pages. If you are familiar with using GitHub or you have your own web server, you can skip the rest of this page or just scan it.

Set Up a GitHub Account

If you do not already have one, you should create a GitHub account. For any developer, it is an invaluable tool for sharing and collaborating on code development. A GitHub account is free. Though you can download the activity files from GitHub, then unzip them and work from a local directory on your hard drive, we recommend creating a fork of the activity files to your own account and cloning your fork into a local directory. Follow the link below to set up an account, then read on.

Set Up a Local Git Environment

Depending on the operating system you are using, there are specific versions of Git for each platform. You may choose to use a Git client, or you may choose to use Git from the command line. Here we will present command line options. If you choose to use a client, see the documentation associated with the client for details on cloning, committing, pulling, and pushing.

For Windows and Mac users, if you are going to use a client instead of working from a command line, we suggest installing SourceTree. GitHub Desktop is a good alternative if you prefer to use an open source client. Feel free to choose another Git client if you like.

For Linux users you can use your system’s package manager to install Git for command line use. On Ubuntu, for instance, at the command prompt you can run apt-get as the root user to install Git:

#> sudo apt-get install git

If you are using another Linux distribution, use Google to find details on installing Git on your version of Linux.

Assignment Submissions via GitHub

Most of the assignments that follow require submitting a URL to a publicly accessible version of the widgets that are the focus of the activities.

If you need a place to post your activity assignments, GitHub Pages can be a good option. Or, you may just prefer to use GitHub Pages to organize your files so they are not cluttering your web server. You will create a fork of the activity files ( learnaria.github.io ), rename the repository to create your own version, and either upload it to a site of your choosing or use GitHub Pages. The GitHub Pages option is outlined here.

If you choose to use GitHub Pages, follow these steps to create a copy of the files under your own GitHub account.

• Logged into GitHub, find your way to the activity files , and fork that repository. The fork button is at the top right of the GitHub screen while viewing a repository. This creates a copy of the repository under your own GitHub account where you will work from.
• After you have forked the activity files, go into the settings for that repository and change the name from learnaria.github.io to [username].github.io, where username is your GitHub account username. This will automatically create your GitHub Pages website at https://[username].github.io .
• Now you will want to create a clone of your forked activity files repository on your computer, through which you will do your work. From the command line issue the following command to create a clone of the forked version of the activity files you created, where [username] is your GitHub account username. You can also copy the https link from a field that opens when you click on the “Clone or download” button in your repo. #> git clone
• If you are using SourceTree, click on “+ New Repository” and choose “Clone from URL” and enter the above URL into the “Source URL” field. Set the “Destination Path” to your preferred work directory.

You should now have a copy of the activity files available locally that you can edit and commit back as your assignment updates, which become part of your GitHub Pages website.

Note that it can take a few seconds or a minute for changes committed to your GitHub Pages repository to actually show up on the website.

If You Already Have a GitHub Pages Site

To add the files to an existing GitHub Pages site, open the settings for the forked repository you created. In the GitHub Pages section shown in the screenshot below, choose the Source (typically, the master branch) and click Save. This will create a subdirectory under your existing GitHub Pages site with the name of the forked repository (i.e., learnaria.github.io ).

You may want to rename the repository to something shorter (e.g., learnaria) before enabling it in GitHub Pages. This would produce a URL to the activity files, something like:

https://[username].github.io/learnaria/

Basic Git Commands

You do not need to be an expert Git user, but you should know a few basic commands if you are working from a command prompt. The commands you’ll likely use are the following:

git status (displays a list of changed and untracked files)

git add [filename] (prepares a files for committing)

git commit -m “[message]” (describe the nature of the commit)

git push [origin master] (sends the committed change to your GitHub repository master branch)

git diff [filename] (shows the changes in a file)

Of course there are many other potential commands, but these are the most common. If you are using a Git client, such as SourceTree, these commands will be clickable in the UI buttons and menus. For more about using Git from the command line, see the Git Book.

What the Activity Files Look Like

Here is what to expect once you have successfully set up the activity files. You’ll note that the widgets are inaccessible. Your job throughout the activities will be to fix the accessibility of each widget.

How to use group assignments in GitHub Classroom

Like professional developers working together on code, students can use GitHub Classroom to collaborate on group projects in a shared repository. In this post, we’ll walk you through how teachers…

Like professional developers working together on code, students can use GitHub Classroom to collaborate on group projects in a shared repository. In this post, we’ll walk you through how teachers can work with GitHub teams and use GitHub Classroom to create group exercises, assign teams, and reuse existing student teams.

Before you begin

Before you create a group exercise, you’ll need the following:

A GitHub organization with a discount for private repositories and access to GitHub Classroom

An exercise (a repository that you have access to, which contains documentation, starter code, tests, or anything else your students need to begin work on an assignment)

A list of students, or unique identifiers like their email addresses

Get started

To get started, log in to GitHub Classroom , choose one of your classrooms, then click the New assignment button followed by Create group assignment . This brings you to the “New group assignment” page where you can provide the details of an assignment. If you don’t see your classroom listed, double check that you’ve granted that organization access to GitHub Classroom .

Then set up your group assignment just like you’d setup an individual assignment. Pick a name for your exercise, a starter repository to share, and a deadline.

Create and use groups

When creating a new exercise, you can choose whether to reuse a set of groups from a previous assignment or name a set of new groups. If you’re reusing existing groups, then select a set of teams from the “Choose an existing set of groups” drop-down list.

If your students are going to form a new set of teams, enter a name for the set of teams in the “Create a new set of teams” field. It’s helpful to name your set of teams after their intended duration. For example, if you want to use a set of teams for one assignment, name it after that assignment. If you’d like to reuse a set of teams for a whole semester, name it after the semester or course.

When you’ve completed the form, click the “Create Assignment” button. Now it’s time to invite your students to the assignment.

Form student groups

On the assignment page, you’ll find a unique invitation link. Share this link with your students through your learning management system, course homepage, or however you distribute assignments. Keep in mind that anyone with the link can use it, so be careful where you share it.

If you’re using a new set of groups for this exercise, and you’d like to assign students to specific group, give your students a list of people who should join each group, along with the group’s name.

Once your students have clicked the link, they may be asked to join a group (if you’re not reusing an existing set of groups). It looks like this:

There are three common cases when organizing students into teams:

• There are no groups yet. The student will have to enter the name of a new group to create it
• There are one or more groups already formed. The student clicks on the existing group they want to join
• A student needs to create a new group. The student enters the name of a new group to create it

Classroom groups and GitHub teams

When students join their group in Classroom, a team is created on GitHub.com in your GitHub organization. Teams have pretty nifty functionality, including threaded comments and emoji support.

If you create a team for your students on GitHub.com, that team will not appear in Classroom. If you’d like to use Classroom to distribute shared repositories, then use group assignments in Classroom, not teams on GitHub.com.

When you use group assignments in Classroom, each team of students will get access to one shared repository for the exercise. Every student will be able to push and pull to their team’s repository. We recommend assigning one student per team to act as project manager to resolve conflicts or merge pull requests. If your students are new to resolving conflicting changes, they can check out our documentation to learn to manage merge conflicts.

Get deeper insight into group participation

Once your students are sorted into teams, they can start collaborating on the assignment like they would in any other repository: by pushing commits and branches, opening and reviewing pull requests, or using issues. Similarly, all of their commit history is available for you to review.

As students finish up their assignments, you can see the work they’ve done in two ways. Examine the current state of the files to see the finished product or look through the repository’s history to see how students worked together. GitHub’s “Insights” tab provides you with a picture of how your students worked together. For example, “Pulse” data gives you a timeline of your students’ pull requests, issues, and conversations, while “Contributors” graphs visualize your students’ additions and deletions.

Once students complete their projects, there are a few ways to deliver feedback, including:

• Going to the list of commits and making comments on individual commits
• Weighing in on a per-line basis (if students used pull requests)
• If you find that students make a similar error over and over, creating a canned reply and opening an issue directly from the plus sign (“+”) in the code view

If you chose to use private repositories for your assignment, your feedback will be confidential, so only you and the students in the group will see it.

Create a group exercise

Ready to give a group assignment? Get started right away in GitHub Classroom . Or check out this discussion in the GitHub Education Community on how student groups can work with GitHub teams in Classroom.

Related posts

GitHub Fund 2024 and beyond: Looking to the future

Celebrate the first year of GitHub Fund, our first investments, and a brief look of where we’re going.

Empowering Uruguay’s future workforce with AI

During the second cycle of Git Commit Uruguay, students learned the basics of AI and built their own AI-powered projects.

GitHub Certifications are generally available

Unlock your full potential with GitHub Certifications! Earning a GitHub certification will give you the competitive advantage of showing up as a GitHub expert.

Explore more from GitHub

Github universe 2024, github copilot, work at github, subscribe to our newsletter.

Code with confidence. Discover tips, technical guides, and best practices in our biweekly newsletter just for devs.

Websites for you and your projects.

Hosted directly from your github repository . just edit, push, and your changes are live..

Ready to get started? Build your own site from scratch or generate one for your project.

You get one site per github account and organization, and unlimited project sites. let‘s get started..

• User or organization site
• Project site

Create a repository

Head over to GitHub and create a new public repository named username .github.io, where username is your username (or organization name) on GitHub.

If the first part of the repository doesn’t exactly match your username, it won’t work, so make sure to get it right.

What git client are you using?

• GitHub Desktop
• I don't know

Download GitHub Desktop

GitHub Desktop is a great way to use Git and GitHub on macOS and Windows.

Clone the repository

Go to the folder where you want to store your project, and clone the new repository:

~ $ git clone https://github.com/ username / username .github.io

Click the "Set up in Desktop" button. When the GitHub desktop app opens, save the project.

If the app doesn't open, launch it and clone the repository from the app.

After finishing the installation, head back to GitHub.com and refresh the page. Click the "Set up in Desktop" button. When the GitHub desktop app opens, save the project.

Hello World

Enter the project folder and add an index.html file:

~ $ cd username .github.io

~ $ echo "Hello World" > index.html

Create an index file

Grab your favorite text editor and add an index.html file to your project:

Add, commit, and push your changes:

~ $ git add --all

~ $ git commit -m "Initial commit"

~ $ git push -u origin main

Commit & publish

Enter the repository, commit your changes, and press the publish button.

…and you're done!

Fire up a browser and go to https:// username .github.io .

Use a theme, or start from scratch?

• Choose a theme
• Start from scratch

Repository Settings

Head over to GitHub.com and create a new repository, or go to an existing one. Click on the Settings tab .

Theme chooser

Scroll down to the GitHub Pages section. Press Choose a theme .

Pick a theme

Choose one of the themes from the carousel at the top. When you're done, click Select theme on the right.

Edit content

Use the editor to add content to your site.

Enter a commit comment and click on Commit changes below the editor.

Head over to GitHub.com and create a new repository , or go to an existing one. Click on the Create new file button.

Name the file index.html and type some HTML content into the editor.

Commit the file

Scroll to the bottom of the page, write a commit message, and commit the new file.

Click on the Settings tab and scroll down to the GitHub Pages section. Then select the main branch source and click on the Save button.

Fire up a browser and go to http:// username .github.io/ repository .

Now that you’re up and running, here are a few things you should know.

Blogging with jekyll.

Using Jekyll , you can blog using beautiful Markdown syntax, and without having to deal with any databases. Learn how to set up Jekyll .

Custom URLs

Want to use your own custom domain for a GitHub Pages site? Just create a file named CNAME and include your URL. Read more .

Learn how to create custom 404 pages, use submodules, and learn more about GitHub Pages .

Edgar Tomeyan

Ruby on rails developer.

Web developer with abilities to design, implement, deploy, test and debug Ruby on Rails applications.

• Phone: +79773030311
• Email: [email protected]
• GitHub:  github.com/just-ed
• Ruby, Ruby on Rails
• Git, GitHub
• Heroku, VPS
• Russian - Proficiency
• English - Upper-Intermediate
• Armenian - Beginner
• Self-development
• Playing guitar
• Android ROMs

Notable Places in the Area

Elektrostal Satellite Map

Popular Destinations in Moscow Oblast

Escape to a random place.

persuasive essay grade 11

A Persuasive Essay Has 3 Components. Introduction: This is the opening paragraph of your essay. It contains the hook, which is used to grab the reader's attention, and the thesis, or argument, which you'll explain in the next section. Body: This is the heart of your essay, usually three to five paragraphs in length.

List of 113 Good Persuasive Essay Topics. Below are over 100 persuasive essay ideas, organized into ten categories. When you find an idea that piques your interest, you'll choose one side of it to argue for in your essay. For example, if you choose the topic, "should fracking be legal?" you'd decide whether you believe fracking should ...

63 Persuasive Essay Topics. Teens should learn etiquette at school. All teens should have the opportunity to study in a different country. Parents of a kid who bullies someone else should pay a fine. School days should start after noon. Teens should have the opportunity to determine their own curfew and bedtime.

Beyond that, there are a few more tricks that one can use to enhance one's skills quickly. These persuasive essay worksheets and activities will help students master these tricks. Creating Persuasive Attention Catchers Activity - Students practice creating persuasive leads that immediately push the reader toward their side of the argument.

Persuasive Essay Format Example. A persuasive essay outline is bound to follow a specific format and structure. The main elements of a persuasive essay format are as follows. Font: Times New Roman, Georgia, or Arial. Font Size: 16pt for the headlines and 12pt for the rest of the text. Alignment: Justified.

TIP 1: Be careful not to introduce a new argument in the conclusion—there's no time to develop it now that you've reached the end of your discussion! TIP 2: As with your thesis, avoid announcing your conclusion. Don't start your conclusion with "in conclusion" or "to conclude" or "to end my essay" type statements.

Persuasive Essay and Speech Topics. Whether you are a student in need of a persuasive essay topic, or a teacher looking to assign a persuasive essay, this list of 101 persuasive essay topics is a great resource. I taxed my brain to create this huge list of persuasive essay topics relevant to today's society, but I believe it was worth the effort.

Thesis statement: Let the audience know your stance. After surveying the topic in the first part of the introduction, it is now time for the student writer to express their opinion and briefly preview the points they will make later in the essay. 2. Body Paragraphs.

All Grades K-5 All Grades 6-12 PreK 6th Grade Kindergarten 7th Grade 1st Grade 8th Grade 2nd ... authors have used persuasive essays to try to sway others to their own point of view. Check out these top persuasive essay writing examples. ... Sample lines: "Obviously, Harry Potter and the Sorcerer's Stone should make any modern 11-year-old a ...

A persuasive essay (purr-SWEY-siv ESS-ey) is a composition in which the essayist's goal is to persuade the reader to agree with their personal views on a debatable topic. A persuasive essay generally follows a five-paragraph model with a thesis, body paragraphs, and conclusion, and it offers evidential support using research and other persuasive techniques.

11 (280) 12 (278) K (84) Type. Classroom Resources. ... Use this graphic organizer to develop a persuasive stance for an essay, speech, poster, or any type of assignment that incorporates persuasion. ... Before your students use this tool independently, model its use for them. Choose a simple topic (such as, "Sixth Grade is the Best Grade ...

Persuasion Map: Students can use this online interactive tool to map out an argument for their persuasive essay.: Persuasive Strategy Presentation: This handy PowerPoint presentation helps students master the definition of each strategy used in persuasive writing.: Check the Strategies: Students can apply what they know about persuasive writing strategies by evaluating a persuasive piece and ...

The term "persuasive" is an adjective derived from verb "persuade," which means "to convince somebody.". A persuasive essay is full of all the convincing techniques a writer can employ. It presents a situation, and takes a stand - either in its favor, or against it - to prove to readers whether it is beneficial or harmful for them.

These persuasive essay topics provide lots of scope for students of all ages. Is a taco a sandwich? Use your words to sway the reader. ... School Leaders; Search for: Grades Grades. All Grades K-5 All Grades 6-12 PreK 6th Grade Kindergarten 7th Grade 1st Grade 8th Grade 2nd Grade 9th Grade 3rd Grade 10th Grade 4th Grade 11th Grade 5th Grade ...

CLASS: Grade 11 English LESSON #: 5 TOPIC: Writing & Composition: ESSAY STRUCTURE & PATTERNS OBJECTIVES: To outline the basic structure of an essay To illustrate the differences between narrative, expository, argumentative & persuasive essays SWBAT: Identify the parts of an essay Identify the patterns of essays ACTIVITY TEACHER WILL…

See these 23 persuasive essay topics for high school! This list is packed full of great ideas to help get your writers' creative juices flowing. ... Grade 1 Grade 2 Grade 3 Grade 4 Grade 5 Grade 6 Grade 7-8 Grade 9-12 All Ages. JournalBuddies.com. Menu. Yay, MORE Fun Ideas! ... 11 Bonus Persuasive Essay Topics and Prompts. Professional athletes ...

The Persuasion Map is an interactive graphic organizer that enables students to map out their arguments for a persuasive essay or debate. Students begin by determining their goal or thesis. They then identify three reasons to support their argument, and three facts or examples to validate each reason. The map graphic in the upper right-hand ...

Writing, Revising, and Editing. After students have gathered and organized their reasons, they are ready to start writing. Lead them through the tips and examples for creating effective beginnings, middles, and endings. Then give them time to write. Once students complete their first drafts, review the tips for revising and editing.

Persuasive Essay #2 ("Word Power") Purpose: Persuasive writing, also known as the argument essay, utilizes logic and reason to show that one idea is more legitimate than another idea. It attempts to persuade a reader to adopt a certain point of view or to take a particular action. The argument must always use sound reasoning and solid evidence ...

Grade 11 Unit 2 EA 2 Writing and Presenting a Persuasive Speech . Score: Exemplary ... Over the course of the five paragraph essay , the thesis is ... clearly add to the persuasive impact of the speech. Grade 11 Unit 2 EA 2 Writing and Presenting a Persuasive Speech . Score: Proficient ...

Johnson, Brianna, "English II Persuasive Essay [10th grade]" (2014). Understanding by Design: Complete Collection. 275. This Instructional Material is brought to you for free and open access by the Understanding by Design at Digital Commons @ Trinity. For more information about this unie, please contact the author(s): [email protected] .

This Grade 11 unit titled "The Art of Persuasion and the Craft of Argument" from the Massachusetts Department of Elementary and Secondary Education is intended to be completed in 10-12 sessions of ELA/Literacy instruction (forty-five to sixty minutes in length). Through a series of lessons, students develop analytical skills to recognize and ...

GitHub Pages documentation

Learn how to create a website directly from a repository on GitHub.com. Explore website building tools like Jekyll and troubleshoot issues with your GitHub Pages site.

• Configuring a publishing source for your GitHub Pages site

You can configure your GitHub Pages site to publish when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site.

• Creating a GitHub Pages site

You can create a GitHub Pages site in a new or existing repository.

• Managing a custom domain for your GitHub Pages site

You can set up or update certain DNS records and your repository settings to point the default domain for your GitHub Pages site to a custom domain.

• About custom domains and GitHub Pages

GitHub Pages supports using custom domains, or changing the root of your site's URL from the default, like octocat.github.io, to any domain you own.

• About GitHub Pages and Jekyll

Jekyll is a static site generator with built-in support for GitHub Pages.

• Troubleshooting custom domains and GitHub Pages

You can check for common errors to resolve issues with custom domains or HTTPS for your GitHub Pages site.

• Securing your GitHub Pages site with HTTPS

HTTPS adds a layer of encryption that prevents others from snooping on or tampering with traffic to your site. You can enforce HTTPS for your GitHub Pages site to transparently redirect all HTTP requests to HTTPS.

What's new

• GitHub Pages with Custom GitHub Actions Workflows are now generally available March 25
• GitHub Pages: Deprecating symlinks in non-Actions builds February 21
• GitHub Pages: Deprecating the theme picker August 23
• Creating a custom 404 page for your GitHub Pages site

You can display a custom 404 error page when people try to access nonexistent pages on your site.

• Adding a theme to your GitHub Pages site using Jekyll

You can personalize your Jekyll site by adding and customizing a theme.

• Troubleshooting Jekyll build errors for GitHub Pages sites

You can use Jekyll build error messages to troubleshoot problems with your GitHub Pages site.

All GitHub Pages docs

Getting started with github pages.

• About GitHub Pages
• Using custom workflows with GitHub Pages
• Deleting a GitHub Pages site
• Unpublishing a GitHub Pages site
• Using submodules with GitHub Pages
• Troubleshooting 404 errors for GitHub Pages sites

Setting up a GitHub Pages site with Jekyll

• Creating a GitHub Pages site with Jekyll
• Testing your GitHub Pages site locally with Jekyll
• Adding content to your GitHub Pages site using Jekyll
• Setting a Markdown processor for your GitHub Pages site using Jekyll
• About Jekyll build errors for GitHub Pages sites

Configuring a custom domain for your GitHub Pages site

• Verifying your custom domain for GitHub Pages