{"id":19108332,"url":"https://github.com/rollingghost/introduction-to-github","last_synced_at":"2026-02-25T16:31:36.911Z","repository":{"id":160115724,"uuid":"531653756","full_name":"rollingghost/introduction-to-github","owner":"rollingghost","description":null,"archived":false,"fork":false,"pushed_at":"2022-09-01T19:35:09.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-20T13:38:41.242Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rollingghost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-01T19:11:39.000Z","updated_at":"2022-09-01T19:11:39.000Z","dependencies_parsed_at":"2024-03-17T13:01:10.534Z","dependency_job_id":null,"html_url":"https://github.com/rollingghost/introduction-to-github","commit_stats":null,"previous_names":["rollingghost/introduction-to-github"],"tags_count":0,"template":false,"template_full_name":"skills/github-pages","purl":"pkg:github/rollingghost/introduction-to-github","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollingghost%2Fintroduction-to-github","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollingghost%2Fintroduction-to-github/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollingghost%2Fintroduction-to-github/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollingghost%2Fintroduction-to-github/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rollingghost","download_url":"https://codeload.github.com/rollingghost/introduction-to-github/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollingghost%2Fintroduction-to-github/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29830115,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T15:41:19.027Z","status":"ssl_error","status_checked_at":"2026-02-25T15:40:47.150Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T04:15:49.529Z","updated_at":"2026-02-25T16:31:36.684Z","avatar_url":"https://github.com/rollingghost.png","language":null,"readme":"\u003c!--\n  \u003c\u003c\u003c Author notes: Header of the course \u003e\u003e\u003e\n  Include a 1280×640 image, course title in sentence case, and a concise description in emphasis.\n  In your repository settings: enable template repository, add your 1280×640 social image, auto delete head branches.\n  Add your open source license, GitHub uses Creative Commons Attribution 4.0 International.\n--\u003e\n\n# GitHub Pages\n\n_Create a site or blog from your GitHub repositories with GitHub Pages._\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Start of the course \u003e\u003e\u003e\n  Include start button, a note about Actions minutes,\n  and tell the learner why they should take the course.\n  Each step should be wrapped in \u003cdetails\u003e/\u003csummary\u003e, with an `id` set.\n  The start \u003cdetails\u003e should have `open` as well.\n  Do not use quotes on the \u003cdetails\u003e tag attributes.\n--\u003e\n\n\u003c!--step0\n\nWith GitHub Pages, you can host project blogs, documentation, resumes, portfolios, or any other static content you'd like. Your GitHub repository can easily become its own website. In this course, we'll show you how to set up your own site or blog using GitHub Pages.\n\n- **Who is this for**: Beginners, students, project maintainers, small businesses.\n- **What you'll learn**: How to build a GitHub Pages site.\n- **What you'll build**: We'll build a simple GitHub Pages site with a blog. We'll use [Jekyll](https://jekyllrb.com), a static site generator.\n- **Prerequisites**: If you need to learn about branches, commits, and pull requests, take [Introduction to GitHub](https://github.com/skills/introduction-to-github) first.\n- **How long**: This course is five steps long and takes less than one hour to complete.\n\n## How to start this course\n\n1. Above these instructions, right-click **Use this template** and open the link in a new tab.\n   ![Use this template](https://user-images.githubusercontent.com/1221423/169618716-fb17528d-f332-4fc5-a11a-eaa23562665e.png)\n2. In the new tab, follow the prompts to create a new repository.\n   - For owner, choose your personal account or an organization to host the repository.\n   - We recommend creating a public repository—private repositories will [use Actions minutes](https://docs.github.com/en/billing/managing-billing-for-github-actions/about-billing-for-github-actions).\n   ![Create a new repository](https://user-images.githubusercontent.com/1221423/169618722-406dc508-add4-4074-83f0-c7a7ad87f6f3.png)\n3. After your new repository is created, wait about 20 seconds, then refresh the page. Follow the step-by-step instructions in the new repository's README.\n\nendstep0--\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 1 \u003e\u003e\u003e\n  Choose 3-5 steps for your course.\n  The first step is always the hardest, so pick something easy!\n  Link to docs.github.com for further explanations.\n  Encourage users to open new tabs for steps!\n--\u003e\n\n\u003cdetails id=1\u003e\n\u003csummary\u003e\u003ch2\u003eStep 1: Enable GitHub Pages\u003c/h2\u003e\u003c/summary\u003e\n\n_Welcome to GitHub Pages and Jekyll :tada:!_\n\nThe first step is to enable GitHub Pages on this [repository](https://docs.github.com/en/get-started/quickstart/github-glossary#repository). When you enable GitHub Pages on a repository, GitHub takes the content that's on the main branch and publishes a website based on its contents.\n\n### :keyboard: Activity: Enable GitHub Pages\n\n1. Open a new browser tab, and work on the steps in your second tab while you read the instructions in this tab.\n1. Under your repository name, click **Settings**.\n1. Click **Pages**, in the \"GitHub Pages\" section, use the Source drop-down, then select **main branch**.\n1. Wait about _one minute_, then refresh this page for the next step.\n   \u003e Turning on GitHub Pages creates a deployment of your repository. GitHub Actions may take up to a minute to respond while waiting for the deployment. Future steps will be about 20 seconds; this step is slower.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 2 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n  Historic note: previous version checked for empty pull request, changed to the correct theme `minima`.\n--\u003e\n\n\u003cdetails id=2\u003e\n\u003csummary\u003e\u003ch2\u003eStep 2: Configure your site\u003c/h2\u003e\u003c/summary\u003e\n\n_You turned on GitHub Pages! :tada:_\n\nWe'll work in a branch, `my-pages`, that I created for you to get this site looking great. :sparkle:\n\nJekyll uses a file titled `_config.yml` to store settings for your site, your theme, and reusable content like your site title and GitHub handle. You can check out the `_config.yml` file on the **Code** tab of your repository.\n\nWe need to use a blog-ready theme. For this activity, we will use a theme named \"minima\".\n\n### :keyboard: Activity: Configure your site\n\n1. Browse to the `_config.yml` file in the `my-pages` branch.\n1. In the upper right corner, open the file editor.\n1. Add a `theme:` set to **minima** so it shows in the `_config.yml` file as below:\n    ```yml\n    theme: minima\n    ```\n1. (optional) You can modify the other configuration variables such as `title:`, `author:`, and `description:` to further customize your site.\n1. Commit your changes.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 3 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n  Historic note: previous version checked the homepage content was not empty.\n--\u003e\n\n\u003cdetails id=3\u003e\n\u003csummary\u003e\u003ch2\u003eStep 3: Customize your homepage\u003c/h2\u003e\u003c/summary\u003e\n\n_Nice work setting the theme! :sparkles:_\n\nYou can customize your homepage by adding content to either an `index.md` file or the `README.md` file. GitHub Pages first looks for an `index.md` file. Your repository has an `index.md` file so we can update it to include your personalized content.\n\n### :keyboard: Activity: Create your homepage\n\n1. Browse to the `index.md` file in the `my-pages` branch.\n1. In the upper right corner, open the file editor.\n1. Type the content you want on your homepage. You can use Markdown formatting on this page.\n1. (optional) You can also modify `title:` or just ignore it for now. We'll discuss it in the next step.\n1. Commit your changes to the `my-pages` branch.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 4 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n  Historic note: previous version checked the file path. Previous version checked the front matter formatting.\n--\u003e\n\n\u003cdetails id=4\u003e\n\u003csummary\u003e\u003ch2\u003eStep 4: Create a blog post\u003c/h2\u003e\u003c/summary\u003e\n\n_Your home page is looking great! :cowboy_hat_face:_\n\nGitHub Pages uses Jekyll. In Jekyll, we can create a blog by using specially named files and frontmatter. The files must be named `_posts/YYYY-MM-DD-title.md`. You must also include `title` and `date` in your frontmatter.\n\n**What is _frontmatter_?**: The syntax Jekyll files use is called YAML frontmatter. It goes at the top of your file and looks something like this:\n\n```yml\n---\ntitle: \"Welcome to my blog\"\ndate: 2019-01-20\n---\n```\n\nFor more information about configuring front matter, see the [Jekyll frontmatter documentation](https://jekyllrb.com/docs/frontmatter/).\n\n### :keyboard: Activity: Create a blog post\n\n1. Browse to the `my-pages` branch.\n1. Click the `Add file` dropdown menu and then on `Create new file`.\n1. Name the file `_posts/YYYY-MM-DD-title.md`.\n1. Replace the `YYYY-MM-DD` with today's date, and change the `title` of your first blog post if you'd like.\n   \u003e If you do edit the title, make sure there are hyphens between your words.\n   \u003e If your blog post date doesn't follow the correct date convention, you'll receive an error and your site won't build. For more information, see \"[Page build failed: Invalid post date](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites)\".\n1. Type the following content at the top of your blog post:\n   ```yaml\n   ---\n   title: \"YOUR-TITLE\"\n   date: YYYY-MM-DD\n   ---\n   ```\n1. Replace `YOUR-TITLE` with the title for your blog post.\n1. Replace `YYYY-MM-DD` with today's date.\n1. Type a quick draft of your blog post. Remember, you can always edit it later.\n1. Commit your changes to your branch.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 5 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n--\u003e\n\n\u003cdetails id=5\u003e\n\u003csummary\u003e\u003ch2\u003eStep 5: Merge your pull request\u003c/h2\u003e\u003c/summary\u003e\n\n_Nice work, friend :heart:! People will be reading your blog in no time!_\n\nYou can now [merge](https://docs.github.com/en/get-started/quickstart/github-glossary#merge) your pull request!\n\n### :keyboard: Activity: Merge your pull request\n\n1. Click **Merge pull request**.\n1. Delete the branch `my-pages` (optional).\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Finish \u003e\u003e\u003e\n  Review what we learned, ask for feedback, provide next steps.\n--\u003e\n\n\u003cdetails id=X open\u003e\n\u003csummary\u003e\u003ch2\u003eFinish\u003c/h2\u003e\u003c/summary\u003e\n\n_Congratulations friend, you've completed this course!_\n\n\u003cimg src=https://octodex.github.com/images/constructocat2.jpg alt=celebrate width=300 align=right\u003e\n\nYour blog is now live and has been deployed!\n\nHere's a recap of all the tasks you've accomplished in your repository:\n\n- You enabled GitHub Pages.\n- You selected a theme using the config file.\n- You learned about proper directory format and file naming conventions in Jekyll.\n- You created your first a blog post with Jekyll!\n\n### What's next?\n\n- Keep working on your GitHub Pages site... we love seeing what you come up with!\n- We'd love to hear what you thought of this course [in our discussion board](https://github.com/skills/.github/discussions).\n- [Take another GitHub Skills course](https://github.com/skills).\n- [Read the GitHub Getting Started docs](https://docs.github.com/en/get-started).\n- To find projects to contribute to, check out [GitHub Explore](https://github.com/explore).\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Footer \u003e\u003e\u003e\n  Add a link to get support, GitHub status page, code of conduct, license link.\n--\u003e\n\n---\n\nGet help: [Post in our discussion board](https://github.com/skills/.github/discussions) \u0026bull; [Review the GitHub status page](https://www.githubstatus.com/)\n\n\u0026copy; 2022 GitHub \u0026bull; [Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/code_of_conduct.md) \u0026bull; [CC-BY-4.0 License](https://creativecommons.org/licenses/by/4.0/legalcode)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollingghost%2Fintroduction-to-github","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frollingghost%2Fintroduction-to-github","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollingghost%2Fintroduction-to-github/lists"}