Documentation on nested plugins?

[pauldotknopf]

gatsby/www/gatsby-config.js

Line 49 in 918b6c8

plugins: [

Is there guidance on how they work and when to use them?

[m-allanson]

@pauldotknopf There's not a lot on nested plugins, maybe have a look at the Plugin Authoring Guide.

Nested plugins can be used to extend the capabilities of the parent plugin. As an example, all of Gatsby's gatsby-remark-x plugins extend the gatsby-transformer-remark plugin.

[KyleAMathews]

Any plugin can have its own plugins. But the parent plugin has to be expecting this and have code to call the code from the sub-plugin for this to have any effect otherwise nothing happens. gatsby-transformer-remark is the only plugin I know that does this currently. Here is where it let's each sub-plugin mutate the markdown AST

gatsby/packages/gatsby-transformer-remark/src/extend-node-type.js

Line 163 in 3940544

// Use Bluebird's Promise function "each" to run remark plugins serially.

[jkjustjoshing]

Can we re-open this? This seems like a pretty important thing to document inside the Plugin Authoring Guide.

I'm writing an extension right now that is taking nodes defined by gatsby-source-filesystem and transforming them. Should gatsby-source-filesystem be a nested plugin of my transformer plugin? I do not know the answer to that question, and the docs do not currently provide an answer. The only way I can answer that question right now is digging into the source code of gatsby-transformer-remark.

[gatsbot]

Hiya!

This issue has gone quiet. Spooky quiet. 👻

We get a lot of issues, so we currently close issues after 30 days of inactivity. It’s been at least 20 days since the last update here.

If we missed this issue or if you want to keep it open, please reply here. You can also add the label "not stale" to keep this issue open!

As a friendly reminder: the best way to see this issue, or any other, fixed is to open a Pull Request. Check out gatsby.dev/contributefor more information about opening PRs, triaging issues, and contributing!

Thanks for being a part of the Gatsby community! 💪💜

[github-actions]

Hiya!

This issue has gone quiet. Spooky quiet. 👻

We get a lot of issues, so we currently close issues after 30 days of inactivity. It’s been at least 20 days since the last update here.
If we missed this issue or if you want to keep it open, please reply here. You can also add the label "not stale" to keep this issue open!
As a friendly reminder: the best way to see this issue, or any other, fixed is to open a Pull Request. Check out gatsby.dev/contribute for more information about opening PRs, triaging issues, and contributing!

Thanks for being a part of the Gatsby community! 💪💜

[github-actions]

Hey again!

It’s been 30 days since anything happened on this issue, so our friendly neighborhood robot (that’s me!) is going to close it.
Please keep in mind that I’m only a robot, so if I’ve closed this issue in error, I’m HUMAN_EMOTION_SORRY. Please feel free to reopen this issue or create a new one if you need anything else.
As a friendly reminder: the best way to see this issue, or any other, fixed is to open a Pull Request. Check out gatsby.dev/contribute for more information about opening PRs, triaging issues, and contributing!

Thanks again for being part of the Gatsby community! 💪💜