Git Product home page Git Product logo

roshar-map's Introduction

Logo showing map of Roshar in the background with the title 'Roshar' and subtitle 'Interactive Map & Timeline' overlayed

Build Status Discord 17th Shard Forum Patreon

She trailed off, noticing for the first time that a map covered the table nearby. Expansive, it showed a land bounded by oceans—and the artistry of it put her own attempts to shame.

— Prologue to Oathbringer

An interactive map of Roshar, the world that The Stormlight Archive, a series of epic fantasy books by Brandon Sanderson, takes place on. There are descriptions of every location as well as a navigable timeline of events. Built using Vue.js and three.js.

Features

  • Fully labeled, explorable map of Roshar—including Shadesmar
  • Detailed timeline of the history of Roshar, spanning from pre-history to current events in the published books
  • Summaries of events, locations, and characters including links to related items and further details on the Coppermind Wiki
  • Localized content, currently available in the following languages besides English:
    • Chinese
    • Russian
    • Spanish
  • Layers on top of the map that can be enabled at any time, displaying useful additional information
    • Overlay the borders of the historic Silver Kingdoms
    • Show color indicators of the allegiances of various nations
    • Map out the ten Oathgate locations
  • Powerful filtering and customization capabilities
    • Filter timeline events by tags
    • Display a timeline separately from the rest to identify a single character's or book's events
    • Lock navigation controls to a separate timeline to follow only its events

Contribute

Help is always welcome! There's two main ways of contributing directly to this project: Translations and code. For translations, you may contribute both fixes to existing texts—including English—as well as entirely new locales. Feel free to work on translations in chunks and to ask for help in getting a new language set up on our Discord or forums, especially where localizing the actual map is concerned.

Bug fixes and improvements based on reported issues can be addressed through pull requests if you feel confident to work on the code base. As goes for translations, do not shy away from asking other contributors for pointers on where to start looking.

If you've found a bug or would like to request a feature, please report it on GitHub's issue tracker.

For some more detailed instructions on both translating and developing, follow the contribution guide.

Credits

Obviously this project would not exist without the fantastic books by Brandon Sanderson. The richness of the world allows us to create such a detailed experience.

The following is a list of all the artists that are either official artists or have gracefully granted this project permission to use their pieces as images for events, locations, characters, or other items:

A very special thanks goes out to Reddit user Stoneward13 for letting use and modify his awesome high resolution versions of the Roshar and Shadesmar maps.

We also thank the amazing people at Cosmere.es, The Cosmerenauts, and everyone else in our translation Discord server for going through the monumental effort of translating everything to several other languages, and fixing errors in the English text along the way!

Finally, the general appearance and concept of the map derives heavily from the interactive map of "The Continent" for Netflix's The Witcher series.

License

This project is licensed under the MIT License. Please familiarize yourself with it if you wish to contribute.

⚠️ Note: This license only applies to the code itself. All the artwork used for the map is used and distributed with special permission for the 17th Shard. Furthermore, the names and ideas from The Stormlight Archive are reproduced here in conformance with Brandon Sanderson's fanart policy. See the credits section for further details.

roshar-map's People

Contributors

333fred avatar av1sa avatar botanicaxu avatar brecht-vermeersch avatar dependabot[bot] avatar ekreiter avatar hudelf avatar jofwu avatar lianzhao avatar marvin-roesch avatar pull[bot] avatar robespmun avatar vanahian avatar ysondra avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

roshar-map's Issues

UPDATE - Desc - Kaladin

https://github.com/Palanaeum/roshar-map/edit/master/translations/en/characters/kaladin.md

OLD

Kaladin, nicknamed Kal, renowned as Kaladin Stormblessed, is a darkeyed Windrunner of the Knights Radiant from #Alethkar. Despite being trained as a surgeon from an early age by his father, his chosen profession is that of a soldier. He is famed as the captain of Highprince #Dalinar Kholin's personal guard, a unit known as Bridge Four, and commander of the bridgemen battalion.

NEW

Kaladin, nicknamed Kal, renowned as Kaladin Stormblessed, is a darkeyed Windrunner of the Knights Radiant from #Alethkar. He is the son of Lirin and Hesina, brother of the deceased Tien, and little Oroden. Despite being trained as a surgeon from an early age by his father, his chosen profession is that of a soldier. He is famed as the captain of HighKing of Urithiru #Dalinar Kholin's personal guard, a unit known as Bridge Four, and commander of the bridgemen battalion.

DOUBT: Is his last rank prior to RoW Captain of Dalinar's personal guard?

Locations on Shadesmar map?

I don't see a way to add locations to the Shadesmar map? We can probably get away without this for now, but at some point we'll want these.

Update - Dalinar's desc

Hi! I made some minor changes:

https://github.com/Palanaeum/roshar-map/blob/master/translations/en/characters/dalinar.md

Original:

Dalinar Kholin is an Alethi highprince of #Alethkar. He is known as the Blackthorn for his military prowess and is the Highprince of War. He is the younger brother of the late King Gavilar, uncle of King #Elhokar Kholin and #Jasnah Kholin, and is currently married to Brightness #Navani Kholin, Gavilar's widow. He has two sons, #Adolin Kholin and #Renarin Kholin. He is a member of the Order of Bondsmiths, bonded to the Stormfather, and is the de facto leader of the reformed Knights Radiant.

I used this modification for the Spanish translation:

Dalinar Kholin is the Highking of #Urithiru. He is known as the Blackthorn for his military prowess. He is the younger brother of the late King Gavilar, uncle of late King #Elhokar Kholin and #Jasnah Kholin, and is currently married to Brightness #Navani Kholin, Gavilar's widow. He has two sons, #Adolin Kholin and #Renarin Kholin. He is a member of the Order of Bondsmiths, bonded to the Stormfather, and is the de facto leader of the reformed Knights Radiant.

UPDATE - Desc - Shallan

https://github.com/Palanaeum/roshar-map/edit/master/translations/en/characters/shallan.md

OLD

Shallan Davar, also known as Veil or Radiant, is a lighteyed Lightweaver of the Knights Radiant from #Jah Keved. Shallan is an emerging scholar whose greatest achievement is the discovery of the legendary city #Urithiru. She is also renowned for her extraordinary talent of accurately reproducing even fleeting scenes with photographic accuracy.

NEW

Shallan Davar, also known as Veil or Radiant, is a lighteyed Lightweaver of the Knights Radiant from #Jah Keved, who also collaborates with the secret society known as the Ghostblood. She's the daughter of deceased Lin Davar, but her mother's name remains unknown. She has four brothers. The older one, Helaran, died fighting against #Kaladin although they never get to know each other. The remaining brothers are Balat, Wikim and Jushu. She is an emerging scholar whose greatest achievement is the discovery of the legendary city #Urithiru. She is also renowned for her extraordinary talent of accurately reproducing even fleeting scenes with photographic accuracy.

ADDED: Information about her father and mother, brothers. Mention to the Ghostblood.

Adding image bug in editor

The "credits" field doesn't show up under image file field in the editor (after adding a file) unless you click to another event and back.

EVENTS - Duplicated files

Files have pretty similar descs:

https://github.com/Palanaeum/roshar-map/blob/master/translations/en/events/jasnah-arrives.md

Attacked by Ghostbloods aboard Wind's Pleasure, Jasnah accidentally transported herseful fully into Shadesmar and found immediate return to the Physical Realm impossible. Months later, Jasnah was able to transition back somewhere in the Unclaimed Hills, where she was greeted by Wit. Jasnah carefully returned to the Shattered Plains only to find the Warcamps abandoned and the tower city of Urithiru rediscovered.

and

https://github.com/Palanaeum/roshar-map/blob/master/translations/es-ES/events/jasnah-returns-from-shadesmar.md

"Attacked by Ghostbloods aboard Wind's Pleasure, Jasnah accidentally transported herseful fully into Shadesmar and found immediate return to the Physical Realm impossible. She made the most of her time there, visiting the highspren to learn more of Roshar's past. Months later, Jasnah was able to transition back somewhere in the Unclaimed Hills, where she was greeted by Wit."

I think we need to change the desc. Please update and let me know so I can update/remove file the Spanish files accordingly.

Jump to Start/End

Perhaps unnecessary if #24 is addressed, but it would be nice to have a quick way to jump to the very start or very end.

I'm sure a lot of people will open it up the first time, poke around for a moment, and then want to scroll through the timeline from the beginning. Scrolling all the way over is a bit of a slog though.

Buggy location highlighting

This is pretty minor. Thought it was worth pointing out though. Image explains it best:

image

Haven't investigated enough to say if it only happens with certain locations, or if other things affect it. It happens for me on Firefox and Chrome.

Timeline labels

When you pop out additional timelines they aren't clearly labeled, aside from when the Settings menu is open. (On mobile the settings menu takes up the full screen so this is even less ideal.) Maybe we need to label them on the right? Or have a popup label if you click or hover on the line itself? Something else?

UPDATE - Desc - Moash

https://github.com/Palanaeum/roshar-map/blob/master/translations/en/characters/moash.md

Minor addition.

OLD
Moash, also known as Vyre, is an Alethi man on Roshar. Originally a bridgeman in Bridge Four, he becomes a soldier and bodyguard under #Kaladin; eventually, he betrays Bridge Four and switches sides to the #Diagram, then the Fused, serving them as a slave, warrior and assassin. He's the current holder of Jezrien's Honorblade.

NEW
Moash, also known as Vyre, is an Alethi man on Roshar. Originally a bridgeman in Bridge Four, he becomes a soldier and bodyguard under #Kaladin; eventually, he betrays Bridge Four and switches sides to the #Diagram, then the Fused, serving them as a slave, warrior and assassin, killing late King #Elhokar. He's the current holder of Jezrien's Honorblade.

ADDED: ", killing late King #Elhokar."

UPDATE - Desc - Renarin

https://github.com/Palanaeum/roshar-map/edit/master/translations/en/characters/renarin.md

OLD

Renarin Kholin

I am not the first hero’s son to be born without any talent for warfare. The others all got along. So shall I.

Renarin Kholin is a lighteyes of the #Alethi House Kholin on Roshar. He is the second son of Dalinar, and the younger brother of Adolin. This makes him the nephew to Gavilar and Navani and cousin to Elhokar and Jasnah. Since Dalinar's abdication, he is first in line to succeed Adolin as highprince of the Kholin princedom.

NEW

Renarin Kholin

I am not the first hero’s son to be born without any talent for warfare. The others all got along. So shall I.

Renarin Kholin is a lighteyes of the #Alethi House Kholin on Roshar. He is the second son of #Dalinar, and the younger brother of #Adolin. This makes him the nephew to #Gavilar and Navani and cousin to #Elhokar and #Jasnah until #Navani married Dalinar. He's the brother-in-law of #Shallan Davar. Since Dalinar's abdication, he is first in line to succeed Adolin as highprince of the Kholin princedom. He's member of the Knight Radiants as Truthwatcher, and bonded to the corrupted spren Glys.

ADDED: KN Order, mention to corrupted Glyss. Links to Dalinar, Adolin, Gavilar, Navani, Elhokar, and Jasnah. Relationship with Navani as step-mother. Relationship with Shallan as sister-in-law.

MAPS - Spanish terms

Hi!

Here is the list of names appearing on the different maps.

Roshar

  • The Misted Mountains -> Montañas brumosas

Note: We are still pending to confirm if we will keep Marabethia or marabezia in Spanish. Once I get the confirmation I will let you know.

Shadesmar

  • Expanse of the Densities ->Extensión de las densidades
  • Expanse of Vibrance -> Extensión de la Intensidad* (note.: this has not been translated yet, but tentatively we keep Intensidad for now).
  • Expanse of the Broken Sky ->Extensión del cielo roto
  • Expanse of the Vapors ->Extensión de los vapores
  • Nexus of Truth ->Nexo de la verdad
  • Nexus of Transition ->Nexo de la transición
  • Nexus of Imagination ->Nexo de la imaginación
  • Sea of Regret ->Mar del pesar
  • Sea of Souls -> Mar de las almas
  • Sea of Lost Lights ->Mar de las luces perdidas
  • Celebrant -> Celebrant (remains as is)

Locations related to the Sea of Lost Lights:

  • Candlemore -> Villacandela
  • Sea of Oracles -> Mar de los oráculos
  • Salavashi Trench -> Fosa Salavashi
  • Smolderbrand Channel -> Canal de Marcadiente
  • Celebrant -> Celebrant (remain as is)
  • Celebrant Channel -> Canal de Celebrant
  • North Hallen Channel ->Canal de Hallen Norte
  • South Hallen Channel ->Canal de Hallen Sur
  • Emberdark Channel -> Canal de Acuaoscura
  • Nor Channel -> Canal de Nor
  • Emberdark -> Acuaoscura
  • The Burning Gardens -> Los Jardines Ardientes
  • Ravizadth -> Ravizadth (remain as is)
  • The Glasswater Deep -> Profundidades de Aguacristalina
  • The Luminous Shallows ->Los bajíos luminosos
  • Thaylen Sea ->Mar de Thaylen
  • Caretaker of Laughter ->Custodio de la Risa
  • Salumon the Third Tower -> Salumon, la Tercera Torre

Silver Kingdoms -> Reinos Plateados

  • Alethela -> Alezela

Oathgate Locations

  • Thaylen City -> Ciudad Thaylen

Current State of the World

  • Dalinar's Coalition of Monarchs -> Coalición de Monarcas de Dalinar
  • Odium's Forces -> Fuerzas de Odium
  • Neutral -> Neutral (remain as is)

ES-es - Metadata mass replace

Would it be possible to search & replace the following in the files under the events folder?

Metadata fields:

Ch. -> Cap.
& -> y
The Way of Kings -> El camino de los reyes
Word of Radiance -> Palabras radiantes
Oathbringer -> Juramentada

Thank you!!!!

UPDATE - Desc - Adolin

I included a link to Shallan's file on Adolin's desc.

Maybe that could be also done for the English version.

Make "Related" heading more distinguished

Small thing... The "Related" header in the "more info" panel is kind of plain. Would be nice to spruce it up (bold?, underlined?, small caps?, bigger?) so it looks like more of a header.

UPDATE - Event - Battle of Narak

Added location link to the file: https://github.com/Palanaeum/roshar-map/edit/master/translations/en/events/battle-of-narak-and-the-everstorm.md

The Alethi forces led by Dalinar Kholin arrived at #Narak on the final day of Renarin's cryptic countdown. A battle ensued as the stormform listener forces worked to summon the Everstorm. The Alethi proved victorious, but the Everstorm's arrival nearly wiped out all survivors.

Maybe it could been added on the English version as well.

UPDATE - Desc - Elhokar

https://github.com/Palanaeum/roshar-map/edit/master/translations/en/characters/elhokar.md

OLD:

Elhokar Kholin

Perhaps the liar here is me—lying to tell myself I could do this, that I could be a fraction of the man my father was.

Elhokar Kholin is the king of #Alethkar on Roshar, and the nephew of Dalinar.

NEW:

Elhokar Kholin

Perhaps the liar here is me—lying to tell myself I could do this, that I could be a fraction of the man my father was.

Elhokar Kholin was the king of #Alethkar on Roshar after his father. Son of late king #Gavilar Kholin and #Navani Kholin, he was also younger brother to #Jasnah Kholin. He was married to Aesudan Kholin, and they had a children named Gavinor. He was murdered by #Moash during the assault to the Royal Palace, before he finished to pronounce the First Ideal and become a Knight Radiant.

More info panel artwork too large (mainly a mobile issue)

See this example:
Screenshot_2020-10-10-13-25-01

Sometimes get this issue (mostly a mobile probablem in my experience but maybe an issue on some desktop resolutions?) Where the art in the info panel fills the whole screen height. Not a major issue, but I wonder if it will confuse people, not realizing they can scroll down?

Maybe it should automatically bscroll down so the title at least is in view, if that's doable? Or have a floating arrow button to focus on title?

Need option to offset/scale character images

Currently no way to offset or scale Character images, which means they aren't cropped/sized well when displayed as thumbnail.

(might have same issue with Misc images I'm guessing)

"Go to date" button

I'd like to have some kind of way to jump to a date.

Maybe by clicking the date indicator. Maybe a button up next to Settings or elsewhere?

I imagine it would open up a pop-up that lets you enter/select a year, month, week, day. Latter 3 could default to 1 and be selected with dropdown. I guess year would default to 1167 or whatever year is currently selected? And would have to be entered manually?

Faster way to navigate on timeline?

Just a thought...

It's not easy to scroll from one end of the timeline to the other. Wonder if we need some kind of... scroll bar? Or a button that sends you to one end or the other? Or a way to pick a date to go to?

Remember last date viewed

Might be good to remember the last date someone viewed when they visit and go there instead of the default?

Mainly an issue on mobile, because when I switch to another app and back the page reloads to the default event on me.

Change the default event

I don't think "Kaladin joins Bridge Four" makes the best starting event that the map jumps to on a fresh load.

I'd say our best option would either be to not select any event at all OR to start with Gavilar's assassination.

UPDATE - Desc - Navani

https://github.com/Palanaeum/roshar-map/edit/master/translations/en/characters/navani.md

OLD:

Navani Kholin is a Brightlady of #Alethkar on Roshar. She is the widow of #Gavilar Kholin and the mother of Jasnah and #Elhokar Kholin. She was the sister-in-law to #Dalinar Kholin and aunt to Adolin and #Renarin Kholin until she was married to Dalinar. She is also a renowned scholar and artifabrian.

NEW:

Find the structure here and start building upon it.

Navani Kholin is a Brightlady of #Alethkar on Roshar. She is the widow of #Gavilar Kholin and the mother of #Jasnah and #Elhokar Kholin. She was the sister-in-law to #Dalinar Kholin and aunt to #Adolin and #Renarin Kholin until she was married to Dalinar. She is also a renowned scholar and artifabrian.

NOTES: Quote added, Included links to Jasnah and Adolin.

Would like to see a way to distinguish events/characters/locations/misc in detail view

When you open something up in detailed view, all of the "Related" items are just crammed next to one another. I would like to see some kind of visual distinction made between them.

My first instinct was to say that each type should have a different shape or outline color.

Another option, which I think I like better, would be to simply group each set under different headings.

UPDATE - Event - Bridge Four begins training squires

https://github.com/Palanaeum/roshar-map/edit/master/translations/en/events/bridge-four-begins-training-squires.md

Added link to Alethkar

Details

After Kaladin returned from his mission in #Alethkar, he began to see to the development of the growing Windrunners. Several members of Bridge Four showed signs of being Kaladin's squires, and in the coming weeks most of the crew, as well as some newcomers, would also take the steps to become squires or full Windrunners.

Quality of life request

In the Editor, when entering things in "related" field, it would be nice if everything could be sorted alphabetically.

Colors for separated timelines

This is mainly a note for myself... Need to give some thought to what colors we use for other tags besides Kaladin/Dalinar/Shallan.

Year markers prior to 1166

Looks like prior to 11166 the year markers are placed directly on events? I'd prefer if they were spaced at regular(ish) intervals with the events showing up in between.

Given the events we have.... Seems ideal to have markers at:

  • -20k
  • -10k
  • -5000
  • -1000
  • 1
  • 1000
  • 1120
  • 1130
  • 1140
  • 1150
  • 1160
  • 1165

(then 1166 and everything as it currently is from there on)

UPDATE - Desc - Eshonai

https://github.com/Palanaeum/roshar-map/edit/master/translations/en/characters/eshonai.md

OLD:

Eshonai

Progress is learning to control your world. Put up walls to stop the storms, choose when to become a mate.

Eshonai is a listener Shardbearer who lives in #Narak on the #Shattered Plains of Roshar during the War of Reckoning. She was one of the first Parshendi to come in contact with #Gavilar Kholin's soldiers in the #Unclaimed Hills.

NEW:

Eshonai

Progress is learning to control your world. Put up walls to stop the storms, choose when to become a mate.

Eshonai is a listener Shardbearer who lived in #Narak on the #Shattered Plains of Roshar during the War of Reckoning. She was one of the first Parshendi to come in contact with #Gavilar Kholin's soldiers in the #Unclaimed Hills. During the Battle of Narak she fought #Adolin Kholin in her Stormform, who pushed her into a chasm, where she died drowning.

Adding 'chapter' field

For events which occur in the text of the books, I'd like to include a book/chapter reference to where that event happens. To do this, I've started adding a "chapter" field in the en.json file.

Let me know if you think there's a better way to go about this... I guess maybe there would be a smarter way to do it for alternate translations... A book number field and a chapter number field?

image

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.