An open API service indexing awesome lists of open source software.

https://github.com/playform/document

Documentβ€πŸ“ƒ
https://github.com/playform/document

document documentation javascript playform typedoc typescript

Last synced: 20 days ago
JSON representation

Documentβ€πŸ“ƒ

Awesome Lists containing this project

README

          

TypeScript

Related

Build
Dependency
Version
Star
Download
πŸ”§ Maintain β€” Build
Dependency
Version
Star
Download
πŸ—» Format β€”

# [Document]β€πŸ“ƒ

This **[`CLI tool`][Document]** brings TypeDoc documentation generation to your
TypeScript project.

[`typedoc`][typedoc]β€πŸŽ

[`typedoc-plugin-keywords`][typedoc-plugin-keywords]β€πŸŽ

[`typedoc-plugin-mdn-links`][typedoc-plugin-mdn-links]β€πŸŽ

[`typedoc-plugin-merge-modules`][typedoc-plugin-merge-modules]β€πŸŽ

[`typedoc-plugin-remove-references`][typedoc-plugin-remove-references]β€πŸŽ

[`typedoc-plugin-rename-defaults`][typedoc-plugin-rename-defaults]β€πŸŽ

[`typedoc-plugin-zod`][typedoc-plugin-zod]β€πŸŽ

> **Note**
>
> `Document` is git-aware β€” it reads the current branch and remote to generate
> correct source links in the documentation.

## Installationβ€πŸš€

There are two ways to add `Document` to your project. Let's try the most
convenient option first!

### Install as a dev dependency

Using NPM:

```sh
npm install -D -E @playform/document
```

Using Yarn:

```sh
yarn add -D -E @playform/document
```

Using PNPM:

```sh
pnpm add -D -E @playform/document
```

### Run directly

Using NPM:

```sh
npx @playform/document 'Source/**/*.ts'
```

Using Yarn:

```sh
yarn dlx @playform/document 'Source/**/*.ts'
```

Using PNPM:

```sh
pnpx @playform/document 'Source/**/*.ts'
```

## Getting started

Add a `Document` script to your `package.json`:

**`package.json`**

```json
{
"scripts": {
"Document": "Document 'Source/**/*.ts'"
}
}
```

Then run it:

```sh
npm run Document
```

Documentation is written to `./Documentation` by default.

### Custom output folder

Use `--Folder` to write to a different directory:

```sh
Document 'Source/**/*.ts' --Folder docs
```

**`package.json`**

```json
{
"scripts": {
"Document": "Document 'Source/**/*.ts' --Folder docs"
}
}
```

### Multiple entry patterns

Pass additional glob patterns as extra arguments:

```sh
Document 'Source/**/*.ts' 'Test/**/*.ts'
```

[Document]: HTTPS://NPMJS.Org/@playform/document
[typedoc]: HTTPS://NPMJS.Org/typedoc
[typedoc-plugin-keywords]: HTTPS://NPMJS.Org/typedoc-plugin-keywords
[typedoc-plugin-mdn-links]: HTTPS://NPMJS.Org/typedoc-plugin-mdn-links
[typedoc-plugin-merge-modules]: HTTPS://NPMJS.Org/typedoc-plugin-merge-modules
[typedoc-plugin-remove-references]:
HTTPS://NPMJS.Org/typedoc-plugin-remove-references
[typedoc-plugin-rename-defaults]:
HTTPS://NPMJS.Org/typedoc-plugin-rename-defaults
[typedoc-plugin-zod]: HTTPS://NPMJS.Org/typedoc-plugin-zod

## Changelog

See [`CHANGELOG.md`](CHANGELOG.md) for a history of changes to this tool.