https://github.com/zevorn/blog
https://github.com/zevorn/blog
Last synced: 14 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/zevorn/blog
- Owner: zevorn
- Created: 2024-05-19T16:20:05.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-15T09:04:40.000Z (24 days ago)
- Last Synced: 2026-05-15T11:25:37.671Z (24 days ago)
- Language: JavaScript
- Homepage: https://zevorn.cn
- Size: 1.03 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# zevorn.blog
Personal technical blog built with [Hugo](https://gohugo.io/) and the
[PaperMod](https://github.com/adityatelange/hugo-PaperMod) theme.
Articles are sourced from this repository's GitHub Discussions. The deployment
workflow exports discussions into Hugo Markdown files, builds the static site,
and publishes it to GitHub Pages.
## Local build
Export discussions and run the local development server:
```bash
npm run sync:discussions
hugo server
```
`GITHUB_TOKEN` is optional for public repositories. Set it when you need higher
API limits or private repository access.
To copy remote discussion images into `static/images/discussions`, run:
```bash
BLOG_DOWNLOAD_IMAGES=true npm run sync:discussions
```
Build production output:
```bash
npm run build
```
## Deployment
GitHub Actions builds and deploys the site through GitHub Pages:
- Source: GitHub Discussions in `zevorn/blog`
- Static generator: Hugo
- Theme: PaperMod through Hugo Modules
- Output: GitHub Pages artifact
Repository Pages settings must use **GitHub Actions** as the publishing source.
The workflow caches exported Markdown between runs. Discussion create/edit/delete
events update only the affected `content/posts/.md` file when a cached or
committed export already exists; push, label, and manual runs still perform a
full discussion export.