<commit_before>NOTE : THIS DOCUMENTATION IS UNDER INTENSIVE WRITING. 
SECTIONS TITLES WITH `(...%)` EXPRESS THE SECTION'S DEGREE OF COMPLETION.

# WikimapsAtlas
## Introduction
**Problem:** Making elegant andgeographically accurate encyclopedic maps for Wikipedia have been for years an highly manual process.  The base maps requiring complex digital geographic software (GIS) skills. This results in a poor supply of maps that is unable to meet the demand of accurate and updated maps for various projects and languages.

**Solution:** The WikimapsAtlas project is a push to automate the creation of Wikipedia SVG base maps, in respect of the solid and widely used [Wikipedia:Map\_Workshops cartographic styles guidelines](https://en.wikipedia.org/wiki/Wikipedia:WikiProject_Maps/Conventions) together with the latest and most accurate open geographic data.

**Wikimedia Fundation & IEG:** The design and development of this project is supported through an [Individual Engagement Grant](http://meta.wikimedia.org/wiki/Grants:IEG/Wikimaps_Atlas) from the Wikimedia Foundation.

## Repository

This repository provides a mechanism to generate [TopoJSON](https://github.com/mbostock/topojson) and [SVG](http://en.wikipedia.org/wiki/SVG) base maps for data visualization.

**Process improvement:** _Wikimaps Atlas_ tremendously ease the dowload and processing of publicly available GIS resources into elegant (Wikipedia maps guidelines complient), web friendly and data binding friendly maps.

**Style:** Generated SVGs follow the Wikipedia:Map Workshop cartographic guidelines.

**Data biding:** Generated SVGs are all build according to a strict standard structure. XML polygons have clear `id`, allowing easy data biding.

**Kinds & layers:** We mirror solid best practices refined by Wikipedia cartographers over the past 8 years. Also, we currently provide the following outputs as stand alone files:
* Administrative
 * {ITEM}_administrative_location_map.svg
 * {ITEM}_administrative_location_map-en.svg
* Topography
 * {ITEM}_topography_location_map.svg
* Shaded relief:
 * {ITEM}_shaded_relief_map-transparent.png
 * {ITEM}_shaded_relief_map-white.png
 * {ITEM}_shaded_relief_map-color_ramp.png

## Getting Started

### Dependencies (0%)


```
success: utilities nodejs something low_level       #a task with 4 requirements
    echo "======================================"   #this is the 1st command
    echo "Wikiatlas setup: done --------> 100% !"
    #tab before each command is COMPULSORY (spaces will bug!).
 
utilities:          # a task with no dependency
    sudo apt-get install git make curl unzip unrar gdal-bin 
 
nodejs:             #for d3js & svg generation
    sudo add-apt-repository ppa:chris-lea/node.js
    sudo apt-get update<commit_msg>doc:README.md improvement<commit_after>NOTE : THIS DOCUMENTATION IS UNDER INTENSIVE WRITING. 
SECTIONS TITLES WITH `(...%)` EXPRESS THE SECTION'S DEGREE OF COMPLETION.

# WikimapsAtlas
## Introduction
**Problem:** Making elegant andgeographically accurate encyclopedic maps for Wikipedia have been for years an highly manual process.  The base maps requiring complex digital geographic software (GIS) skills. This results in a poor supply of maps that is unable to meet the demand of accurate and updated maps for various projects and languages.

**Solution:** The WikimapsAtlas project is a push to automate the creation of Wikipedia SVG base maps, in respect of the solid and widely used [Wikipedia:Map\_Workshops cartographic styles guidelines](https://en.wikipedia.org/wiki/Wikipedia:WikiProject_Maps/Conventions) together with the latest and most accurate open geographic data.

**Wikimedia Fundation & IEG:** The design and development of this project is supported through an [Individual Engagement Grant](http://meta.wikimedia.org/wiki/Grants:IEG/Wikimaps_Atlas) from the Wikimedia Foundation.

## Repository

This repository provides a mechanism to generate [TopoJSON](https://github.com/mbostock/topojson) and [SVG](http://en.wikipedia.org/wiki/SVG) base maps for data visualization.

**Process improvement:** _Wikimaps Atlas_ tremendously ease the dowload and processing of publicly available GIS resources into elegant (Wikipedia maps guidelines complient), web friendly and data binding friendly maps.

**Style (Wikipedia):** Generated SVGs follow the solid and popular Wikipedia:Map Workshop cartographic guidelines. 

**Data biding:** Generated SVGs are all build according to a strict standard structure. XML polygons have clear `id`, allowing easy data biding.

**Kinds & layers:** We mirror solid best practices refined by Wikipedia cartographers over the past 8 years. Also, we currently provide the following outputs as stand alone files/layers:
* Administrative
 * {ITEM}_administrative_location_map.svg
 * {ITEM}_administrative_location_map-en.svg
* Topography
 * {ITEM}_topography_location_map.svg
* Waters
 * {ITEM}_rivers_location_map.topojson
* Shaded relief:
 * {ITEM}_shaded_relief_map-transparent.png
 * {ITEM}_shaded_relief_map-white.png
 * {ITEM}_shaded_relief_map-wikimaps.png (wp colored relief)

**Customization:** 
Provided layers can be combined, deleted, edited by graphists. Relevant `*.makifile` and color palettes can also be edited.

## Getting Started

### Dependencies (0%)


```
success: utilities nodejs something low_level       #a task with 4 requirements
    echo "======================================"   #this is the 1st command
    echo "Wikiatlas setup: done --------> 100% !"
    #tab before each command is COMPULSORY (spaces will bug!).
 
utilities:          # a task with no dependency
    sudo apt-get install git make curl unzip unrar gdal-bin 
 
nodejs:             #for d3js & svg generation
    sudo add-apt-repository ppa:chris-lea/node.js
    sudo apt-get update
{'fraction_non_alphanumeric': 0.08999827258593884, 'fraction_numerical': 0.0027638624978407324, 'mean_word_length': 4.872210953346856, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6729601', 'n_tokens_mistral': 1621, 'n_tokens_neox': 1517, 'n_words': 630}