Doc for @theme-original and @theme-init

📚 Documentation

I think this D2 feature is currently not documented.

If we want to override an existing comp, yet reuse the original comp (like, if you want to wrap it), there’s a special import alias we can use.

It’s worth trying if the following work and document this feature

import OriginalDocItem from "@theme-original/DocItem";

export default function CustomDocItem(props) {
  return (
    <>
      <div>
         before doc
      </div>
      <OriginalDocItem {...props} />
      <div>
         after doc
      </div>
    </>
  );
}

That could be nice to find a tiny usecase for this feature on D2 website, for dogfooding and ensuring this behavior does not break over time.

[yangshun]

@theme-original was added by me for the purposes you mentioned. @theme-init was added by @lex111 for reducing code duplication for the code blocks. They serve different purposes.

[Jonathannsegal]

This does seem like an straightforward clarification to add to the docs. Started a PR with proposed changed based on Alexey’s explanation. Let me know if this is something that is close to what is wanted or if this needs to be changed.