Minimal setup with github pages
-
Fork the repository of this blog (note: this repository per default uses github actions which are only free for public repositories)
-
In your repository settings, set up github pages to deploy using github actions (SETTINGS -> PAGES -> SOURCE: Github Actions)
-
Your blog should be live in about 1 minute at
https://<your-github-username>.github.io/<your-repo-name>
For editing the blog you can either edit the code directly or use the preconfigured pagescms.
Editing with pagescms
-
Go to pagescms and log in with your github account and authorize the app.
-
Add your repository to pagescms and open it.
-
Now you can edit your website configuration, about page, description and blog posts directly in the browser.
-
Your changes will be automatically pushed to your repository and deployed to github pages in about 1 minute everytime you hit save.
Editing the code
-
Set up your blog info in
src/config.json
(leaving SITE, BASE, and MANUAL_SITE_BASE, as they are). -
Add your blog posts in
src/content/blog/
-
Add your info in
src/content/info/
:
description.md
is used for the homepage descriptionabout.md
is used for the about page