Skip to content

Commit 80a3f53

Browse files
committed
feat: astro document
1 parent 4b4eae0 commit 80a3f53

File tree

22 files changed

+3990
-209
lines changed

22 files changed

+3990
-209
lines changed

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,5 @@
33
logs/
44
/packages/core/dist/
55
/packages/**/node_modules/
6+
.vscode/
7+
.DS_Store

document/.gitignore

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# build output
2+
dist/
3+
# generated types
4+
.astro/
5+
6+
# dependencies
7+
node_modules/
8+
9+
# logs
10+
npm-debug.log*
11+
yarn-debug.log*
12+
yarn-error.log*
13+
pnpm-debug.log*
14+
15+
16+
# environment variables
17+
.env
18+
.env.production
19+
20+
# macOS-specific files
21+
.DS_Store

document/README.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# Starlight Starter Kit: Basics
2+
3+
[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
4+
5+
```
6+
npm create astro@latest -- --template starlight
7+
```
8+
9+
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
10+
[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
11+
[![Deploy with Vercel](https://vercel.com/button)](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)
12+
13+
> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
14+
15+
## 🚀 Project Structure
16+
17+
Inside of your Astro + Starlight project, you'll see the following folders and files:
18+
19+
```
20+
.
21+
├── public/
22+
├── src/
23+
│ ├── assets/
24+
│ ├── content/
25+
│ │ ├── docs/
26+
│ │ └── config.ts
27+
│ └── env.d.ts
28+
├── astro.config.mjs
29+
├── package.json
30+
└── tsconfig.json
31+
```
32+
33+
Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
34+
35+
Images can be added to `src/assets/` and embedded in Markdown with a relative link.
36+
37+
Static assets, like favicons, can be placed in the `public/` directory.
38+
39+
## 🧞 Commands
40+
41+
All commands are run from the root of the project, from a terminal:
42+
43+
| Command | Action |
44+
| :------------------------ | :----------------------------------------------- |
45+
| `npm install` | Installs dependencies |
46+
| `npm run dev` | Starts local dev server at `localhost:4321` |
47+
| `npm run build` | Build your production site to `./dist/` |
48+
| `npm run preview` | Preview your build locally, before deploying |
49+
| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
50+
| `npm run astro -- --help` | Get help using the Astro CLI |
51+
52+
## 👀 Want to learn more?
53+
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).

document/astro.config.mjs

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
import starlight from '@astrojs/starlight'
2+
import { defineConfig } from 'astro/config'
3+
import starlightTypeDoc, { typeDocSidebarGroup } from 'starlight-typedoc'
4+
5+
export default defineConfig({
6+
integrations: [
7+
starlight({
8+
plugins: [
9+
// Generate the documentation.
10+
starlightTypeDoc({
11+
entryPoints: ['../packages/core/src/index.ts'],
12+
tsconfig: '../packages/core/tsconfig.json',
13+
}),
14+
],
15+
sidebar: [
16+
{
17+
label: 'Guides',
18+
items: [{ label: 'Example Guide', link: '/guides/example/' }],
19+
},
20+
// Add the generated sidebar group to the sidebar.
21+
typeDocSidebarGroup,
22+
],
23+
title: 'My Docs',
24+
}),
25+
],
26+
})

document/package.json

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
{
2+
"name": "document",
3+
"type": "module",
4+
"version": "0.0.1",
5+
"scripts": {
6+
"dev": "astro dev",
7+
"start": "astro dev",
8+
"build": "astro check && astro build",
9+
"preview": "astro preview",
10+
"astro": "astro"
11+
},
12+
"dependencies": {
13+
"@astrojs/check": "^0.7.0",
14+
"@astrojs/starlight": "^0.24.5",
15+
"astro": "^4.10.2",
16+
"sharp": "^0.32.5",
17+
"starlight-typedoc": "^0.13.0",
18+
"typedoc": "^0.26.3",
19+
"typedoc-plugin-markdown": "^4.1.1",
20+
"typescript": "^5.5.3"
21+
}
22+
}

document/public/favicon.svg

Lines changed: 1 addition & 0 deletions
Loading

document/src/assets/houston.webp

96.2 KB
Loading

document/src/content/config.ts

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
import { defineCollection } from 'astro:content';
2+
import { docsSchema } from '@astrojs/starlight/schema';
3+
4+
export const collections = {
5+
docs: defineCollection({ schema: docsSchema() }),
6+
};
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
editUrl: false
3+
next: false
4+
prev: false
5+
title: "core"
6+
---
7+
8+
## Classes
9+
10+
- [CollaGrid](/api/classes/collagrid/)
11+
12+
## Interfaces
13+
14+
- [CollaGridOption](/api/interfaces/collagridoption/)
15+
16+
## Functions
17+
18+
- [createCollaGrid](/api/functions/createcollagrid/)
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
editUrl: false
3+
next: false
4+
prev: false
5+
title: "CollaGrid"
6+
---
7+
8+
## Constructors
9+
10+
### new CollaGrid()
11+
12+
> **new CollaGrid**(`option`): [`CollaGrid`](/api/classes/collagrid/)
13+
14+
#### Parameters
15+
16+
**option**: [`CollaGridOption`](/api/interfaces/collagridoption/)
17+
18+
#### Returns
19+
20+
[`CollaGrid`](/api/classes/collagrid/)
21+
22+
#### Defined in
23+
24+
[index.ts:21](https://github.com/collagrid/Collagrid/blob/3ab53a2129dce66dabded680a42e74d77a46d39a/packages/core/src/index.ts#L21)
25+
26+
## Methods
27+
28+
### mount()
29+
30+
> **mount**(`domId`): `void`
31+
32+
#### Parameters
33+
34+
**domId**: `string`
35+
36+
#### Returns
37+
38+
`void`
39+
40+
#### Defined in
41+
42+
[index.ts:44](https://github.com/collagrid/Collagrid/blob/3ab53a2129dce66dabded680a42e74d77a46d39a/packages/core/src/index.ts#L44)

0 commit comments

Comments
 (0)