Skip to content

Commit

Permalink
fix build
Browse files Browse the repository at this point in the history
  • Loading branch information
tjukanovt committed Oct 2, 2024
1 parent 27d6ec8 commit 515cb80
Show file tree
Hide file tree
Showing 3 changed files with 109 additions and 64 deletions.
31 changes: 22 additions & 9 deletions .github/workflows/gh-deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,20 +4,33 @@ on:
push:
branches:
- main
- master
workflow_dispatch:

jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions/setup-python@v2
# Checkout the repository with full history (fetch-depth: 0)
- name: Checkout repository
uses: actions/checkout@v2
with:
fetch-depth: 0

# Setup Python 3.x environment
- name: Setup Python
uses: actions/setup-python@v2
with:
python-version: 3.x
- run: pip install mkdocs>=1.2.3
- run: pip install mkdocs-material
- run: pip install mkdocs-click
- run: pip install pymdown-extensions
- run: pip install mkdocs-rss-plugin
- run: mkdocs gh-deploy --force

# Install all the necessary dependencies in one step
- name: Install dependencies
run: |
pip install mkdocs>=1.2.3
pip install mkdocs-material
pip install mkdocs-click
pip install pymdown-extensions
pip install mkdocs-rss-plugin
# Deploy the site using mkdocs
- name: Deploy with MkDocs
run: mkdocs gh-deploy --force
141 changes: 86 additions & 55 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,64 +1,95 @@
<h1 align="center"><b>#30DayMapChallenge 🌎🌏🌎</b></h1>

## Daily social mapping project happening every November
The official website for #30DayMapChallenge, a daily mapmaking challenge open to everyone.

![Themes for the maps. See more below.](https://raw.githubusercontent.com/tjukanovt/30DayMapChallenge/main/images/flyers/30dmc-2023.png)

| Day | Date | Theme | Details |
|-----|------------|------------------|----------------------------------------------|
| 1 | 01-11-2023 | Points | A map with points |
| 2 | 02-11-2023 | Lines | A map with lines |
| 3 | 03-11-2023 | Polygons | A map with polygons |
| 4 | 04-11-2023 | A bad map | Let's get this over with |
| 5 | 05-11-2023 | Analog Map | Non-digital maps |
| 6 | 06-11-2023 | Asia | Largest of the continents |
| 7 | 07-11-2023 | Navigation | A map that helps you to navigate |
| 8 | 08-11-2023 | Africa | Second-largest and second-most populous continent |
| 9 | 09-11-2023 | Hexagons | 6 sides, 6 angles, and 6 vertices |
| 10 | 10-11-2023 | North America | Northern part of the American continent |
| 11 | 11-11-2023 | Retro | A blast from the past |
| 12 | 12-11-2023 | South America | Southern part of the American continent |
| 13 | 13-11-2023 | Choropleth | Classic thematic map: a choropleth |
| 14 | 14-11-2023 | Europe | The westernmost peninsulas of Eurasia |
| 15 | 15-11-2023 | OpenStreetMap | The greatest of the datasets. Remember to give credit. |
| 16 | 16-11-2023 | Oceania | Region made up of thousands of islands throughout the Central and South Pacific |
| 17 | 17-11-2023 | Flow | Flow of transport, people |
| 18 | 18-11-2023 | Atmosphere | Conditions of the atmosphere can be either weather or climate |
| 19 | 19-11-2023 | 5-minute map | Spend no more than 5 minutes to prepare this map |
| 20 | 20-11-2023 | Outdoors | Map of mountains, trails, or something completely different |
| 21 | 21-11-2023 | Raster | Pixels, please |
| 22 | 22-11-2023 | North is not always up | ⬆️ |
| 23 | 23-11-2023 | 3D | The third dimension |
| 24 | 24-11-2023 | Black & white | Only two colors allowed |
| 25 | 25-11-2023 | Antarctica | A cold continent that can't be reached with Web Mercator |
| 26 | 26-11-2023 | Minimal | Less is more |
| 27 | 27-11-2023 | Dot | Dot density, a single dot in space or something different |
| 28 | 28-11-2023 | Is this a chart or a map? | In thematic maps, you can't always tell. Try to stretch the limits |
| 29 | 29-11-2023 | Population | A classic theme for a map |
| 30 | 30-11-2023 | "My favorite.." | You choose! |


The idea is to create maps based around different themes each day of November using the hashtag `#30DayMapChallenge`. You can prepare the maps beforehand, but the main idea is to publish maps on the dedicated days. Just include a picture of the map when you post to Twitter (or other platforms) with the hashtag. You don't have to sign up anywhere to participate. There are no restrictions on the tools, technologies or the data you use in your maps. Doing less than 30 is also fine. See the *Code of Conduct*.

## Code of Conduct
No matter if you are a GIS expert or never made a map before, everyone is welcome to participate,
The official repository for #30DayMapChallenge, a daily mapping challenge open to everyone.

Keep in mind a few things:
The idea is to create maps based around different themes each day of November using the hashtag `#30DayMapChallenge`. You can prepare the maps beforehand, but the main idea is to publish maps on the dedicated days. Just include a picture of the map when you post to Twitter (or other platforms) with the hashtag. You don't have to sign up anywhere to participate. There are no restrictions on the tools, technologies or the data you use in your maps. Doing less than 30 is also fine. See the *Code of Conduct* at the bottom of the page.

- All maps you publish have to be **your original work**. Don’t steal content from others.
- Give **credit to the original data source** whenever possible.
- The challenge is all about **creativity, openness and the joy of beautiful maps and cartography.** It is not a competition.
- **Don’t be an asshole**
## Data 🗺

Inspiration for the challenge came from [Inktober](https://inktober.com/) and [Tidy Tuesday](https://github.com/rfordatascience/tidytuesday).
You can use **what ever data you want.** But here are a few sources which could help you to get started or give you new ideas 👇

## Merchandise
- [OpenStreetMap](https://www.openstreetmap.org/)
- OpenStreetMap (OSM) is a collaborative project to create a free editable map of the world. If you seek for easy ways to get an extract of the data, you can check for [GeoFabrik](https://www.geofabrik.de/data/download.html) for Shapefiles or [Overpass API for GeoJSONs etc.](https://overpass-turbo.eu/).
- [Overture Maps Foundation](https://overturemaps.org/download/)
- OMF publishes global data extracts monthly which are a combination of OpenStreetMap and other open data sources.
- [Natural Earth Data](https://www.naturalearthdata.com/)
- Natural Earth is a public domain map dataset available at 1:10m, 1:50m, and 1:110 million scales. Featuring tightly integrated vector and raster data, with Natural Earth you can make a variety of visually pleasing, well-crafted maps with cartography or GIS software.
- [Free GIS Data](https://freegisdata.rtwilson.com/)
- The site contains a categorised list of links to over 500 sites providing freely available geographic datasets - all ready for loading into a Geographic Information System.
- [OS OpenData](https://www.ordnancesurvey.co.uk/opendatadownload/products.html)
- Ordnance Survey Open Data for Great Britain. Includes general topographic map data at a range of scales; useful thematic data such as greenspace, terrain, roads and rivers; postcode and place name georeferencing.
- [Humanitarian Data Exchange](https://data.humdata.org/)
- Interesting datasets from around the world.
- [LINZ Data Service](https://data.linz.govt.nz/)
- New Zealand land and sea data available for free under a Creative Commons licence via download or OGC APIs.
- [LINZ NZ Aerial Basemap](https://basemaps.linz.govt.nz/)
- Current aerial imagery for New Zealand available under a Creative Commons licence via WMTS or XYZ tile services.
- [Open Topography](https://opentopography.org/)
- Lidar point cloud and DEM data.
- [A collective list of free APIs for use in software and web development.](https://github.com/public-apis/public-apis)
- [GIS data repositories spreadsheet by Karen Payne](https://docs.google.com/spreadsheets/d/1utQRlrX3lJniBjWE3rNjLZeTRsbjH-zdjxNmXhhvO9Q/edit#gid=47)
- [Data is Plural](https://www.data-is-plural.com/)
- The best data newsletter out there with an awesome archive including also some very obscure datasets.

## Tools 🔨🔧

The challenge is open to any software, but here’s a list of popular open-source tools to consider. No programming skills are required. Or if you are a programmer, no design skills are required.

- [QGIS](https://www.qgis.org/en/site/)
- A Free and Open Source Geographic Information System. A desktop software that allows you to read/write multiple data formats and output (mainly static) maps.
- [Kepler](https://kepler.gl/)
- Open source geospatial analysis tool for large-scale data sets and for interactive maps.
- [Aerialod](https://ephtracy.github.io/index.html?page=aerialod)
- Not really a GIS tool, but can be used to create some stunning 3D visualizations
- [Blender](https://www.blender.org/)
- Free and open source 3D creation suite. Check out the BlenderGIS extension.
- [R packages for geospatial](https://www.r-project.org/)
- [sf](https://cran.r-project.org/web/packages/sf/index.html), [ggplot](https://ggplot2.tidyverse.org/), [tmap](https://cran.r-project.org/web/packages/tmap/vignettes/tmap-getstarted.html) and [rayshader](https://www.rayshader.com/) to mention few examples.
- [Python packages for geospatial](https://python.org/)
- [geopandas](https://geopandas.org/), [xarray-spatial](https://xarray-spatial.org), [matplotlib](https://matplotlib.org/2.0.2/gallery.html), [geoplot](https://residentmario.github.io/geoplot/), [hvplot](https://hvplot.holoviz.org/reference/index.html) and [plotly](https://plotly.com/python/) to mention a few.
- [Mapshaper](https://mapshaper.org)
- Useful for geospatial data processing in the browser such as file format conversion, map projection, feature simplification, filtering, clipping, merging etc. Can also be run [locally from the command line](https://github.com/mbloch/mapshaper).
- [Vega-Lite](https://vega.github.io/vega-lite/)
- Declarative visualization specification including [cartographic output](https://vega.github.io/vega-lite/examples/#maps-geographic-displays). Specifications can be written directly in JSON or via program language interfaces such as [altair](https://altair-viz.github.io) (Python) and [elm-vegalite](https://package.elm-lang.org/packages/gicentre/elm-vegalite/latest/VegaLite) (Elm). See, for example, this tutorial on using [OpenStreetMap with elm-vegalite](https://github.com/gicentre/litvis/blob/master/documents/tutorials/geoTutorials/openstreetmap.md)
- [Vega](https://vega.github.io/vega/)
- More flexible but lower-level declarative visualization specification including cartographic output. Specifications can be written directly in JSON or via program language interfaces such [elm-vega](https://package.elm-lang.org/packages/gicentre/elm-vega/latest/).
- [Litvis](https://github.com/gicentre/litvis)
- Literate Visualization notebook environment optimised for specifying visualizations and documenting the design process. While not specific to cartography, can be a useful environment for exploring cartographic design.
- [Observable](https://observablehq.com)
- Reactive notebook environment for generation of visualization and cartographic output embedded in a textual narrative. Focus is on using [d3](https://d3js.org) for specifying visual output.


## Tutorials & Helpful Resources 📚
If you want to make maps with QGIS, this video is a great starting point. Check out also other videos by [Klas Karlson](https://www.youtube.com/playlist?list=PLNBeueOmuY163iwu4VpZdjqqdU1HkRTP_)
- [Steven Bernard's QGIS Introduction](https://www.youtube.com/playlist?list=PL7HotvlLKHCs9nD1fFUjSOsZrsnctyV2R)
- [QGIS Tutorials by Ujaval Gandhi](https://www.qgistutorials.com/en/)
- [3D Landscape Tutorial by Alasdair Rae](http://www.statsmapsnpix.com/2020/03/making-3d-landscape-and-city-models.html)
- [Basics of Mapmaking by Kenneth Field](https://medium.com/nightingale/so-you-want-to-make-a-map-58c7f55f6b20)

[Get your official #30DayMapChallenge stickers from Redbubble.](https://www.redbubble.com/people/MapChallenge/shop)
## Maps & Stats
Every year the challenge gathers thousands of mappers around the globe. As the challenge has spread across various platforms, gathering statistics has proven to be nearly impossible.

<script type="text/javascript" src="https://www.redbubble.com/assets/external_portfolio.js"></script>
<script id="rb-xzfcxvzx" type="text/javascript">new RBExternalPortfolio('www.redbubble.com', 'mapchallenge', 2, 2).renderIframe();</script>
In 2021 there were more than 1200 mappers and more than 9000 maps created for the challenge. In 2020 more than 1000 people posted more than 7000 maps for the challenge on different platforms. If you want to see some maps from past challenges, browse the hashtag on [X](https://twitter.com/search?q=%2330DayMapChallenge&src=typed_query) or check the official [website](https://30daymapchallenge.com/) of the challenge and browse different years.

[#30DayMapChallenge bot by Haifeng Niu harvested comprehensive stats and maps from the challenge](https://github.com/hn303/30DayMapChallenge-Bot)

In 2020 & 2019 David Friggens did a huge lift on the [30DayMapChallenge2020Metadata repository](https://github.com/dakvid/30DayMapChallenge2020Metadata) with metadata & interactive gallery.

## Code of Conduct
No matter if you are a GIS expert or never made a map before this challenge, everyone is welcome to participate,

But keep in mind a few things:
- All maps you publish have to be **your original work**. Don’t steal content from others.
- Give **credit to the original data source** whenever possible.
- The challenge is all about **creativity, openness and the joy of beautiful maps and cartography.** It is not a competition,
- Be mindful in how you use AI tooling. If you generate all of your maps with generative AI tools, where's the fun? This is not a prompt engineering challenge.
- **Don’t be an asshole**. Don’t harass or steal from others.

Inspiration for the challenge came from [Inktober](https://inktober.com/) and [Tidy Tuesday](https://github.com/rfordatascience/tidytuesday).

## Merchandise

## About me
My name is Topi Tjukanov and I started the challenge in 2019 on Twitter. You can find more information about me and a contact form from my [personal website.](https://tjukanov.org/)
[Get your official #30DayMapChallenge stickers from Redbubble.](https://www.redbubble.com/people/MapChallenge/shop)
<table>
<p align="center"><a href="#"><img src="https://raw.githubusercontent.com/tjukanovt/30DayMapChallenge/main/images/logo/30DMC_Sticker_Formal.svg" width="400"></a></p>
</table>
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,7 @@ extra_css:

## Page tree
nav:
- Home: index.md
- Archive:
- 2022 Challenge:
- Portfolio collection: 2022/index.md
Expand Down

0 comments on commit 515cb80

Please sign in to comment.