Layout placeholders

[antonk52]

Currently there is no way to customise existing components (DocItem is a good example). To be more specific inserting custom components within major layout components. The only way can customise these components is to overwrite a given component in your projects/preset while taking a responsibility to manually keep it in sync with the component from docusaurus itself. This process is suboptimal and it would be nice to have a few placeholder(() => null) components that can be overwritten by customers who could "insert" their project specific stuff without having to essentially fork docusaurus' component. A couple of good candidates can be Pre/Post Content for DocItem, that can be utilised for comments section, polls and other project specific items.

[Josh-Cena]

Hey, here might be a useful thread for you: #5251

Basically, if you just want placeholder components inserted before/after some block, you can usually do so through wrapping components. If that doesn't work out (e.g. if the place you are inserting your component in is in the middle of a bigger component), you can report your use-case in #6116 and we will see how we can refactor our theme to cope with your needs.

[slorber]

@antonk52 we can definitively extract a DocContent theme item, that makes perfect sense to enable you to do so.

Please report your customization use-case here, it's important for us to understand what is your goal exactly: #5468

[slorber]

@antonk52 when I asked to report the customization usecase, I expected something like "I want to add a comment system to my articles", not "we can't wrap X comp" :) What is the final outcome you want, not what is the technical detail that you think prevents you from achieving it.

[Josh-Cena]

https://xyproblem.info/ 😝

[antonk52]

my bad, let me edit the comment 😅

[slorber]

thanks ;)