A Gatsby.js Remark plugin that transform Typedoc symbol links (e.g. [[symbol.path]]
). Designed to be used with gatsby-source-typedoc which creates Gatsby nodes for GraphQL that contain your Typedoc project but you could provide your own Typedoc project reflection using fs.readSync
.
This plugin just wraps remark-typedoc-symbol-links and passes the options.typedoc
on your behalf using the sourced Typedoc Gatsby node(s).
npm install gatsby-source-typedoc gatsby-remark-typedoc-symbol-links --save-dev
Configure your gatsby-config.js
:
First, include gatsby-source-typedoc
in your config to generate your Typedoc:
// In your gatsby-config.js
module.exports = {
plugins: [
{
resolve: 'gatsby-source-typedoc',
options: {
src: [`${__dirname}/my-typescript-project/index.ts`],
typedoc: {
mode: 'modules',
tsconfig: `${__dirname}/my-typescript-project/tsconfig.json`,
},
},
},
],
}
See gatsby-source-typedoc for complete set of options.
When using with gatsby-transformer-remark
, include under options.plugins
:
// In your gatsby-config.js
module.exports = {
plugins: [
{
resolve: `gatsby-transformer-remark`,
options: {
plugins: [
{
resolve: 'gatsby-remark-typedoc-symbol-links',
options: {
/* provide options here */
},
},
],
},
},
],
}
When using with gatsby-plugin-mdx
, include under options.gatsbyRemarkPlugins
config:
// In your gatsby-config.js
module.exports = {
plugins: [
{
resolve: `gatsby-plugin-mdx`,
options: {
gatsbyRemarkPlugins: [
{
resolve: 'gatsby-remark-typedoc-symbol-links',
options: {
/* provide options here */
},
},
],
},
},
],
}
This corresponds to the gatsby-source-typedoc id
option. This allows you to source from multiple Typedoc projects. By default, the ID is default
and if you need more, they should be unique.
The rest of the options (excluding options.typedoc
which is sourced for you) are documented in remark-typedoc-symbol-links, they are passed through.
This was developed for use on the excalibur.js project and is used in the documentation site, see the Gatsby config.
See Contributing and the Code of Conduct
MIT