{"id":23291038,"url":"https://github.com/jplusplus/thenmap-v0","last_synced_at":"2025-04-06T17:44:43.799Z","repository":{"id":11533264,"uuid":"14017617","full_name":"jplusplus/thenmap-v0","owner":"jplusplus","description":"Historical political world maps, an old proof-of-concept version","archived":false,"fork":false,"pushed_at":"2014-04-28T20:58:54.000Z","size":32590,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-04-14T04:55:29.272Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.thenmap.net","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jplusplus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-31T13:27:26.000Z","updated_at":"2016-01-25T22:51:06.000Z","dependencies_parsed_at":"2022-08-29T05:20:43.339Z","dependency_job_id":null,"html_url":"https://github.com/jplusplus/thenmap-v0","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jplusplus%2Fthenmap-v0","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jplusplus%2Fthenmap-v0/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jplusplus%2Fthenmap-v0/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jplusplus%2Fthenmap-v0/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jplusplus","download_url":"https://codeload.github.com/jplusplus/thenmap-v0/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247526675,"owners_count":20953141,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-20T05:13:55.952Z","updated_at":"2025-04-06T17:44:43.765Z","avatar_url":"https://github.com/jplusplus.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"thenmap\n=======\nPost war political world map\n\n* 1946 -- 2013 is acceptable but not perfect\n* 1940 -- 1946 is missing a lot of data, but could be fixed\n* 1920 -- 1945 will require more work, as a lot of shapes need to be created from scratch\n*      -- 1920 will require _a lot_ of research\n\nThe code is not even a beta, so use at you own risk. Feel free to report any bugs in [the Trello board](https://trello.com/b/aqFu3s1d/thenmap)\n\n\nExample with dataset: [Unemployment in EU](http://www.leowallentin.se/thenmap/?map=europe\u0026fYear=2001\u0026lYear=2012\u0026dataCss=unemployment-eu)\n\nAvailable map languages: sv,en,fi,fr,de,es,ru,it,nl,pl,zh,pt,ar,ja,fa,no,he,tr,da,uk,ca,id,hu,vi,ko,et,cs,hi,sr,bg\n\nScript to generate svg maps is in generators/map-factory\n\nHow to use\n----------\n\nThe easiest way to implement thenmap is by creating a `\u003cdiv\u003e` or `\u003csection\u003e` element with the id \"thenmap\", and then include the following piece of code:\n\n    \u003cscript src=\"//thenmap.net/thenmap.js\"\u003e\u003c/script\u003e\n\nNations are now colored with css classes. The css can also be hosted, like here (decolonization of the world):\n//www.thenmap.net/demo\n\nAnd here is the unemployment in European nations, year by year (using customized styles):\n//www.thenmap.net/demo/demo.html\n\nYou can also build your own, custom controls for the map, like in this map showing countries taking part in the Eurovision Song Contest since the start:\n//www.thenmap.net/demo/demo.html\n\nFor more control over the script, see alternative usage method below\n\nFive maps are currently avaiable, but more maps can easily be rendered. (A python script renders all maps automatically):\n * The world, Robinson projection:  //www.thenmap.net?map=world-robinson\n * The world, Mollweide projection: //www.thenmap.net?map=world-mollweide\n * Europe, orthographic projection: //www.thenmap.net?map=europe-ortho\n * Europe, incl. Caucasus, Lambert conformal conic: //www.thenmap.net?map=europe-caucasus-lcc\n * Africa, Lambert Azimuthal Equal-Area Projection: //www.thenmap.net?map=africa-laea\n\nNation names are translated into 30 languages, thanks to the WikiData project. Swedish and English should be fully covered. English is used as a fallback language, when no translation is available. A better approach should be implemented.\n * Europe in French: //www.thenmap.net?map=europe\u0026mlang=fr\n * The World in Hindi: //www.thenmap.net?map=world\u0026mlang=hi\n \nThe languages are: sv,en,fi,fr,de,es,ru,it,nl,pl,zh,pt,ar,ja,fa,no,he,tr,da,uk,ca,id,hu,vi,ko,et,cs,hi,sr, and bg\n\nAll parameters to the script:\n * controls=true/false (Show control buttons below the player? Default true)\n * autoinit=true/false (Initiate the map automatically? Will also load JQuery if not already loaded. Default true)\n * mlang=LANGUAGE CODE (Map map language. Default: sv = Swedish. See the list above)\n * lang=LANGUAGE CODE (interface language. Default: sv)\n * fYear=YEAR (First year. Default 1946. Map is incomplete before 1946)\n * lYear=YEAR (Last year. Default 2013. Current borders, names and flags will be used after 2014)\n * sYear=YEAR (What year should be displayed on page load?)\n * offset=mm-dd (Show borders and nations from this date of the year. Default: 07-01. If browsing by month -- not yet implemented -- this would be date day of the month.)\n * dataCss=XXXX (Name of hosted data set. Default: none)\n * debug=true/false (Default false)\n \nIf autoinit is not used, the script is loaded like this:\n\n    var mymap = Thenmap.init(element,callback);\n\ncallback is the function to call everytime the map updates, element is the html element to attach the map to.\n\nAvaiable methods are:\n * Thenmap.init(e,cb)\n * Thenmap.moveRight()\n * Thenmap.moveLeft()\n * Thenmap.togglePlayPause()\n * Thenmap.moveToStart()\n * Thenmap.moveToEnd()\n * Thenmap.playTimeline()\n * Thenmap.stopTimeline()\n\nValues: \n * Thenmap.currentYear\n * Thenmap.isPlaying (true/false)\n * Thenmap.svg (the map svg element)\n\nWikiData integration\n--------------------\nThe map has tooltip windows for each nation, that can contain additional data. By default the nation's name and flag is displayed. Flags and names are fetched from WikiData when the maps are created. Basically every nation that has a Wikipedia article in _any_ language also has a WikiData entry. When WikiData entries are missing (yes, there are actually a few such examples!), we go there to create one. The advantages of using WikiData are plenty:\n * Translations to all languages with major Wikipedia editions, using the \u003ca href=\"https://en.wikipedia.org/wiki/Principle_of_least_astonishment\"\u003eprinciple of least astonishment\u003c/a\u003e. This works very well for us, as these are the names that are most likely used in mainstream media. When names are missing, or we are unhappy about the name forms, we can override them with local translations.\n * We get additional data, such as flags, relatively well referenced with sources.\n * We can use images from Wikimedia Commons.\n * The nation data is kept up to date by a huge community.\n * All data is CC0\n * As each nation has a WikiData ID, more data (e.g. Wikipedia link) can easily be requested\nOn the flipside:\n * Flags (the actual images from WikiMedia Commons, not the WikiData entry) can sometimes have more restrictive licenses. We should probably add an option to filter out CC0 and public domain images only.\n * We can only be as granular as WikiData. We will, in other words, not be able to display every flag, capital, etc, unless we create a local repository for such data\n\nCredits, copyright and licensing\n--------------------------------\nThenmap is Copyright © 2013 [Leo Wallentin](http://leowallentin.se) and Jens Finnäs, and free to reuse, modify and distribute under the [MIT license](http://opensource.org/licenses/MIT) (see below).\n\nJS minification is done with [JShrink](https://github.com/tedivm/JShrink), copyright © 2009 by Robert Hafner.\n\nThe slider uses a [patched](https://code.google.com/p/dragdealer/issues/list?q=type=Patch) and stripped down version of [Dragdealer JS v0.9.5](http://code.ovidiu.ch/dragdealer-js), copyright © 2010 by Ovidiu Chereches, and released under the [MIT License](http://legal.ovidiu.ch/licenses/MIT).\n\nDynamic CSS and JS loading is handled by [LazyLoad](https://github.com/rgrove/lazyload/), copyright © 2011 by Ryan Grove \u003cryan@wonko.com\u003e.\n\nInternationalization by [Light-i18n](https://github.com/ahfeel/php-light-i18n) by Jérémie Bordier.\n\nNation names are provided by tens of thousand of Wikipedia editors, thanks to the [WikiData project](https://www.wikidata.org) and community, [CC-0](http://creativecommons.org/publicdomain/zero/1.0/), when no local translation is available.\n\nMaps are prerendered  with [Kartograph.py](https://github.com/kartograph/kartograph.py), licensed under [AGPL](http://www.gnu.org/licenses/agpl-3.0.txt), by Gregor Aisch\n\nJenks breaks algorithm for choropleth maps by [Daniel J Lewis](http://danieljlewis.org/files/2010/06/Jenks.pdf)\n\nColors schemes are from [ColorBrewer2](http://colorbrewer2.org/) by Cynthia A. Brewer, Geography, Pennsylvania State University; imported with [brewer2mpl](https://github.com/jiffyclub/brewer2mpl), copyright © 2012 by Matt Davis, and released under the [MIT License](http://legal.ovidiu.ch/licenses/MIT).\n\nThe icon font was generated with [IcoMoon](http://icomoon.io/).\n\nShapefiles are primarily based on [Natural Earth](http://www.naturalearthdata.com/about/), but also borrowing from [DIVA-GIS free spatial data](http://www.diva-gis.org/Data) and [CSHAPES](http://nils.weidmann.ws/projects/cshapes), Weidmann, Nils B., Doreen Kuse, and Kristian Skrede Gleditsch. 2010. [The Geography of the International System: The CShapes Dataset. International Interactions 36 (1)](http://www.tandfonline.com/doi/abs/10.1080/\n03050620903554614#.UqAvJrXtkWM), especially after 1975. Hyderabad borders are from [sharemap.org](http://sharemap.org/public/Hyderabad) by anonymous users, [CC-BY-SA 3.0](http://creativecommons.org/licenses/by-sa/3.0/). Countless old, public domain maps have been used to recreate old borders when needed. We would appreciate a line of credit if you find our shapes useful and reuse them!\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjplusplus%2Fthenmap-v0","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjplusplus%2Fthenmap-v0","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjplusplus%2Fthenmap-v0/lists"}