83 lines
2.8 KiB
Markdown
83 lines
2.8 KiB
Markdown
# Hugo Unified Git Activity
|
|
|
|
|
|
|
|
>Maintain bathroom tile developer status when working in multiple git hubs.
|
|
|
|
This repo provides:
|
|
|
|
1. A Go command (at `./get_history`) that fetches git activity from Github, Gitlab, and Forgejo
|
|
2. A Hugo partial and shortcode that generates a git styled heatmap from it
|
|
|
|
## Dependencies
|
|
|
|
- Go
|
|
- Hugo
|
|
|
|
## User Guide
|
|
|
|
### Running activity collection
|
|
|
|
To run the go script to get activity history you can just do
|
|
|
|
```bash
|
|
go run forge.alexselimov.com/aselimov/hugo-unified-git-activity/get_history@latest -o /path/to/hugo/static
|
|
```
|
|
|
|
This requires the following environment variables to be defined:
|
|
|
|
```bash
|
|
GH_API_KEY=
|
|
FJ_API_KEY=
|
|
FJ_USER=
|
|
FJ_URL= //Optional: defaults to codeberg.org
|
|
GL_API_KEY= //Optional: default to gitlab.com
|
|
GL_USER=
|
|
GL_URL=
|
|
```
|
|
|
|
Environment variables can be placed in a .env script wherever you are running the go command from.
|
|
If you don't define environment variables, it will just skip that hub.
|
|
Example, if any `FJ_*` variable is undefined then the forgejo portion will be skipped.
|
|
|
|
|
|
### Hugo shortcode
|
|
|
|
First add this module to your hugo.toml
|
|
|
|
```toml
|
|
# edit hugo.toml
|
|
[module]
|
|
[[module.imports]]
|
|
path = 'forge.alexselimov.com/aselimov/hugo-unified-git-activity'
|
|
```
|
|
|
|
Then run `hugo mod get -u` to pull the latest version.
|
|
You should now be able to add the heatmap to your site using either a shortcode in the markdown, e.g.
|
|
|
|
```
|
|
{{< git-heatmap >}}
|
|
```
|
|
|
|
or as a partial to your html templates:
|
|
|
|
```
|
|
{{ partial "git-heatmap.html" . }}
|
|
```
|
|
|
|
### Keeping activity in-sync
|
|
|
|
I host my site (and some other self-hosted stuff) on a Vultr vps.
|
|
To keep my activity in sync, I just set up a cron job that does:
|
|
|
|
```cron
|
|
*/30 * * * * go run forge.alexselimov.com/aselimov/hugo-unified-git-activity/get_history@latest -o /var/www/alexselimov.com/activity.json
|
|
```
|
|
|
|
If you aren't on a VPS and using actions to deploy your site ([That's how I deploy my personal blog](https://forge.alexselimov.com/aselimov/AlexSelimov.com/src/branch/master/.forgejo/workflows/build_and_deploy_site.yml)), you can just add an action to update your `static/activity.json` and deploy however often you want.
|
|
|
|
## Important Notes
|
|
|
|
- I originally wrote it in Typescript but thought go would be better to distribute to Hugo users (since you probably already have go installed) **so the go version is a completely vibed port**. I didn't look at the code, but it's probably fine? I did verify it's not sending credentials anywhere at least haha.
|
|
- Private repo contributions are tracked, but they are anonymized in the activity.json. It shows up as `"private": "<count>"`.
|
|
- I added Gitlab functionality but I don't use Gitlab so it may have issues. I set up a test account and did a quick test to make sure a new commit showed up, but good likelihood of edge cases.
|