{"id":15062321,"url":"https://github.com/sakkyoi/deploy-satro","last_synced_at":"2026-01-03T11:19:45.556Z","repository":{"id":257120539,"uuid":"856804816","full_name":"sakkyoi/deploy-satro","owner":"sakkyoi","description":"A template to deploy your site of satro https://github.com/sakkyoi/satro","archived":false,"fork":false,"pushed_at":"2024-09-17T07:28:50.000Z","size":3323,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T17:12:25.874Z","etag":null,"topics":["astro","cloudflare-pages","deployment","toturial"],"latest_commit_sha":null,"homepage":"https://satro-example.pages.dev","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sakkyoi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-09-13T08:34:25.000Z","updated_at":"2024-09-17T07:28:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"292da06f-b165-4ae1-bfe0-9ceca7ed7c93","html_url":"https://github.com/sakkyoi/deploy-satro","commit_stats":null,"previous_names":["sakkyoi/deploy-satro"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakkyoi%2Fdeploy-satro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakkyoi%2Fdeploy-satro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakkyoi%2Fdeploy-satro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakkyoi%2Fdeploy-satro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sakkyoi","download_url":"https://codeload.github.com/sakkyoi/deploy-satro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243826826,"owners_count":20354220,"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":["astro","cloudflare-pages","deployment","toturial"],"created_at":"2024-09-24T23:34:24.217Z","updated_at":"2026-01-03T11:19:45.518Z","avatar_url":"https://github.com/sakkyoi.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# deploy-satro\n\n## Description\n\nSatro is a ready-to-use static site generator that is built with [Astro](https://astro.build/). This repository is a template that you can use to deploy your site of [satro](https://github.com/sakkyoi/satro) to various platforms.\n\n## Prerequisites\n\n- [Deploy to Cloudflare Pages](./deploy-cloudflare.md)\n- [Deploy to GitHub Pages](./deploy-github.md)\n\n### Workflow not being run on forked repository\n\nYou may have noticed that the workflow isn't being run on your forked repository. This is because of security reasons. You can enable the workflow by just clicking on the `I understand my workflows, go ahead and enable them` button as shown below.\n![Workflow aren't being run on this forked repository](./image/github-workflow-arent-being-run-on-this-forked-repository.png)\n\n### Workflow dispatch\n\nThe workflow files provided in this repository are not triggered by push in default. You can trigger the workflow by using the `workflow_dispatch` event. You can find the `workflow_dispatch` event in the Actions tab of your repository.\n\n![workflow_dispatch event](./image/github-workflow-dispatch-event.png)\n\nOr you can remove the comment from the workflow file to trigger the workflow on push.\n\n```diff\non:\n  workflow_dispatch:\n- # push:\n- #   branches: [ \"main\" ]\n+ push:\n+   branches: [ \"main\" ]\n```\n\n## Configure site\n\nAssuming you have already setting up the deploy workflow (including those environment variables starting with `SITE_`) mentioned in the [Prerequisites](#prerequisites) section.\n\n### Announcement\n\nYou can create an announcement by creating a file in the `announcement` directory. Head to the [`announcement`](./announcement/) directory to find out more.\n\n### Footer\n\nYou can create links or scripts in the footer by creating a file in the `footer` directory. Head to the [`footer`](./footer/) directory to find out more.\n\nThe icon attributes are using [Iconify](https://icon-sets.iconify.design/).\n\n\u003e **Note**: External scripts are allowed, for example, please refer to [footer/0_script-jquery.mdx](./footer/0_script-jquery.mdx).\n\u003e\n\u003e **Additionally**: The order of links and scripts is based on the file name, so you can prefix the file name with a number to set the order (e.g. `0_`, `1_`, `2_`, etc).\n\n### Thumbnail, favicon and anything\n\nYou can put your thumbnail, favicon, or anything in the [`public`](./public/) directory which will be copied to the root of the site.\n\n\u003e **Note**: You can put your `thumbnail`, `favicon` in several formats simultaneously. But only one file will be used, which is randomly selected in the build process.\n\n### Redirects\n\nRedirects are available if you are deploying to Cloudflare Pages. You can create a file name `_redirects`(in this template, it's already created and will be automatically copied to the `public` directory) and follow the [Redirects](https://developers.cloudflare.com/pages/configuration/redirects/) documentation.\n\n## Start authoring\n\n### Article and image\n\nYou can create an article by creating a file in the `article` directory. Head to the [`article`](./article/) directory to find out more.\n\n\u003e **Note**: Path to the image in the article is not relativity, please start with `/` and put the image under the `image` directory. (sub directory is allowed)\n\n### About code block\n\nCode block in the article is using [Expressive Code](https://expressive-code.com/), you can find out more in their documentation.\n\n\u003e **Note**: `pluginCollapsibleSections` plugin is installed by default.\n\n## Next steps\n\nCongratulations! You have successfully completed the setup of your site. You can now start authoring your site, and don't forget to remove the those example files in the `announcement`, `footer`, `public`, and `article` directories.\n\n## Something notable\n\nDetails about Astro, please refer to the [Astro documentation](https://docs.astro.build/).\n\nFeel free to forked [satro](https://github.com/sakkyoi/satro) and modify it to suit your needs.\n\n## Demo article\n\nThe live demo about how to authoring your content. [Example](https://satro-example.pages.dev/article/example/)\n\n## License\n\nThis project is licensed under the LGPLv3 License - see the [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsakkyoi%2Fdeploy-satro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsakkyoi%2Fdeploy-satro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsakkyoi%2Fdeploy-satro/lists"}