17thshard / reading-order Goto Github PK

Just putting this thought out there... Might as well have a version of this for ALL of Brandon's works.

It's less about reading order at that point, because obviously there's no reading order crossover between cosmere and non-cosmere books. I don't know the best way to approach that. A totally separate page, that's a spinoff of this project? A toggle that's built in to switch non-cosmere things off/on? A totally separate "view" (whatever you plan to call it) like the idea will be for word count bar graph?

Just wanted to record this thought somewhere. :)

Just putting some thoughts on the UI down after having used this for a while now. See comments in attached image.

Aside from the coloring books by series (Issue #11) I wondered if it would be good to graphically indicate series or worlds by some other means.

I sent this image last week:

This definitely has issues with clutter. I think I may have proposed just showing one at a time. A way to choose neither, by world, or by series. I think you proposed having it fade in depending on zoom level. All potential ways to do it.

I've also wondered about a more minimalist way of doing it along the same line of thought. Instead of putting those arcs on the outside of the circle, you could put them on the inside, between the books and the ends of the arrows. They could all be a uniform color or be colored the same way the series categories are? You wouldn't put any text directly on the graphic. The arc would just be used to show that those books are tied together, either as a series or on the same world. Maybe if you hover the mouse on the arc it makes a label show up, or you get a tooltip.

It would only make sense to do this on the series view. I'm not sure how you'd specify where the arcs start and end programatically.

Just some thoughts...

It's been a bit since I read Warbreaker, but I seem to remember hoid using the sand when telling his story

The infobox was disappeared when my mouse cursor leave the book title.

Awesome project! Found works I didn’t know existed. But the details don’t pull up on safari on iPhone at least half the time. I will attempt chrome and another devices but decided to at least note this now.

Repro steps: Open page on safari, tap on The Silence Divine (or any other) and tap on Details. Usually nothing appears at all, when it does it only shows for a split second.

As discussed on Discord, I'd like a way to display appearances/mentions of certain things.

The main use case is Hoid. The idea is to have a simple way to see, at a glance, which books Hoid has appearances and/or mentions in. It doesn't really make sense to track Hoid with arrows (lots of targets but nothing for them to point from)... Thus this idea.

From there I figured it made sense to do the same with Khriss and Nazh. Maybe there will be other characters or organizations or items that it makes sense to do this with over time.

I toyed with using initials to indicate this for all of them at once. I think we agree that showing one at a time would be the cleanest way to do this. I think something simple like this would work really well:

(showing Hoid appearances as solid and mentions as empty)

So the idea would be to put another dropdown box on the side which defaults to "none" but gives Hoid, Khriss, Nazh, and maybe others as options.

You raised the idea of showing an initial along with it. Symbol doesn't have to be full/empty circles. Just something along that concept seems good.

Hovering on the symbol should give a tooltip with more info.

I've put the info for Hoid appearances/mentions in data.json.

Last week I shared the idea of using this all to make a word count bar graph for the books. (maybe there's other interesting stats we could do this with, though nothing is coming to me right now...)

Here was a quick conceptual sketch I made:

I assume this isn't a technical challenge. I can input word counts in data.json. Pick the length we want for the maximum bar size, based on the radius of the circle. Mark a straight line from the book's anchor point toward the center of the circle, where the length is the book's word count out of the maximum. You get the idea. Hover on the bar to get a tooltip with the total number. Maybe include some concentric rings as grid lines?

The biggest problem with this is how to fit it in naturally. It would look pretty bad just colored on top of all the arrows, I assume. So some button that turns all arrows off and then slaps these bars on... But that sounds kind of random. :)

Just an idea...

People will probably think of connections I missed. Might come across errors or bugs. It would probably be good for them to have a way to offer feedback.

Maybe a button in the bottom right corner with our usernames?

You can link them to github but that might be intimidating for many people... I'm happy to put my email address down ([email protected])... Or we can send them to either of us on Reddit or 17th Shard?

Allow users to sign in to 17th shard account and this can be used to save user preferences. For example if they enable spoilers, if they expand or collapse the side panels, which view they were last on, etc. If 17th shard account integration is difficult browser storage could also be used to save these settings.

Paleo, you mentioned tooltips getting crowded, and putting this info somewhere more static. I agree that would probably be useful.

I think the best place to put it would be in the bottom left corner?

And have a way for it to slide up from the bottom on mobile, as you described.

My instructions get a bit lengthy and I figure there's no need for it to permanently take up so much screen space. Especially considering most people only need to read it once.

We obviously prefer that the title shows, and the brief description underneath is short enough. I think it would be good to have a "more details" button below this that expands the following section, including the four numbered points discussed at length. That can be collapsed by default.

On mobile, since the whole panel is collapsed I don't see an issue with all of this being visible when you open the info panel.

There's a bug with URLs which specify a layer besides the default (series).

For example: https://paleocrafter.github.io/reading-order/#/?layer=reading-order should open the page with the "Reading Order" layer active. Instead it just opens with the default layer, "Series", active.

Easy to reproduce. Visit the site. Choose any non-default layer. Reload page.

It's worth noting that on some level the site thinks the "Reading Order" layer is active when you navigate directly to that link above. (same for other non-default layers) The "eyeball" icon suggests that "Series" is active, and the chart appears with "Series" active. But oddly, if you try clicking on the "Reading Order" eyeball it doesn't change layers to "Reading Order." Any of the other layers will work though. So it's as if the site thinks you have "Reading Order" selected and won't let you toggle it on.

Hi,

First, awesome diagram this one is!

Also, I was checking the connections between Rhythm of War and other works and I think there are a couple missing:

-Elantris: Mraize and Wit's Seons (inside the communication device Mraize gives to Shallan/Wit also uses).

-Sixth of the Dusk: Lift's new Aviar (and Mraize one, if not stated yet).

-White Sand: The white sand Raboniel gives to Navani and Vyre also uses.

Thanks!

Might be worth adding this:

https://www.17thshard.com/forum/topic/97356-little-cosmere-connection/

I believe Khriss meets Kelsier in Secret History :)
Edit: I just saw that you put the Khriss marker on secret history, but no connection. So this is intended?

Hi! Love the this tool, and mad that I didn't make it myself. ;)

I'd love the ability to hide the sidebar and the overlay in the top-left corner, so I can take a nice screenshot. Alternatively, the ability to just download a high resolution image for a desktop background would be great!

Lost Metal is still tagged as forthcoming, but it's been released! The page should probably be updated to reflect this.

Would submit a PR to do it myself but currently have no access to my computer....

It would be nice to have the publication date info shown in the book tooltips.

I've added the following under each book (with a publication date) in data.json:
"publication": "<month and year>"

I'm not sure if naming that key "publication" will interfere with the "publication" key that gets used under "sorting". Let me know if it needs to be renamed.

currently this uses the default github pages domain of https://17thshard.github.io/reading-order but it would be nice to make it a subdomain like has been done for shardle and the map of roshar. Something like reading-order.17thshard.com

Hope of Elantris is set before Elantris on the wheel and it definitely should NOT be read before as it is set during the climax and contains major spoilers for Elantris.

Someone on Reddit requested a way to line up the books in a list instead of around in a circle.

I went with the circle because it looks more fun, it uses space better, and it keeps the arrows easier to follow. But there's certainly nothing wrong with a list style.

Mostly I assume this would just take a LOT of work for you to build out a whole separate viewing mode. Telling it where to list the books and how to space them. Getting the connection arrows pointing to/from the right spot with arcs that look good.

This isn't something we need to do, and certainly not a priority, but I figured it was at least worth a mention.

I think it would be beneficial to have an option to color books by their series instead of the reading order phase colors.

I have added series categories and assigned books to them. It would be nice if there were a toggle to have the books colored according to these instead of the blue/green phase categories. With things set up the way they are now, I'm guessing this isn't possible. It's just styling the text according to whatever was slapped on last. So I'm guessing the json file would need to be reworked for this, to something more like what you've done with "sorting".

It would be nice to have the chronology info shown in the book tooltips.

I've added the following under each book (with a known chronology) in data.json:
"chronology": "<description of chronology info, with links if needed>"

I'm not sure if naming that key "chronology" will interfere with the "chronology" key that gets used under "sorting". Let me know if it needs to be renamed.