# Narratives Link Setup

**URL:** <https://nextstrain.discourse.group/t/narratives-link-setup/450>\
**Category:** General\
**Created:** [March 23, 2021, 11:53am UTC](https://nextstrain.discourse.group/t/narratives-link-setup/450 "2021-03-23T11:53:05Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![underscore](https://yyz1.discourse-cdn.com/flex031/user_avatar/nextstrain.discourse.group/underscore/32/118_2.png) [@underscore](https://nextstrain.discourse.group/u/underscore)\
**Post date:** [March 23, 2021, 11:53am UTC](https://nextstrain.discourse.group/t/narratives-link-setup/450/1 "2021-03-23T11:53:05Z")

</div>

The documentation at [Writing a Narrative — Nextstrain documentation](https://docs.nextstrain.org/en/latest/tutorials/narratives-how-to-write.html) is not fully clear to me. Isn’t it necessary to change also my localhost:4000 link in the markdown to some github URL? Renamed the markdown file as suggested but the link `https://nextstrain.org/community/narratives/under-score/Covid-19-Germany/bavaria` does not work unfortunately.

Thank you.

---

<div class="post-metadata">

**Author:** ![james](https://yyz1.discourse-cdn.com/flex031/user_avatar/nextstrain.discourse.group/james/32/11_2.png) [@james](https://nextstrain.discourse.group/u/james)\
**Post date:** [March 24, 2021, 2:26am UTC](https://nextstrain.discourse.group/t/narratives-link-setup/450/2 "2021-03-24T02:26:31Z")

</div>

Unfortunately it’s not very user-friendly to develop datasets & narratives in tandem - this is a good reminder for us to update the docs here (or better still, improve auspice).

The domain for datasets defined in the markdown (either localhost:4000 or [nextstrain.org](http://nextstrain.org)) isn’t actually important, rather it’s the path that matters. The Auspice client, when parsing the narrative, uses this path to make dataset requests to the domain it (auspice) is served from - the domain specified in the markdown file is ignored.

As an example, using [your narrative markdown file](https://raw.githubusercontent.com/under-score/Covid-19-Germany/main/narratives/Covid-19-Germany-bavaria.md) which defines the dataset `http://localhost:4000/ncov/bavaria`.

- If you are using auspice locally, e.g. via `auspice view` on localhost:4000, then the dataset [http://localhost:4000/ncov/bavaria](http://localhost:4000/ncov/bavaria) must exist.
- If you are using auspice through [nextstrain.org](http://nextstrain.org), then the dataset `https://nextstrain.org/ncov/bavaria` must exist. This doesn’t exist, which is why you can’t view your narrative through the community functionality.

More information available [in this GitHub issue](https://github.com/nextstrain/auspice/issues/890)

---

<div class="post-metadata">

**Author:** ![underscore](https://yyz1.discourse-cdn.com/flex031/user_avatar/nextstrain.discourse.group/underscore/32/118_2.png) [@underscore](https://nextstrain.discourse.group/u/underscore)\
**Post date:** [March 24, 2021, 7:34am UTC](https://nextstrain.discourse.group/t/narratives-link-setup/450/3 "2021-03-24T07:34:01Z")

</div>

Thank you @james.

Get the idea that only relative URLs matter but still do not know how to implement the github storage

> Then, by uploading the repo to GitHub it will be available to everyone at [nextstrain.org/narratives/yourname/auspice-narrative-example](http://nextstrain.org/narratives/yourname/auspice-narrative-example).
