{"id":16021944,"url":"https://github.com/kemingy/isite","last_synced_at":"2025-08-20T05:18:15.086Z","repository":{"id":193492550,"uuid":"687789124","full_name":"kemingy/isite","owner":"kemingy","description":"convert issues to a website","archived":false,"fork":false,"pushed_at":"2025-06-10T09:37:10.000Z","size":102,"stargazers_count":26,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-10T10:41:27.098Z","etag":null,"topics":["blog-generator","github-issues","ssg","zola"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kemingy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["kemingy"]}},"created_at":"2023-09-06T02:25:14.000Z","updated_at":"2025-06-10T09:37:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"cfba6ac6-dc47-4ad7-b0a8-d8d4c9d27e1d","html_url":"https://github.com/kemingy/isite","commit_stats":{"total_commits":33,"total_committers":3,"mean_commits":11.0,"dds":"0.18181818181818177","last_synced_commit":"117d1c5a005f39bfc92be9fdfadc03b3387bc5dd"},"previous_names":["kemingy/isite"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/kemingy/isite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kemingy%2Fisite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kemingy%2Fisite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kemingy%2Fisite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kemingy%2Fisite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kemingy","download_url":"https://codeload.github.com/kemingy/isite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kemingy%2Fisite/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262520765,"owners_count":23323765,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog-generator","github-issues","ssg","zola"],"created_at":"2024-10-08T18:06:32.802Z","updated_at":"2025-06-29T01:37:50.178Z","avatar_url":"https://github.com/kemingy.png","language":"Go","funding_links":["https://github.com/sponsors/kemingy"],"categories":["Go"],"sub_categories":[],"readme":"# isite\n\n[![Go](https://github.com/kemingy/isite/actions/workflows/go.yml/badge.svg)](https://github.com/kemingy/isite/actions/workflows/go.yml)\n\nConvert GitHub **i**ssues to a web**site**.\n\n## Examples\n\n- https://github.com/kemingy/withcode ➡️ https://kemingy.github.io/withcode/\n- https://github.com/yihong0618/gitblog ➡️ https://blog.yihong0618.me/\n\n## Usage\n\n```bash\nisite generate --help\n```\n\nAfter generating the Markdown based documents, you can build the website with the following engines.\n\n## Engines\n\n- [x] [zola](https://github.com/getzola/zola)\n  - default theme: [Even](https://github.com/kemingy/even), modified to support comments and reactions\n- [ ] [hugo](https://github.com/gohugoio/hugo)\n\n## Installation\n\n- GitHub Releases: download the pre-built binaries from the [releases](https://github.com/kemingy/isite/releases) page.\n- Docker Image: [`docker pull ghcr.io/kemingy/isite`](https://github.com/kemingy/isite/pkgs/container/isite)\n\n## GitHub Actions\n\n\u003e [!IMPORTANT]\n\u003e Please remember to enable the GitHub Pages with GitHub Actions as the source.\n\nYou can audit and apply the following GitHub Actions workflow to deploy the static content generated by `isite` to GitHub Pages.\n\n```yaml\nname: Deploy static content to Pages\n\non:\n  issues:\n    types:\n      - opened\n      - edited\n      - closed\n      - reopened\n      - labeled\n      - unlabeled\n  issue_comment:\n    types:\n      - created\n      - edited\n      - deleted\n  workflow_dispatch:\n\n# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages\npermissions:\n  contents: read\n  pages: write\n  id-token: write\n\nconcurrency:\n  group: ${{ github.workflow }}\n  cancel-in-progress: true\n\njobs:\n  deploy:\n    environment:\n      name: github-pages\n      url: ${{ steps.deployment.outputs.page_url }}\n    runs-on: ubuntu-latest\n    env:\n      GH_TOKEN: ${{ github.token }}\n      # bump the versions here\n      ISITE_VERSION: v0.2.2\n      ZOLA_VERSION: v0.20.0\n      USER: ${{ github.repository_owner }}\n      REPO: ${{ github.event.repository.name }}\n      # change this to your custom domain name\n      BASE_URL: https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}\n    steps:\n      - name: Checkout\n        uses: actions/checkout@v4\n      - name: Generate markdown\n        run: |\n          gh release download $ISITE_VERSION --repo kemingy/isite -p '*Linux_x86_64*' -O- | tar -xz -C /tmp \u0026\u0026 mv /tmp/isite /usr/local/bin\n          isite generate --user $USER --repo $REPO\n          gh release download $ZOLA_VERSION --repo getzola/zola -p '*x86_64-unknown-linux*' -O- | tar -xz -C /tmp \u0026\u0026 mv /tmp/zola /usr/local/bin\n          cd output \u0026\u0026 zola build --base-url $BASE_URL\n      - name: Setup Pages\n        uses: actions/configure-pages@v5\n      - name: Upload artifact\n        uses: actions/upload-pages-artifact@v3\n        with:\n          path: 'output/public'\n      - name: Deploy to GitHub Pages\n        id: deployment\n        uses: actions/deploy-pages@v4\n```\n\n## Customization\n\n### Domain name\n\nChange the `BASE_URL` in the GitHub Actions workflow to your custom domain name.\n\n### Other themes\n\n```bash\nisite generate --theme \u003ctheme_name\u003e --theme-repo \u003cuser/repo\u003e\n```\n\n### Backup Markdown files to the Repo\n\n```yaml\n- name: backup markdown files\n  env:\n    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n  run: |\n    git config user.name \"GitHub Actions Bot\"\n    git config user.email \"github-actions@users.noreply.github.com\"\n    git checkout -b backup\n    git add output/content\n    git commit -m \"Backup markdown files\"\n    git push --force origin backup\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkemingy%2Fisite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkemingy%2Fisite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkemingy%2Fisite/lists"}