mirror of
https://github.com/mermaid-js/mermaid.git
synced 2025-11-19 20:24:16 +01:00
Update docs
This commit is contained in:
13
docs/config/setup/README.md
Normal file
13
docs/config/setup/README.md
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
> **Warning**
|
||||||
|
>
|
||||||
|
> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
|
||||||
|
>
|
||||||
|
> ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/setup/README.md](../../../packages/mermaid/src/docs/config/setup/README.md).
|
||||||
|
|
||||||
|
# mermaid
|
||||||
|
|
||||||
|
## Modules
|
||||||
|
|
||||||
|
- [config](modules/config.md)
|
||||||
|
- [defaultConfig](modules/defaultConfig.md)
|
||||||
|
- [mermaidAPI](modules/mermaidAPI.md)
|
||||||
276
docs/config/setup/modules/config.md
Normal file
276
docs/config/setup/modules/config.md
Normal file
@@ -0,0 +1,276 @@
|
|||||||
|
> **Warning**
|
||||||
|
>
|
||||||
|
> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
|
||||||
|
>
|
||||||
|
> ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/setup/modules/config.md](../../../../packages/mermaid/src/docs/config/setup/modules/config.md).
|
||||||
|
|
||||||
|
# Module: config
|
||||||
|
|
||||||
|
## Variables
|
||||||
|
|
||||||
|
### defaultConfig
|
||||||
|
|
||||||
|
• `Const` **defaultConfig**: `MermaidConfig`
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:7](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L7)
|
||||||
|
|
||||||
|
## Functions
|
||||||
|
|
||||||
|
### addDirective
|
||||||
|
|
||||||
|
▸ **addDirective**(`directive`): `void`
|
||||||
|
|
||||||
|
Pushes in a directive to the configuration
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type | Description |
|
||||||
|
| :---------- | :---- | :----------------------- |
|
||||||
|
| `directive` | `any` | The directive to push in |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`void`
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:191](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L191)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### getConfig
|
||||||
|
|
||||||
|
▸ **getConfig**(): `MermaidConfig`
|
||||||
|
|
||||||
|
## getConfig
|
||||||
|
|
||||||
|
| Function | Description | Type | Return Values |
|
||||||
|
| --------- | ------------------------- | ----------- | ------------------------------ |
|
||||||
|
| getConfig | Obtains the currentConfig | Get Request | Any Values from current Config |
|
||||||
|
|
||||||
|
**Notes**: Returns **any** the currentConfig
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`MermaidConfig`
|
||||||
|
|
||||||
|
The currentConfig
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:137](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L137)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### getSiteConfig
|
||||||
|
|
||||||
|
▸ **getSiteConfig**(): `MermaidConfig`
|
||||||
|
|
||||||
|
## getSiteConfig
|
||||||
|
|
||||||
|
| Function | Description | Type | Values |
|
||||||
|
| ------------- | ------------------------------------------------- | ----------- | -------------------------------- |
|
||||||
|
| setSiteConfig | Returns the current siteConfig base configuration | Get Request | Returns Any Values in siteConfig |
|
||||||
|
|
||||||
|
**Notes**: Returns **any** values in siteConfig.
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`MermaidConfig`
|
||||||
|
|
||||||
|
The siteConfig
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:96](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L96)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### reset
|
||||||
|
|
||||||
|
▸ **reset**(`config?`): `void`
|
||||||
|
|
||||||
|
## reset
|
||||||
|
|
||||||
|
| Function | Description | Type | Required | Values |
|
||||||
|
| -------- | ---------------------------- | ----------- | -------- | ------ |
|
||||||
|
| reset | Resets currentConfig to conf | Put Request | Required | None |
|
||||||
|
|
||||||
|
## conf
|
||||||
|
|
||||||
|
| Parameter | Description | Type | Required | Values |
|
||||||
|
| --------- | -------------------------------------------------------------- | ---------- | -------- | -------------------------------------------- |
|
||||||
|
| conf | base set of values, which currentConfig could be **reset** to. | Dictionary | Required | Any Values, with respect to the secure Array |
|
||||||
|
|
||||||
|
**Notes**: (default: current siteConfig ) (optional, default `getSiteConfig()`)
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type | Default value | Description |
|
||||||
|
| :------- | :-------------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||||
|
| `config` | `MermaidConfig` | `siteConfig` | base set of values, which currentConfig could be **reset** to. Defaults to the current siteConfig (e.g returned by [getSiteConfig](config.md#getsiteconfig)). |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`void`
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:223](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L223)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### sanitize
|
||||||
|
|
||||||
|
▸ **sanitize**(`options`): `void`
|
||||||
|
|
||||||
|
## sanitize
|
||||||
|
|
||||||
|
| Function | Description | Type | Values |
|
||||||
|
| -------- | -------------------------------------- | ----------- | ------ |
|
||||||
|
| sanitize | Sets the siteConfig to desired values. | Put Request | None |
|
||||||
|
|
||||||
|
Ensures options parameter does not attempt to override siteConfig secure keys **Notes**: modifies
|
||||||
|
options in-place
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type | Description |
|
||||||
|
| :-------- | :---- | :-------------------------------- |
|
||||||
|
| `options` | `any` | The potential setConfig parameter |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`void`
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:152](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L152)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### saveConfigFromInitialize
|
||||||
|
|
||||||
|
▸ **saveConfigFromInitialize**(`conf`): `void`
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type |
|
||||||
|
| :----- | :-------------- |
|
||||||
|
| `conf` | `MermaidConfig` |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`void`
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:75](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L75)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### setConfig
|
||||||
|
|
||||||
|
▸ **setConfig**(`conf`): `MermaidConfig`
|
||||||
|
|
||||||
|
## setConfig
|
||||||
|
|
||||||
|
| Function | Description | Type | Values |
|
||||||
|
| ------------- | ------------------------------------- | ----------- | --------------------------------------- |
|
||||||
|
| setSiteConfig | Sets the siteConfig to desired values | Put Request | Any Values, except ones in secure array |
|
||||||
|
|
||||||
|
**Notes**: Sets the currentConfig. The parameter conf is sanitized based on the siteConfig.secure
|
||||||
|
keys. Any values found in conf with key found in siteConfig.secure will be replaced with the
|
||||||
|
corresponding siteConfig value.
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type | Description |
|
||||||
|
| :----- | :-------------- | :-------------------------- |
|
||||||
|
| `conf` | `MermaidConfig` | The potential currentConfig |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`MermaidConfig`
|
||||||
|
|
||||||
|
The currentConfig merged with the sanitized conf
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:113](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L113)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### setSiteConfig
|
||||||
|
|
||||||
|
▸ **setSiteConfig**(`conf`): `MermaidConfig`
|
||||||
|
|
||||||
|
## setSiteConfig
|
||||||
|
|
||||||
|
| Function | Description | Type | Values |
|
||||||
|
| ------------- | ------------------------------------- | ----------- | --------------------------------------- |
|
||||||
|
| setSiteConfig | Sets the siteConfig to desired values | Put Request | Any Values, except ones in secure array |
|
||||||
|
|
||||||
|
**Notes:** Sets the siteConfig. The siteConfig is a protected configuration for repeat use. Calls
|
||||||
|
to reset() will reset the currentConfig to siteConfig. Calls to reset(configApi.defaultConfig)
|
||||||
|
will reset siteConfig and currentConfig to the defaultConfig Note: currentConfig is set in this
|
||||||
|
function _Default value: At default, will mirror Global Config_
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type | Description |
|
||||||
|
| :----- | :-------------- | :------------------------------------------ |
|
||||||
|
| `conf` | `MermaidConfig` | The base currentConfig to use as siteConfig |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`MermaidConfig`
|
||||||
|
|
||||||
|
The new siteConfig
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:61](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L61)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### updateCurrentConfig
|
||||||
|
|
||||||
|
▸ **updateCurrentConfig**(`siteCfg`, `_directives`): `MermaidConfig`
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type |
|
||||||
|
| :------------ | :-------------- |
|
||||||
|
| `siteCfg` | `MermaidConfig` |
|
||||||
|
| `_directives` | `any`\[] |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`MermaidConfig`
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:14](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L14)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### updateSiteConfig
|
||||||
|
|
||||||
|
▸ **updateSiteConfig**(`conf`): `MermaidConfig`
|
||||||
|
|
||||||
|
#### Parameters
|
||||||
|
|
||||||
|
| Name | Type |
|
||||||
|
| :----- | :-------------- |
|
||||||
|
| `conf` | `MermaidConfig` |
|
||||||
|
|
||||||
|
#### Returns
|
||||||
|
|
||||||
|
`MermaidConfig`
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[config.ts:79](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/config.ts#L79)
|
||||||
56
docs/config/setup/modules/defaultConfig.md
Normal file
56
docs/config/setup/modules/defaultConfig.md
Normal file
@@ -0,0 +1,56 @@
|
|||||||
|
> **Warning**
|
||||||
|
>
|
||||||
|
> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
|
||||||
|
>
|
||||||
|
> ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/setup/modules/defaultConfig.md](../../../../packages/mermaid/src/docs/config/setup/modules/defaultConfig.md).
|
||||||
|
|
||||||
|
# Module: defaultConfig
|
||||||
|
|
||||||
|
## Variables
|
||||||
|
|
||||||
|
### configKeys
|
||||||
|
|
||||||
|
• `Const` **configKeys**: `string`\[]
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[defaultConfig.ts:2293](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/defaultConfig.ts#L2293)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### default
|
||||||
|
|
||||||
|
• `Const` **default**: `Partial`<`MermaidConfig`>
|
||||||
|
|
||||||
|
**Configuration methods in Mermaid version 8.6.0 have been updated, to learn more\[[click
|
||||||
|
here](8.6.0_docs.md)].**
|
||||||
|
|
||||||
|
## **What follows are config instructions for older versions**
|
||||||
|
|
||||||
|
These are the default options which can be overridden with the initialization call like so:
|
||||||
|
|
||||||
|
**Example 1:**
|
||||||
|
|
||||||
|
```js
|
||||||
|
mermaid.initialize({ flowchart: { htmlLabels: false } });
|
||||||
|
```
|
||||||
|
|
||||||
|
**Example 2:**
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script>
|
||||||
|
const config = {
|
||||||
|
startOnLoad: true,
|
||||||
|
flowchart: { useMaxWidth: true, htmlLabels: true, curve: 'cardinal' },
|
||||||
|
securityLevel: 'loose',
|
||||||
|
};
|
||||||
|
mermaid.initialize(config);
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
|
||||||
|
A summary of all options and their defaults is found [here](#mermaidapi-configuration-defaults).
|
||||||
|
A description of each option follows below.
|
||||||
|
|
||||||
|
#### Defined in
|
||||||
|
|
||||||
|
[defaultConfig.ts:33](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/defaultConfig.ts#L33)
|
||||||
Reference in New Issue
Block a user