docs: add readme.
This commit is contained in:
parent
0c5dafc1a1
commit
c660d4b64e
60
README.md
60
README.md
@ -1,2 +1,60 @@
|
||||
# astro-uploader
|
||||
# Astro Uploader
|
||||
|
||||
A uploader for uploading the Astro generated files through the S3 API.
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# Use npm
|
||||
npm install -D astro-uploader
|
||||
|
||||
# Use pnpm
|
||||
pnpm add -D astro-uploader
|
||||
|
||||
# Use yarn
|
||||
yarn add -D astro-uploader
|
||||
```
|
||||
|
||||
```ts
|
||||
// astro.config.ts
|
||||
import { defineConfig } from 'astro/config'
|
||||
import { uploader, type Options } from 'astro-uploader'
|
||||
|
||||
export default defineConfig({
|
||||
integrations: [
|
||||
uploader({
|
||||
paths: ['images', 'og', 'cats'],
|
||||
endpoint: process.env.S3_ENDPOINT,
|
||||
bucket: process.env.S3_BUCKET as string,
|
||||
accessKey: process.env.S3_ACCESS_KEY as string,
|
||||
secretAccessKey: process.env.S3_SECRET_ACCESS_KEY as string,
|
||||
}),
|
||||
],
|
||||
})
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
```ts
|
||||
type Options = {
|
||||
// The directories that you want to upload to S3.
|
||||
paths: string[];
|
||||
// Whether to keep the original files after uploading.
|
||||
keep?: boolean;
|
||||
// Whether to override the existing files on S3.
|
||||
// It will be override only when the content-length don't match the file size by default.
|
||||
override?: boolean;
|
||||
// The S3 region, set it if you use AWS S3 service.
|
||||
region?: string;
|
||||
// The endpoint, set it if you use 3rd-party S3 service.
|
||||
endpoint?: string;
|
||||
// The name of the bucket.
|
||||
bucket: string;
|
||||
// The root directory you want to upload files.
|
||||
root?: string;
|
||||
// The access key id.
|
||||
accessKey: string;
|
||||
// The secret access key.
|
||||
secretAccessKey: string;
|
||||
};
|
||||
```
|
||||
|
Loading…
Reference in New Issue
Block a user