diff options
| -rw-r--r-- | .changeset/serious-fishes-lay.md | 5 | ||||
| -rw-r--r-- | docs/src/pages/guides/deploy.md | 2 |
2 files changed, 7 insertions, 0 deletions
diff --git a/.changeset/serious-fishes-lay.md b/.changeset/serious-fishes-lay.md new file mode 100644 index 000000000..c619513dc --- /dev/null +++ b/.changeset/serious-fishes-lay.md @@ -0,0 +1,5 @@ +--- +'docs': patch +--- + +Github pages disclaimer diff --git a/docs/src/pages/guides/deploy.md b/docs/src/pages/guides/deploy.md index e5e3db1c9..de98b9e3f 100644 --- a/docs/src/pages/guides/deploy.md +++ b/docs/src/pages/guides/deploy.md @@ -31,6 +31,8 @@ By default, the build output will be placed at `dist/`. You may deploy this `dis ## GitHub Pages +> **Warning:** By default, Github Pages will break the `_astro/` directory of your deployed website. To disable this behavior and fix your this issue, make sure that you use the `deploy.sh` script below or manually add an empty `.nojekyll` file to your `public/` site directory. + 1. Set the correct `buildOptions.site` in `astro.config.mjs`. 1. Inside your project, create `deploy.sh` with the following content (uncommenting the appropriate lines), and run it to deploy: |