Skip to content

Commit

Permalink
docs(readme): add config file instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
bartholomej committed Mar 27, 2022
1 parent 78584b5 commit de38f18
Show file tree
Hide file tree
Showing 2 changed files with 39 additions and 11 deletions.
43 changes: 39 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,30 @@ npm install svelte-sitemap --save-dev

## Usage

### CLI method (recommended)
### Config file method (recommended)

Create config file `svelte-sitemap.cjs` in the root of your project:

`svelte-sitemap.cjs`

```js
module.exports = {
domain: 'https://www.example.com'
// ...more options
};
```

Add `svelte-sitemap` as your postbuild script in `package.json` file:

`package.json`

```json
{
"postbuild": "npx svelte-sitemap"
}
```

### CLI method (Alternative 1)

Use this script as a **postbuild hook**. See this [example](#example).

Expand All @@ -30,7 +53,7 @@ npx svelte-sitemap --domain https://example.com

It scans your routes in `build/` folder and generates `build/sitemap.xml` file

### Alternative: TypeScript or JavaScript method
### Alternative 1: TypeScript or JavaScript method

Sometimes it can be useful to call the script directly from JavaScript or TypeScript. Of course there is also this option, but in most cases you will need the [CLI method](#cli-method-recommended) as a postbuild hook.

Expand All @@ -46,17 +69,28 @@ And now you can run your script like this: `node my-script.js`

## Example

Use this library as a `postbuild` hook in your `package.json`
Use this library as a `postbuild` hook in your `package.json` with config file `svelte-sitemap.cjs` in your project root.

File: `package.json`

```json
{
"name": "my-project",
"scripts": {
"postbuild": "npx svelte-sitemap --domain https://mydomain.com"
"postbuild": "npx svelte-sitemap"
}
}
```

File: `svelte-sitemap.cjs`

```typescript
module.exports = {
domain: 'https://www.example.com',
trailingSlashes: true
};
```

## ⚙️ Options

| Option | Description | default | example |
Expand Down Expand Up @@ -138,6 +172,7 @@ yarn demo
- svelte-sitemap is workaround for [this official SvelteKit issue](https://github.com/sveltejs/kit/issues/1142)
- Brand new version is inspired by [Richard's article](https://r-bt.com/learning/sveltekit-sitemap/)
- Thanks to [@auderer](https://github.com/auderer) because [his issue](https://github.com/bartholomej/svelte-sitemap/issues/1) changed the direction of this library
- Config files inspired by [next-sitemap](https://github.com/iamvishnusankar/next-sitemap)

## 📝 License

Expand Down
7 changes: 0 additions & 7 deletions src/vars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,3 @@ export const DOMAIN = 'https://example.com';
export const OUT_DIR = 'build';

export const CONFIG_FILE = 'svelte-sitemap.cjs';

// export const OPTIONS: Options = {
// domain: DOMAIN,
// resetTime: false,
// debug: false,
// changeFreq: 'weekly'
// };

0 comments on commit de38f18

Please sign in to comment.