[WIP] New narratives tutorial #139
Conversation
jameshadfield
force-pushed
the
james/narratives-tutorial
branch
from
5ada4f6
to
0eff079
Compare
Corresponding PR which adds the tutorial to our docs: nextstrain/docs.nextstrain.org#139
jameshadfield
force-pushed
the
james/narratives-tutorial
branch
from
0eff079
to
03a1276
Compare
|
|
||
| .. [#f2] In practice, the URL path component is what is used to access the dataset relative to the current hostname, however for historical reasons the protocol and hostname must be either ``http://localhost:4000`` or ``https://nextstrain.org``. | ||
|
|
||
| .. [#f3] This isn't great from a file-size point of view, and the markdown file isn't nice to look at itself, but it may be the best current solution! |
There was a problem hiding this comment.
I've been thinking that a nice user experience would be to have nextstrain remote upload (and any other narrative uploading/editing clients) auto-embed images this way. It makes the narrative self-contained, which is really nice. (Think back to the bad old days when most Word docs didn't embed images in them by default, but merely referenced them on the filesystem. It was bad.)
There was a problem hiding this comment.
I, happily, do not remember those dark days 😂
Would be a nice user experience for locally referenced images for sure - the alternatives get pretty complicated pretty fast
There was a problem hiding this comment.
Yeah, locally available images would be auto-embedded but hotlinked/remote images could be left alone. With a web-based editor, dragging and dropping an image would directly embed (or upload to somewhere we control and then hotlink, but I think this has lots of downsides).
jameshadfield
force-pushed
the
james/narratives-tutorial
branch
from
03a1276
to
477e27d
Compare
|
Note that I've updated the URLs to point to nextstrain.org/edit/narratives which doesn't actually exist yet. I plan to merge this tutorial once that endpoint does exist. |
There was a problem hiding this comment.
Some minor fixups, but otherwise looks good to me. Love the use of https://nextstrain.org/narratives/how-to-write/basics, including the little bit of science snuck in via postscripts. ;-)
jameshadfield
force-pushed
the
james/narratives-tutorial
branch
from
477e27d
to
9425839
Compare
Thanks to @tsibley for review comments
jameshadfield
force-pushed
the
james/narratives-tutorial
branch
from
9425839
to
ea98849
Compare
See nextstrain/nextstrain.org#618 for a review app which this narrative makes use of