Skip to content

Commit 55e676e

Browse files
0.1.0 development
1 parent ca90ee3 commit 55e676e

4 files changed

Lines changed: 44 additions & 1 deletion

File tree

README.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,27 @@
11
# hugo-git-pages-starter
22
Starter pack for a Hugo Blog on GitHub Pages
33

4-
abc
4+
See the full guide for using this repo [here](https://commitconfirmed.github.io/posts/hugo-github-pages-starter/)
5+
6+
https://commitconfirmed.github.io/posts/hugo-github-pages-starter/
7+
8+
Try it out in codespaces
9+
10+
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/commitconfirmed/hugo-git-pages-starter?quickstart=1&devcontainer_path=.devcontainer%2Fdevcontainer.json)
11+
12+
13+
## TLDR
14+
15+
- Create a GitHub account
16+
- Create a new public repo called **username**.github.io replacing username your GitHub username
17+
- Clone this repo into your repo
18+
- Update the `~/site/hugo.toml` file with your own personal details
19+
- Update the `~/site/content/about/index.md` file with your own personal details
20+
- See the `~/site/content/posts/` directory for an example blog bost.
21+
- Create a new folder and `index.md` file to make your own blog post
22+
- Update your repos Settings/Pages to deploy using Github Actions and create a workflow using the provided `~/.github/workflows/hugo.yml` file
23+
- See the Hugo [Documentation](https://gohugo.io/host-and-deploy/host-on-github-pages/) for detailed instructions
24+
- Commit some changes and push to Main and your blog should now be available at https://username.github.io
25+
- (Optional) Apply any [Extras](https://commitconfirmed.github.io/posts/hugo-github-pages-starter/#extras)
26+
27+
Supports Local, Docker Compose or GitHub Codespaces development.

site/content/about/index.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
+++
2+
title = "About"
3+
description = "About Me"
4+
date = "2025-03-25"
5+
tags = [
6+
"personal",
7+
]
8+
categories = [
9+
"personal",
10+
]
11+
toc = false
12+
+++
13+
14+
# About header
15+
16+
About information

site/content/posts/intro/images/hugo-title.svg

Lines changed: 3 additions & 0 deletions
Loading

site/content/posts/intro/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ categories = [
1212
"hugo",
1313
]
1414
series = ["Hugo"]
15+
image = "images/hugo-title.svg"
1516
+++
1617

1718
## Blog header

0 commit comments

Comments
 (0)