Addon-docs: Support absolute anchors when deployed at non-root

[amannn]

Issue: #11404

What I did

When Storybook is deployed at an URL like https://example.com/storybook/component-library/v48.3.2/, the anchors within docs content will remove the base url.

E.g. when you're on https://example.com/storybook/component-library/v48.3.2/?path=/docs/components-icon--default and you have a link to /docs/components-button--default in the documentation, the resulting link will point to https://example.com/?path=/docs/components-button--default.

How to test

• Is this testable with Jest or Chromatic screenshots?
• Does this need a new example in the kitchen sink apps?
• Does this need an update to the documentation?

If your answer is yes to any of these, please make sure to include it in your PR.

Not sure if there's a good way to add a test for this, as it depends on a special kind of deployment?

[amannn]

This access should be safe, even if the content is rendered outside of an iframe.

From MDN:

If a window does not have a parent, its parent property is a reference to itself.

[amannn]

I'm not sure why some tests failed. Are they related to my change? Can you help me with them?

[shilman]

Nice one @amannn!

Were you able to test it on your dev machine somehow? How about:

yarn bootstrap --core
cd examples/official-storybook
yarn build-storybook
npx http-server
open localhost:9011/storybook-static

[amannn]

@shilman Thanks for the review and your snippet!

I've tested it previously in a project of mine by editing node_modules 😬 , but I've just confirmed that this also works in this repo.

I've added:

 * [Go to color palette](/docs/basics-colorpalette--page)

to lib/components/src/blocks/Description.tsx:14 and opened Storybook with:

open "http://localhost:8080/storybook-static/?path=/docs/docs-description--text"

(note that http-server uses port 8080 by default).

The anchor is rendered correctly and the link takes you to the color palette 🙂 .

I wasn't sure if there's any reasonable place in the code base where such an anchor would make sense, so we have a story to test this behaviour?

[amannn]

@shilman is there anything I can do to get this merged?