|
| 1 | +<!-- |
| 2 | + <<< Author notes: Step 4 >>> |
| 3 | + Start this step by acknowledging the previous step. |
| 4 | + Define terms and link to docs.github.com. |
| 5 | + Historic note: previous version checked the file path. Previous version checked the front matter formatting. |
| 6 | +--> |
| 7 | + |
| 8 | +## Step 4: Create a blog post |
| 9 | + |
| 10 | +_Your home page is looking great! :cowboy_hat_face:_ |
| 11 | + |
| 12 | +GitHub 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. |
| 13 | + |
| 14 | +**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: |
| 15 | + |
| 16 | +```yml |
| 17 | +--- |
| 18 | +title: "Welcome to my blog" |
| 19 | +date: 2019-01-20 |
| 20 | +--- |
| 21 | +``` |
| 22 | + |
| 23 | +For more information about configuring front matter, see the [Jekyll frontmatter documentation](https://jekyllrb.com/docs/frontmatter/). |
| 24 | + |
| 25 | +### :keyboard: Activity: Create a blog post |
| 26 | + |
| 27 | +1. Browse to the `my-pages` branch. |
| 28 | +1. Click the `Add file` dropdown menu and then on `Create new file`. |
| 29 | +1. Name the file `_posts/YYYY-MM-DD-title.md`. |
| 30 | +1. Replace the `YYYY-MM-DD` with today's date, and change the `title` of your first blog post if you'd like. |
| 31 | + > If you do edit the title, make sure there are hyphens between your words. |
| 32 | + > 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)". |
| 33 | +1. Type the following content at the top of your blog post: |
| 34 | + ```yaml |
| 35 | + --- |
| 36 | + title: "YOUR-TITLE" |
| 37 | + date: YYYY-MM-DD |
| 38 | + --- |
| 39 | + ``` |
| 40 | +1. Replace `YOUR-TITLE` with the title for your blog post. |
| 41 | +1. Replace `YYYY-MM-DD` with today's date. |
| 42 | +1. Type a quick draft of your blog post. Remember, you can always edit it later. |
| 43 | +1. Commit your changes to your branch. |
| 44 | +1. Wait about 20 seconds then refresh this page (the one you're following instructions from). [GitHub Actions](https://docs.github.com/en/actions) will automatically update to the next step. |
0 commit comments