|
1 |
| -# Starlight Starter Kit: Basics |
| 1 | +# Gin website |
2 | 2 |
|
3 |
| -[](https://starlight.astro.build) |
| 3 | +[](https://github.com/gin-gonic/website/actions/workflows/node.yml) |
4 | 4 |
|
5 |
| -``` |
6 |
| -npm create astro@latest -- --template starlight |
7 |
| -``` |
| 5 | +Welcome! This repository houses all the assets required to build the Gin website and documentation. We're pleased that you want to contribute! The website is hosted at https://gin-gonic.com. |
| 6 | + |
| 7 | +We use [Astro](https://astro.build) to format and generate our website, the [Starlight](https://starlight.astro.build) template for styling and site structure. Thanks!. |
| 8 | + |
| 9 | +## Contribution |
| 10 | + |
| 11 | +- Fork the repository |
| 12 | + |
| 13 | +You can click the Fork button in the upper-right area of the screen to create a copy of this repository in your GitHub account. This copy is called as fork. |
| 14 | + |
| 15 | +- Create one pull request |
8 | 16 |
|
9 |
| -[](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics) |
10 |
| -[](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics) |
11 |
| -[](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics) |
12 |
| -[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs) |
| 17 | +Make any changes you want in your fork, and when you are ready to send those changes to us, go to your fork and create a new pull request to let us know about it. |
| 18 | + |
| 19 | +- Merge the pull request |
| 20 | + |
| 21 | +Once your pull request is created, a Gin reviewer will take responsibility for providing clear, actionable feedback, re-improve and merge. |
| 22 | + |
| 23 | +## Running |
| 24 | + |
| 25 | +See the [official Astro documentation](https://docs.astro.build/en/getting-started) for Astro installation instructions. and [Starlight documentation](https://starlight.astro.build/getting-started) for Starlight installation instructions. |
| 26 | + |
| 27 | +To run the site locally when you have Hugo installed: |
| 28 | + |
| 29 | +```sh |
| 30 | +npm install |
| 31 | +npm run dev |
| 32 | +``` |
13 | 33 |
|
14 |
| -> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun! |
| 34 | +This will start the local Astro server on port 4321. Open up your browser to http://localhost:4321 to view the site. As you make changes to the source files, Astro updates the site and forces a browser refresh. |
15 | 35 |
|
16 | 36 | ## 🚀 Project Structure
|
17 | 37 |
|
@@ -49,6 +69,6 @@ All commands are run from the root of the project, from a terminal:
|
49 | 69 | | `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
|
50 | 70 | | `npm run astro -- --help` | Get help using the Astro CLI |
|
51 | 71 |
|
52 |
| -## 👀 Want to learn more? |
| 72 | +## Thanks |
53 | 73 |
|
54 |
| -Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat). |
| 74 | +Gin thrives on community participation, and we really appreciate your contributions to our site and our documentation! |
0 commit comments