3.0.5

Co-authored-by: David Larlet <david@larlet.fr>

.eslintrc.json

@@ -5,7 +5,7 @@
     "es6": true
   },
   "parserOptions": {
-    "ecmaVersion": 2020,
+    "ecmaVersion": 2021,
     "sourceType": "module"
   }
 }

.github/workflows/close-issues.yml

@@ -0,0 +1,23 @@
+# Doc: https://github.com/marketplace/actions/close-stale-issues
+name: Close inactive issues
+on:
+  schedule:
+    - cron: "30 1 * * *"
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - uses: actions/stale@v5
+        with:
+          days-before-issue-stale: 30
+          days-before-issue-close: 14
+          stale-issue-label: "stale"
+          stale-issue-message: "This issue is stale because it has been open for 30 days with no activity."
+          close-issue-message: "This issue was closed because it has been inactive for 14 days since being marked as stale."
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          any-of-labels: need infos,support

.github/workflows/release-helm.yml

@@ -0,0 +1,26 @@
+name: Release Charts
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  release:
+    # depending on default permission settings for your org (contents being read-only or read-write for workloads), you will have to add permissions
+    # see: https://docs.github.com/en/actions/security-guides/automatic-token-authentication#modifying-the-permissions-for-the-github_token
+    permissions:
+      contents: write
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Publish Helm charts
+        uses: stefanprodan/helm-gh-pages@v1.7.0
+        with:
+          charts_dir: charts
+          linting: off
+          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test-docs.yml

@@ -4,7 +4,9 @@ on:
   push:
     branches: [master]
   pull_request:
-    branches: [master]
+    path:
+      - umap/*
+      - pyproject.toml
 
 jobs:
   tests:
@@ -12,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     services:
       postgres:
-        image: postgis/postgis:12-2.5
+        image: postgis/postgis:14-3.4
         ports:
           - 5432:5432
         env:
@@ -20,7 +22,11 @@ jobs:
           POSTGRES_PASSWORD: postgres
           POSTGRES_DB: postgres
         options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
-
+      redis:
+        image: redis
+        options: --health-cmd "redis-cli ping" --health-interval 10s --health-timeout 5s --health-retries 5
+        ports:
+          - 6379:6379
     strategy:
       fail-fast: false
       matrix:
@@ -28,9 +34,9 @@ jobs:
         database: [postgresql]
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
@@ -40,21 +46,24 @@ jobs:
           sudo apt update
           sudo apt install libgdal-dev
           python -m pip install --upgrade pip
-          make develop installjs vendors
+          make develop
+          npm install mocha
       - name: run tests
         run: make test
         env:
           DJANGO_SETTINGS_MODULE: 'umap.tests.settings'
           UMAP_SETTINGS: 'umap/tests/settings.py'
           PLAYWRIGHT_TIMEOUT: '20000'
+          REDIS_HOST: localhost
+          REDIS_PORT: 6379
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Install dependencies
         run: |
           python3 -m pip install -e .[test,dev]
@@ -65,18 +74,3 @@ jobs:
 
       - name: Run Docs
         run: make docs
-
-  docs:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: '3.11'
-      - name: Install dependencies
-        run: |
-          python3 -m pip install -r docs/requirements.txt
-
-      - name: Run Docs
-        run: mkdocs build

.gitignore

@@ -4,13 +4,13 @@ umap/settings/local/*
 docs/_build
 umap/remote_static
 tmp/*
-umap/static/umap/vendors
 site/*
 .pytest_cache/
 node_modules
 umap.conf
-data
-./static
+/data
+/static
+package-lock.json
 
 ### Python ###
 # Byte-compiled / optimized / DLL files
@@ -22,3 +22,11 @@ dist/
 *.egg-info/
 playwright/.auth/
 test-results/
+
+### Transifex ###
+tx
+
+# Helm
+charts/*/charts
+helmfile.yaml
+charts/*/Chart.lock

Dockerfile

@@ -1,24 +1,9 @@
-FROM node:alpine AS vendors
-
-RUN apk add git
-
-WORKDIR /srv/umap
-
-COPY package.json .
-
-RUN npm install
-
-COPY . .
-
-RUN npm run vendors
-
 # This part installs deps needed at runtime.
-FROM python:3.11-slim as common
+FROM python:3.12-slim AS common
 
 RUN apt-get update && \
     apt-get install -y --no-install-recommends \
         tini \
-        uwsgi \
         sqlite3 \
         libpq-dev \
         gdal-bin \
@@ -28,7 +13,7 @@ RUN apt-get update && \
     rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
 
 # This part adds deps needed only at buildtime.
-FROM common as build
+FROM common AS build
 
 RUN apt-get update && \
     apt-get install -y --no-install-recommends \
@@ -53,13 +38,12 @@ WORKDIR /srv/umap
 
 COPY . /srv/umap
 
-RUN /venv/bin/pip install .[docker]
+RUN /venv/bin/pip install .[docker,s3,sync]
 
 FROM common
 
 COPY --from=build /srv/umap/docker/ /srv/umap/docker/
 COPY --from=build /venv/ /venv/
-COPY --from=vendors /srv/umap/umap/static/umap/vendors /srv/umap/umap/static/umap/vendors
 
 WORKDIR /srv/umap
 

Makefile

@@ -7,7 +7,7 @@ install: ## Install the dependencies
 
 .PHONY: develop
 develop: ## Install the test and dev dependencies
-	python3 -m pip install -e .[test,dev]
+	python3 -m pip install -e .[test,dev,sync,s3]
 	playwright install
 
 .PHONY: format
@@ -18,7 +18,7 @@ format: ## Format the code and templates files
 
 .PHONY: lint
 lint: ## Lint the code and template files
-	npx eslint umap/static/umap/
+	npx eslint umap/static/umap/js/
 	djlint umap/templates --lint
 	isort --check --profile black umap/
 	ruff format --check --target-version=py310 umap/
@@ -46,6 +46,13 @@ docker: ## Create a new Docker image and publish it
 	docker build -t umap/umap:${VERSION} .
 	docker push umap/umap:${VERSION}
 
+.PHONY: helm
+helm: ## Build the helm chart and publish it
+	$(eval VERSION=$(shell hatch version))
+	$(eval PACKAGE=$(shell helm package --dependency-update --app-version ${VERSION} ./charts/umap | grep "Successfully packaged" | awk '{print $$NF}'))
+	@echo "Successfully packaged helm chart in: ${PACKAGE}"
+	helm push ${PACKAGE} oci://registry-1.docker.io/umap
+
 .PHONY: build
 build: ## Build the Python package before release
 	@hatch build --clean
@@ -58,10 +65,10 @@ publish: ## Publish the Python package to Pypi
 test: testpy testjs
 
 testpy:
-	pytest -vv umap/tests/
+	pytest -vv umap/tests/ --dist=loadgroup --reruns 1 --maxfail 10
 
 test-integration:
-	pytest -xv umap/tests/integration/
+	pytest -xv umap/tests/integration/ --dist=loadgroup
 
 clean:
 	rm -f dist/*
@@ -82,12 +89,16 @@ tx_push:
 	tx push -s
 tx_pull:
 	tx pull
+changelog:
+	$(eval VERSION=$(shell hatch version))
+	@# Bearer token is readonly
+	@printf $(shell curl -sL -X POST -H "Authorization: Bearer ${GITHUB_TOKEN}" https://api.github.com/repos/umap-project/umap/releases/generate-notes  -d '{"target_commitish":"master","previous_tag_name":"", "tag_name": "${VERSION}"}' | jq .body | sed 's/https:\/\/github.com\/umap-project\/umap\/pull\//#/g' | sed 's/`/\\`/g')
 
 jsdir = umap/static/umap/js/
 filepath = "${jsdir}*.js"
 .PHONY: pretty
-pretty: ## Apply PrettierJS to all JS files (or specified `filepath`)
-	./node_modules/prettier/bin-prettier.js --write ${filepath}
+pretty: ## Apply Biome to all JS files (or specified `jsdir`)
+	./node_modules/@biomejs/biome/bin/biome check --write ${jsdir}
 
 .PHONY: lebab
 lebab: ## Convert JS `filepath` to modern syntax with Lebab, then prettify

biome.json

@@ -0,0 +1,52 @@
+{
+  "files": {
+    "include": ["umap/static/umap/js/**"],
+    "ignore": ["umap/static/umap/vendors/**"]
+  },
+  "formatter": {
+    "enabled": true,
+    "formatWithErrors": false,
+    "ignore": [],
+    "attributePosition": "auto",
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 88
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "style": {
+        "useBlockStatements": "off",
+        "noShoutyConstants": "warn",
+        "noParameterAssign": "off"
+      },
+      "complexity": {
+        "noForEach": "off"
+      },
+      "performance": {
+        "noDelete": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "arrowParentheses": "always",
+      "bracketSameLine": false,
+      "bracketSpacing": true,
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "quoteStyle": "single",
+      "semicolons": "asNeeded",
+      "trailingCommas": "es5"
+    }
+  },
+  "json": {
+    "formatter": {
+      "trailingCommas": "none"
+    }
+  },
+  "organizeImports": {
+    "enabled": true
+  }
+}

charts/umap/.helmignore

@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/

charts/umap/Chart.yaml

@@ -0,0 +1,16 @@
+apiVersion: v2
+name: umap
+description: A Helm chart to deploy umap on Kubernetes
+
+type: application
+
+version: 0.1.0
+
+appVersion: "2.7.2"
+
+dependencies:
+  - name: cnpg-cluster
+    version: 2.0.1
+    repository: https://charts.enix.io/
+    alias: cnpg
+    condition: cnpg.enabled

charts/umap/templates/_helpers.tpl

@@ -0,0 +1,73 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "umap.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "umap.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "umap.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "umap.labels" -}}
+helm.sh/chart: {{ include "umap.chart" . }}
+{{ include "umap.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "umap.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "umap.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "umap.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create }}
+{{- default (include "umap.fullname" .) .Values.serviceAccount.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.name }}
+{{- end }}
+{{- end }}
+
+{{/*
+Get the name of the persistent volume claim
+*/}}
+{{- define "umap.pvcName" -}}
+  {{- if .Values.persistence.existingClaim -}}
+    {{- printf "%s" (tpl .Values.persistence.existingClaim $) -}}
+  {{- else -}}
+      {{- printf "%s" (include "umap.fullname" .) -}}
+  {{- end -}}
+{{- end -}}

charts/umap/templates/deployment.yaml

@@ -0,0 +1,110 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "umap.fullname" . }}
+  labels:
+    {{- include "umap.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "umap.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      annotations:
+        checksum/config: {{ include (print $.Template.BasePath "/secret-config.yaml") . | sha256sum }}
+        checksum/env: {{ include (print $.Template.BasePath "/secret-env.yaml") . | sha256sum }}
+      {{- with .Values.podAnnotations }}
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      labels:
+        {{- include "umap.labels" . | nindent 8 }}
+        {{- with .Values.podLabels }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+    spec:
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      serviceAccountName: {{ include "umap.serviceAccountName" . }}
+      securityContext:
+        {{- toYaml .Values.podSecurityContext | nindent 8 }}
+      containers:
+        - name: {{ .Chart.Name }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.port }}
+              protocol: TCP
+          startupProbe:
+            httpGet:
+              path: /stats
+              port: http
+          livenessProbe:
+            httpGet:
+              path: /stats
+              port: http
+          readinessProbe:
+            httpGet:
+              path: /stats
+              port: http
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          {{- if .Values.cnpg.enabled }}
+          env:
+          - name: DATABASE_URL
+            valueFrom:
+              secretKeyRef:
+                name: {{ .Release.Name }}-cnpg-app
+                key: uri
+          - name: UMAP_SETTINGS
+            value: /etc/umap/umap.conf
+          {{- end }}
+          envFrom:
+          - secretRef:
+              {{- if .Values.umap.envFromSecret }}
+              name: {{ .Values.umap.envFromSecret }}
+              {{- else }}
+              name: {{ include "umap.fullname" . }}-env
+              {{- end }}
+          volumeMounts:
+            - name: config
+              mountPath: /etc/umap/
+              readOnly: true
+            - name: statics
+              mountPath: /srv/umap/static
+          {{- if .Values.persistence.enabled }}
+            - name: data
+              mountPath: /srv/umap/uploads/
+          {{- end }}
+      volumes:
+        - name: config
+          secret:
+            {{- if .Values.umap.configFromSecret }}
+            secretName: {{ .Values.umap.configFromSecret }}
+            {{- else }}
+            secretName: {{ include "umap.fullname" . }}-config
+            {{- end }}
+        - name: statics
+          emptyDir: {}
+      {{- if .Values.persistence.enabled }}
+        - name: data
+          persistentVolumeClaim:
+            claimName: {{ include "umap.pvcName" . }}
+      {{- end }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

charts/umap/templates/ingress.yaml

@@ -0,0 +1,31 @@
+{{- if .Values.ingress.enabled -}}
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{ include "umap.fullname" . }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  ingressClassName: {{ .Values.ingress.className }}
+  tls:
+    - hosts:
+        {{- range .Values.ingress.hosts }}
+        - {{ . | quote }}
+        {{- end }}
+      secretName: {{ include "umap.fullname" . }}-tls
+  rules:
+    {{- range .Values.ingress.hosts }}
+    - host: {{ . | quote }}
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: {{ include "umap.fullname" $ }}
+                port:
+                  number: {{ $.Values.service.port }}
+    {{- end }}
+{{- end }}

charts/umap/templates/pvc.yaml

@@ -0,0 +1,24 @@
+{{- if and (.Values.persistence.enabled) (not .Values.persistence.existingClaim) }}
+kind: PersistentVolumeClaim
+apiVersion: v1
+metadata:
+  {{- if .Values.persistence.annotations }}
+  annotations:
+    {{- toYaml .Values.persistence.annotations | nindent 4 }}
+  {{- end }}
+  name: {{ include "umap.pvcName" . }}
+  labels:
+    {{- include "umap.labels" . | nindent 4 }}
+spec:
+  accessModes:
+  {{- range .Values.persistence.accessModes }}
+    - {{ . | quote }}
+  {{- end }}
+  {{- with .Values.persistence.resources }}
+  resources:
+  {{- toYaml . | nindent 4 }}
+  {{- end }}
+  {{- if .Values.persistence.storageClassName }}
+  storageClassName: {{ .Values.persistence.storageClassName | quote }}
+  {{- end }}
+{{- end }}

charts/umap/templates/secret-config.yaml

@@ -0,0 +1,11 @@
+{{ if not .Values.umap.configFromSecret }}
+apiVersion: v1
+kind: Secret
+metadata:
+  name: {{ include "umap.fullname" . }}-config
+  labels:
+    {{- include "umap.labels" . | nindent 4 }}
+type: Opaque
+data:
+  umap.conf: {{ .Values.umap.config | b64enc }}
+{{- end }}

charts/umap/templates/secret-env.yaml

@@ -0,0 +1,13 @@
+{{ if not .Values.umap.envFromSecret }}
+apiVersion: v1
+kind: Secret
+metadata:
+  name: {{ include "umap.fullname" . }}-env
+  labels:
+    {{- include "umap.labels" . | nindent 4 }}
+type: Opaque
+data:
+{{- range $key, $value := .Values.umap.environment }}
+  {{ $key }}: "{{ $value | b64enc }}"
+{{- end }}
+{{- end }}

charts/umap/templates/service.yaml

@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "umap.fullname" . }}
+  labels:
+    {{- include "umap.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP
+      name: http
+  selector:
+    {{- include "umap.selectorLabels" . | nindent 4 }}

charts/umap/templates/serviceaccount.yaml

@@ -0,0 +1,13 @@
+{{- if .Values.serviceAccount.create -}}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ include "umap.serviceAccountName" . }}
+  labels:
+    {{- include "umap.labels" . | nindent 4 }}
+  {{- with .Values.serviceAccount.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+automountServiceAccountToken: {{ .Values.serviceAccount.automount }}
+{{- end }}

charts/umap/values.yaml

@@ -0,0 +1,125 @@
+# Default values for umap.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+replicaCount: 1
+
+image:
+  repository: umap/umap
+  pullPolicy: IfNotPresent
+  # Overrides the image tag whose default is the chart appVersion.
+  tag: ""
+
+imagePullSecrets: []
+nameOverride: ""
+fullnameOverride: ""
+
+serviceAccount:
+  # Specifies whether a service account should be created
+  create: true
+  # Automatically mount a ServiceAccount's API credentials?
+  automount: true
+  # Annotations to add to the service account
+  annotations: {}
+  # The name of the service account to use.
+  # If not set and create is true, a name is generated using the fullname template
+  name: ""
+
+podAnnotations: {}
+podLabels: {}
+
+podSecurityContext:
+  runAsUser: 1000
+  runAsGroup: 1000
+  fsGroup: 1000
+
+securityContext:
+  capabilities:
+    drop:
+    - ALL
+  readOnlyRootFilesystem: true
+  runAsNonRoot: true
+  runAsUser: 1000
+
+service:
+  type: ClusterIP
+  port: 8000
+
+ingress:
+  enabled: false
+  className: ""
+  annotations: {}
+  hosts:
+    - example.org
+
+resources: {}
+  # We usually recommend not to specify default resources and to leave this as a conscious
+  # choice for the user. This also increases chances charts run on environments with little
+  # resources, such as Minikube. If you do want to specify resources, uncomment the following
+  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
+  # limits:
+  #   cpu: 100m
+  #   memory: 128Mi
+  # requests:
+  #   cpu: 100m
+  #   memory: 128Mi
+
+nodeSelector: {}
+
+tolerations: []
+
+affinity: {}
+
+umap:
+  # Set environment variables supported by umap here
+  # see: https://docs.umap-project.org/en/stable/config/settings/
+  environment:
+    SECRET_KEY: CHANGE_ME
+    STATIC_ROOT: /srv/umap/static
+    MEDIA_ROOT: /srv/umap/uploads
+  # Configure environment variables using an existing secret in the same namespace.
+  # In this case the values above are not used
+  envFromSecret: null
+
+  # You can also provide umap.conf content here:
+  config: |
+    from umap.settings.base import *
+
+    # See: https://github.com/umap-project/umap/blob/master/umap/settings/local.py.sample
+  # Configure config file using an existing secret in the same namespace.
+  # In this case the values above are not used
+  configFromSecret: null
+
+persistence:
+  enabled: true
+  accessModes:
+    - ReadWriteOnce
+  annotations: {}
+  existingClaim: ""
+  storageClassName: ""
+  resources:
+    requests:
+      storage: 1Gi
+
+# Configure Cloudnative-pg operator for Postgis database
+# Alternatively, you can disable CNPG and provide your own
+# Postgis database by setting the `umap.environment.DATABASE_URL`
+cnpg:
+  enabled: true
+  replicaCount: 2
+  image:
+    repository: ghcr.io/cloudnative-pg/postgis
+    tag: 14
+  persistence:
+    storageClass: ""
+    size: 1Gi
+  clusterExtraSpec:
+    bootstrap:
+      initdb:
+        postInitTemplateSQL:
+          - CREATE EXTENSION postgis;
+          - CREATE EXTENSION postgis_topology;
+          - CREATE EXTENSION fuzzystrmatch;
+          - CREATE EXTENSION postgis_tiger_geocoder;
+
+  # See available values here: https://artifacthub.io/packages/helm/enix/cnpg-cluster?modal=values

docker-compose.yml

@@ -1,11 +1,19 @@
-version: '3'
-
 services:
 
+  # Usefull only to use the real time collaboration
+  redis:
+    image: redis:latest
+    healthcheck:
+      test: ["CMD-SHELL", "redis-cli ping | grep PONG"]
+      interval: 1s
+      timeout: 3s
+      retries: 5
+    command: ["redis-server"]
+
   db:
     healthcheck:
-        test: ["CMD-SHELL", "pg_isready -U postgres"]
-        interval: 2s
+      test: [ "CMD-SHELL", "pg_isready -U postgres" ]
+      interval: 2s
     image: postgis/postgis:14-3.3-alpine
     environment:
       - POSTGRES_HOST_AUTH_METHOD=trust
@@ -16,18 +24,35 @@ services:
     depends_on:
       db:
         condition: service_healthy
-    image: umap/umap:2.0.2
-    ports:
-      - "${PORT-8000}:8000"
+      redis:
+        condition: service_healthy
+    image: umap/umap:3.0.2
     environment:
+      - STATIC_ROOT=/srv/umap/static
+      - MEDIA_ROOT=/srv/umap/uploads
       - DATABASE_URL=postgis://postgres@db/postgres
       - SECRET_KEY=some-long-and-weirdly-unrandom-secret-key
       - SITE_URL=https://umap.local/
       - UMAP_ALLOW_ANONYMOUS=True
       - DEBUG=1
+      - REALTIME_ENABLED=1
+      - REDIS_URL=redis://redis:6379
     volumes:
       - data:/srv/umap/uploads
+      - static:/srv/umap/static
+
+  proxy:
+    image: nginx:latest
+    ports:
+      - "8000:80"
+    volumes:
+      - ./docker/nginx.conf:/etc/nginx/nginx.conf:ro
+      - static:/static:ro
+      - data:/data:ro
+    depends_on:
+      - app
 
 volumes:
   data:
+  static:
   db:

docker/entrypoint.sh

@@ -9,5 +9,5 @@ umap collectstatic --noinput
 umap wait_for_database
 # then migrate the database
 umap migrate
-# run uWSGI
-exec uwsgi --ini docker/uwsgi.ini
+# run the server
+exec uvicorn --proxy-headers --no-access-log --host 0.0.0.0 umap.asgi:application

docker/nginx.conf

@@ -0,0 +1,111 @@
+events {
+    worker_connections  1024;  # Adjust this to your needs
+}
+
+
+
+http {
+    proxy_cache_path /tmp/nginx_ajax_proxy_cache levels=1:2 keys_zone=ajax_proxy:10m inactive=60m;
+    proxy_cache_key "$uri$is_args$args";
+
+    map $http_upgrade $connection_upgrade {
+        default upgrade;
+        ''      close;
+    }
+
+    types {
+      application/javascript mjs;
+    }
+
+    include       mime.types;
+    default_type  application/octet-stream;
+    sendfile        on;
+    keepalive_timeout  65;
+
+    # Server block
+    server {
+        listen       80;
+        server_name  localhost;
+
+        # Static file serving
+        location /static/ {
+            alias /static/;
+            gzip on;
+            gzip_vary on;
+            gzip_proxied any;
+            gzip_types text/plain application/javascript application/x-javascript text/javascript text/xml text/css;
+            expires 365d;
+            access_log /dev/null;
+        }
+
+        # Geojson files
+        location /uploads/  {
+            alias /data/;
+            expires 30d;
+        }
+
+        location /favicon.ico {
+            alias /static/favicon.ico;
+        }
+
+        # X-Accel-Redirect
+        location /internal/ {
+            internal;
+            gzip_vary on;
+            gzip_static on;
+            add_header X-DataLayer-Version $upstream_http_x_datalayer_version;
+            alias /data/;
+        }
+
+        # Ajax proxy
+        location ~ ^/proxy/(.*) {
+            internal;
+            add_header X-Proxy-Cache $upstream_cache_status always;
+            proxy_cache_background_update on;
+            proxy_cache_use_stale updating;
+            proxy_cache ajax_proxy;
+            proxy_cache_valid 1m;  # Default. Umap will override using X-Accel-Expires
+            set $target_url $1;
+            # URL is encoded, so we need a few hack to clean it back.
+            if ( $target_url ~ (.+)%3A%2F%2F(.+) ){ # fix :// between scheme and destination
+              set $target_url $1://$2;
+            }
+            if ( $target_url ~ (.+?)%3A(.*) ){ # fix : between destination and port
+              set $target_url $1:$2;
+            }
+            if ( $target_url ~ (.+?)%2F(.*) ){ # fix / after port, the rest will be decoded by proxy_pass
+              set $target_url $1/$2;
+            }
+            resolver 8.8.8.8;
+            add_header X-Proxy-Target $target_url; # For debugging
+            proxy_pass_request_headers off;
+            proxy_set_header Content-Type $http_content_type;
+            proxy_set_header Content-Encoding $http_content_encoding;
+            proxy_set_header Content-Length $http_content_length;
+            proxy_read_timeout 10s;
+            proxy_connect_timeout 5s;
+            proxy_ssl_server_name on;
+            proxy_pass $target_url;
+            proxy_intercept_errors on;
+            error_page 301 302 307 = @handle_proxy_redirect;
+        }
+        location @handle_proxy_redirect {
+            resolver 8.8.8.8;
+            set $saved_redirect_location '$upstream_http_location';
+            proxy_pass $saved_redirect_location;
+        }
+
+        # Proxy pass to ASGI server
+        location / {
+            proxy_pass http://app:8000;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+            proxy_redirect off;
+            proxy_buffering off;
+        }
+    }
+}

docker/uwsgi.ini

@@ -1,12 +0,0 @@
-[uwsgi]
-http = :$(PORT)
-home = /venv
-module = umap.wsgi:application
-master = True
-vacuum = True
-max-requests = 5000
-processes = 4
-enable-threads = true
-static-map = /static=/srv/umap/static
-static-map = /uploads=/srv/umap/uploads
-buffer-size = 32768

docs-users/articles.md

@@ -1,9 +1,97 @@
 # Articles
 
-> Since their release in 2005, Google Maps-based tools have become the de facto solutions for a variety of online cartographic projects. Their success has been accompanied by a range of critiques denouncing the individualistic market-based logic imposed by these mapping services. Alternative options to this dominant model have been released since then; uMap is one of them. <mark>uMap is a free, open-source online mapping platform that builds on OpenStreetMap to enable anyone to easily publish web maps individually or collaboratively.</mark> In this paper, we reflect on the potential and limits of uMap based on our own experiences of deploying it in six different mapping projects. Through these experiences, uMap appears particularly well-suited for collaborative mapping projects, due to its ease in connecting to remote data and its high level of interoperability with a range of other applications. On the other hand, uMap seems less relevant for crowdmapping projects, due to its lack of built-in options to manage and control public contributions. Finally, the open-source philosophy of uMap, combined with its simplicity of use and its strong collaborative capacity, make it a great option for activist mapping projects as well as for pedagogical purposes to teach a range of topics including online collaborative cartography.
+## [Towards uMap 3 😱](https://www.openstreetmap.org/user/David%20Larlet/diary/404654) (2024-07-16)
+
+> The latest 2.4.X release sets the path for two major requested features: real-time collaboration and one-click remote data importers.
 >
-> [uMap: A Free, Open-Source Alternative to Google My Maps](https://cartographicperspectives.org/index.php/journal/article/view/1729)
+> Additionally, minor improvements and bugfixes have made the tool more stable and usable.
 
----
+[Full article →](https://www.openstreetmap.org/user/David%20Larlet/diary/404654){ .md-button }
 
-[Check out our blog in English too!](https://umap-project.org/blog/){ .md-button }
+
+## [Adding collaboration on uMap, fourth update](https://blog.notmyidea.org/adding-collaboration-on-umap-fourth-update.html) (2024-06-20)
+
+> The main branch of uMap now ships a web socket server, enabling local changes to be replicated to other peers.
+>
+> Here is short video capturing how the import of <mark>some data can be synced between two browsers</mark>.
+
+[Full article →](https://blog.notmyidea.org/adding-collaboration-on-umap-fourth-update.html){ .md-button }
+
+
+## [Mapping the CUNY Digital History Archive](https://cuny.manifoldapp.org/read/mapping-the-cuny-digital-history-archive) (2024-05)
+
+> This article discusses the implementation of the Learning CUNY History project, designed as an open education praxis for teaching and learning. It’s an example of a project-based assignment for undergraduate students and has evolved to explore the impact of integrating digital archives and digital mapping as instructional-digital tools. The project activates the CUNY Digital History Archive as a method of developing students’ digital literacy skills and investigates the potential to facilitate students’ learning. The archive is activated through student investigations and writings related to archival materials. Students then map the items as an interactive semester assignment. The project is described as occurring over three phases, and compares different digital mapping platforms. <mark>Ultimately, after careful consideration since its pilot phase, the project utilizes Open Street Map and uMap.</mark>
+
+[Full article →](https://cuny.manifoldapp.org/read/mapping-the-cuny-digital-history-archive){ .md-button }
+
+
+## [uMap 2 and beyond 🚀](https://www.openstreetmap.org/user/David%20Larlet/diary/403560) (2024-02-23)
+
+> A [major version](https://pypi.org/project/umap-project/2.0.0/) of uMap has been released last week.
+>
+> <mark>This release is inauguring a new era in versioning uMap</mark>: in the future, we’ll take care of better documenting breaking changes, so expect more major releases from now on. More details on [how we version](https://docs.umap-project.org/en/master/release/#when-to-make-a-release).
+>
+> A comprehensive changelog for that version is available in our technical documentation. Most of the changes for a major version are indeed technical, we are taking care of people deploying and maintaining instances with that approach. User-facing features are deployed continuously with our minor versions. We think that scheme is more valuable for the community.
+
+[Full article →](https://www.openstreetmap.org/user/David%20Larlet/diary/403560){ .md-button }
+
+
+## [Adding collaboration on uMap, third update](https://blog.notmyidea.org/adding-collaboration-on-umap-third-update.html) (2024-02-15)
+
+> I’ve spent the last few weeks working on uMap, still with the goal of bringing real-time collaboration to the maps. I’m not there yet, but <mark>I’ve made some progress that I will relate here</mark>.
+
+[Full article →](https://blog.notmyidea.org/adding-collaboration-on-umap-third-update.html){ .md-button }
+
+
+## [Adding Real-Time Collaboration to uMap, second week](https://blog.notmyidea.org/adding-real-time-collaboration-to-umap-second-week.html) (2023-11-21)
+
+> I continued working on uMap, an open-source map-making tool to create and share customizable maps, based on Open Street Map data.
+>
+> <mark>Here is a summary of what I did:</mark>
+>
+> * I reviewed, rebased and made some minor changes to [a pull request which makes it possible to merge geojson features together](https://github.com/umap-project/umap/pull/772) ;
+> * I’ve explored around the idea of using SQLite inside the browser, for two reasons : it could make it possible to use the [Spatialite](https://www.gaia-gis.it/fossil/libspatialite/index) extension, and it might help us to implement a CRDT with [cr-sqlite](https://github.com/vlcn-io/cr-sqlite) ;
+> * I learned a lot about the SIG field. This is a wide ecosystem with lots of moving parts, which I understand a bit better now.
+
+[Full article →](https://blog.notmyidea.org/adding-real-time-collaboration-to-umap-second-week.html){ .md-button }
+
+
+## [Adding Real-Time Collaboration to uMap, first week](https://blog.notmyidea.org/adding-real-time-collaboration-to-umap-first-week.html) (2023-11-11)
+
+> Last week, I’ve been lucky to start working on uMap, an open-source map-making tool to create and share customizable maps, based on Open Street Map data.
+>
+> <mark>My goal is to add real-time collaboration to uMap</mark>, but we first want to be sure to understand the issue correctly. There are multiple ways to solve this, so one part of the journey is to understand the problem properly (then, we’ll be able to chose the right path forward).
+
+[Full article →](https://blog.notmyidea.org/adding-real-time-collaboration-to-umap-first-week.html){ .md-button }
+
+
+## [Experimental choropleth layer in uMap](https://www.openstreetmap.org/user/ybon/diary/402589) (2023-10-12)
+
+> We’ve just released the version 1.9.2 of uMap, that includes a new experimental type of layer: <mark>choropleth!</mark>
+
+[Full article →](https://www.openstreetmap.org/user/ybon/diary/402589){ .md-button }
+
+
+## [uMap: fine-grained permissions and more](https://www.openstreetmap.org/user/David%20Larlet/diary/402475) (2023-09-27)
+
+> We finally managed to tackle a very popular feature request: [datalayers’ fine-grained permissions](https://github.com/umap-project/umap/pull/1307) 🎉. This is a huge step forward, <mark>allowing for a given map owner to only open a particular datalayer to edition</mark>. It will help people with contributive maps who need to setup a stable/fixed base layer. It also paved the way for even more control over the objects that are allowed for addition and/or edition. Please share with us your desired workflows.
+
+[Full article →](https://www.openstreetmap.org/user/David%20Larlet/diary/402475){ .md-button }
+
+
+## [Some news about uMap!](https://www.openstreetmap.org/user/ybon/diary/402248) (2023-08-25)
+
+> Since a few month, <mark>uMap has been integrated in a French state incubator</mark>, so things are moving quite a lot!
+>
+> uMap is now ten years old, and is deployed on many instances around the world. The one I know well is hosted by OSM France, and is close to reach one million maps created and 100.000 users.
+>
+> This incubation program is ported by the French [“Accélérateur d’initiatives citoyennes”](https://citoyens.transformation.gouv.fr/), it includes coaches and a small budget for non tech needs (UI/UX…). One goal of this program is to find financial support for uMap development and maintainance. A French administration, the [Agence pour la cohésion des territoires](https://agence-cohesion-territoires.gouv.fr/), is the first uMap financial backer since a few months. This allowed us to put up a small team to work, part time, in uMap […]
+
+[Full article →](https://www.openstreetmap.org/user/ybon/diary/402248){ .md-button }
+
+
+## [uMap: A Free, Open-Source Alternative to Google My Maps](https://cartographicperspectives.org/index.php/journal/article/view/1729) (2022-02-08)
+
+> Since their release in 2005, Google Maps-based tools have become the de facto solutions for a variety of online cartographic projects. Their success has been accompanied by a range of critiques denouncing the individualistic market-based logic imposed by these mapping services. Alternative options to this dominant model have been released since then; uMap is one of them. <mark>uMap is a free, open-source online mapping platform that builds on OpenStreetMap to enable anyone to easily publish web maps individually or collaboratively.</mark> In this paper, we reflect on the potential and limits of uMap based on our own experiences of deploying it in six different mapping projects. Through these experiences, uMap appears particularly well-suited for collaborative mapping projects, due to its ease in connecting to remote data and its high level of interoperability with a range of other applications. On the other hand, uMap seems less relevant for crowdmapping projects, due to its lack of built-in options to manage and control public contributions. Finally, the open-source philosophy of uMap, combined with its simplicity of use and its strong collaborative capacity, make it a great option for activist mapping projects as well as for pedagogical purposes to teach a range of topics including online collaborative cartography.
+
+[Full article →](https://cartographicperspectives.org/index.php/journal/article/view/1729){ .md-button }

docs-users/fr/articles.md

@@ -1,5 +1,72 @@
 # Articles
 
-> Le numérique peut-il aider à franchir les murs de l’École ? L’École peut-elle aider à s’affranchir des enfermements numériques ? Double défi joliment relevé par Hervé Baronnet, professeur des écoles dans l’académie de Bordeaux, membre de la Fabrique des Communs Pédagogiques. <mark>Avec le logiciel libre de cartographie numérique uMap, les élèves sont invités à des « balades pédagogiques »</mark> : à explorer et à s’approprier un territoire en produisant des cartes collaboratives et créatives. Présentée à la Journée Du Libre Educatif le 29 mars 2024 à Créteil, la démarche, inspirante, « enseigne des savoirs de manière interactive, concrète et mémorable. » Elle forge le désir et la capacité d’élargir, de découvrir, de conquérir son espace de vie. « En sortant de l’école / Nous avons rencontré / Un grand chemin de fer / Qui nous a emmenés / Tout autour de la terre / Dans un wagon doré » (Jacques Prévert) ….
+## [Créer des cartes interactives personnalisées : uMap ou Leaflet ?](https://www.d-booker.fr/content/242-creer-des-cartes-interactives-personnalisees-umap-ou-leaflet) (2025-02-01)
+
+> Dans ce guide, nous comparerons deux solutions libres populaires : uMap, une plateforme en ligne intuitive, et Leaflet, une bibliothèque JavaScript puissante.
+
+[Article complet →](https://www.d-booker.fr/content/242-creer-des-cartes-interactives-personnalisees-umap-ou-leaflet){ .md-button }
+
+## [Vers uMap 3 😱](https://www.openstreetmap.org/user/David%20Larlet/diary/404654#vers-umap-3-) (2024-07-16)
+
+> La dernière version 2.4.X ouvre la voie à deux fonctionnalités majeures demandées : la collaboration en temps réel et les assistants d’import de données à distance en un clic.
 >
-> [Hervé Baronnet : Libres balades pédagogiques](https://www.cafepedagogique.net/2024/03/29/herve-baronnet-libres-balades-pedagogiques/)
+> En outre, des améliorations mineures et des corrections de bogues ont rendu l’outil plus stable et plus utilisable.
+
+[Article complet →](https://www.openstreetmap.org/user/David%20Larlet/diary/404654#vers-umap-3-){ .md-button }
+
+## [uMap au cœur de la communication des Chambres d’agriculture](https://umap.dev.incubateur.anct.gouv.fr/blog/umap-au-cur-de-la-communication-des-chambres-dagriculture/) (2024-07-10)
+
+> Un témoignage de Frédéric Guimier, Consultant Communication et projets numériques au sein de la Chambre d’agriculture Pays de la Loire.
+
+[Article complet →](https://umap.incubateur.anct.gouv.fr/blog/umap-au-cur-de-la-communication-des-chambres-dagriculture/){ .md-button }
+
+## [Recenser les cabanes en pierres sèches : projet culturel & collaboratif](https://insidemap.eu/recenser-les-cabanes-en-pierres-seches-projet-culturel-collaboratif/) (2024-07-02)
+
+> Une trouvaille impromptue sur uMap, en balayant les cartes qui s’affichent : un carroyage et des dizaines de points, qui au clic affichent des photographies de constructions en pierres sèches. <mark>Il restait à tirer le fil pour comprendre l’ampleur du projet : le recensement des centaines de cabanes</mark>, relayé sur des sites Internet et adossée à une base de données, Wikipedra. Merci à Jean Louis Barthe pour cette très belle découverte et ses explications.
+
+[Article complet →](https://insidemap.eu/recenser-les-cabanes-en-pierres-seches-projet-culturel-collaboratif/){ .md-button }
+
+## [Partager l’information & mieux prévenir le risque inondation avec uMap](https://umap.incubateur.anct.gouv.fr/blog/partager-linformation-mieux-prevenir-le-risque-inondation-avec-umap/) (2024-06-10)
+
+> Dans les montagnes des Hautes-Pyrénées, les gaves connaissent régulièrement des crues torrentielles, avec comme conséquence des risques majeurs dans les vallées. <mark>Voici la présentation d’un projet global qui associe communication et analyse technique sur un outil cartographique basé sur uMap.</mark> Le syndicat mixte du Pays de Lourdes et des Vallées des Gaves propose un portail d’information consacré à la mémoire des inondations pour sensibiliser les maires et la population des Vallées des Gaves. Benoît Thouary, chargé d’études au service prévention des inondations, géographe de formation spécialisé en prévention des risques naturels, présente cette approche très complète, adossée à des archives multimédias et à une base de données.
+
+[Article complet →](https://umap.incubateur.anct.gouv.fr/blog/partager-linformation-mieux-prevenir-le-risque-inondation-avec-umap/){ .md-button }
+
+## [La cartographie numérique pour mieux lire et mieux écrire](https://eduscol.education.fr/4032/la-cartographie-numerique-pour-mieux-lire-et-mieux-ecrire) (2024-06)
+
+> uMap est une plateforme de cartographie libre et gratuite qui fait partie du SILL (Socle Interministériel des Logiciels Libres). Elle propose par défaut uniquement des fonds de cartes récents, accompagnés d’outils de cartographie similaires à ceux d’Édugéo et de Geoportail, avec des fonctionnalités intéressantes de sauvegarde et de partage des cartes. Il est possible d’ajouter des fonds de cartes anciens en suivant la démarche indiquée avec l’exemple de la carte de Metz 1872.
+
+[Article complet →](https://eduscol.education.fr/4032/la-cartographie-numerique-pour-mieux-lire-et-mieux-ecrire){ .md-button }
+
+## [Carte des arbres remarquables, la suite…](https://insidemap.eu/carte-des-arbres-remarquables-la-suite/) (2024-05-25)
+
+> Depuis la première version de la carte en mars 2019, les données ont pu changer et les fonctionnalités d’uMap ont évolué. Voilà l’occasion de refaire la carte et d’explorer d’autres approches. Bien entendu les fonctionnalités de diaporama sont toujours actives sur la carte d’origine.
+>
+> <mark>Les données sur les arbres remarquables sont à disposition sur le portail gouvernemental data.gouv.fr.</mark> Pour automatiser leur import, il est intéressant de choisir le lien…
+
+[Article complet →](https://insidemap.eu/carte-des-arbres-remarquables-la-suite/){ .md-button }
+
+## [Tutoriel : cartographier votre commune, ses voies et ses adresses, avec uMap](https://adresse.data.gouv.fr/blog/utilisez-umap-pour-visualiser-vos-adresses) (2024-05-13)
+
+> Il peut parfois s’avérer utile, dans le cadre d’un travail préparatoire ou pour une présentation, de créer une carte personnalisée de sa commune. À cet effet, <mark>l’ANCT met à disposition un outil, libre et open-source, à destination des agents publics pour créer des cartes en ligne</mark>, uMap.
+>
+> Cet outil, par ailleurs accessible sur d’autres instances pour le grand public ([uMap OSMFr](https://umap.openstreetmap.fr/) et [FramaCarte](https://framacarte.org/)), se distingue par sa grande polyvalence et ses fonctionnalités avancées de personnalisation. L’instance [uMap ANCT](https://umap.incubateur.anct.gouv.fr/) vise à mieux intégrer cet outil avec les autres outils des agents, à développer des fonctionnalités spécifiques et des configurations sur mesure, ainsi que faciliter un support dédié.
+
+[Article complet →](https://adresse.data.gouv.fr/blog/utilisez-umap-pour-visualiser-vos-adresses){ .md-button }
+
+## [Hervé Baronnet : Libres balades pédagogiques](https://www.cafepedagogique.net/2024/03/29/herve-baronnet-libres-balades-pedagogiques/) (2024-03-29)
+
+> Le numérique peut-il aider à franchir les murs de l’École ? L’École peut-elle aider à s’affranchir des enfermements numériques ? Double défi joliment relevé par Hervé Baronnet, professeur des écoles dans l’académie de Bordeaux, membre de la Fabrique des Communs Pédagogiques. <mark>Avec le logiciel libre de cartographie numérique uMap, les élèves sont invités à des « balades pédagogiques »</mark> : à explorer et à s’approprier un territoire en produisant des cartes collaboratives et créatives. Présentée à la Journée Du Libre Educatif le 29 mars 2024 à Créteil, la démarche, inspirante, « enseigne des savoirs de manière interactive, concrète et mémorable. » Elle forge le désir et la capacité d’élargir, de découvrir, de conquérir son espace de vie. « En sortant de l’école / Nous avons rencontré / Un grand chemin de fer / Qui nous a emmenés / Tout autour de la terre / Dans un wagon doré » (Jacques Prévert) ….
+
+[Article complet →](https://www.cafepedagogique.net/2024/03/29/herve-baronnet-libres-balades-pedagogiques/){ .md-button }
+
+## [Blogueur Food & Voyage : ajouter des cartes interactives à vos articles](https://blog.jawg.io/ajouter-des-cartes-interactives-a-vos-articles-de-blog/) (2023-03-21)
+
+> Qui a déjà consulté un blog pour des conseils de voyage ou des idées de restaurants à tester ? … Everybody ? C’est bien ce qui me semblait 😁
+>
+> Et qui parmi vous, a dû <mark>copier-coller le nom de ces lieux suggérés dans un moteur de recherche pour avoir une idée plus précise d’où ils se situaient ?</mark> Bon… je me sens moins seule !
+>
+> Je vous donne un exemple, vous cherchez un café sympa sur Paris et vous tombez sur l’article « Les 10 cafés les plus cosy de Paris. » Super, il n’y a plus qu’à les trouver. Sauf que, vous jetez un coup d’œil à l’adresse… euh le 9e, c’est quels stations de métro ça ? 🤔😅
+
+[Article complet →](https://blog.jawg.io/ajouter-des-cartes-interactives-a-vos-articles-de-blog/){ .md-button }
+

docs-users/fr/index.md

@@ -2,7 +2,7 @@
 
 uMap vous offre la possibilité de concevoir rapidement des cartes personnalisées avec des fonds OpenStreetMap (OSM) et de les intégrer facilement à votre site.
 
-- 📺 Regarder les [vidéos](videos.md).
+- 📺 Regarder les [vidéos](videos.md) et les [articles](articles.md).
 - 🤓 Consulter les tutoriels selon votre niveau.
 - 🤔 Explorer les [les questions/réponses de la FAQ](support/faq.md).
 - 🤕 Parcourir [la liste des erreurs possibles](support/errors.md).

docs-users/fr/support/advanced.md

@@ -0,0 +1,32 @@
+# Usages avancés de uMap
+
+## Précharger une carte avec des données {: #preloading-data }
+
+Il est possible de précharger une carte avec des données en utilisant
+les paramètres `data` ou `dataUrl` :
+
+* Le paramètre `data` doit être URI encodé
+  (avec la méthode `encodeURIComponent()` en JavaScript par exemple).
+* Le paramètre `dataUrl` doit lier vers une URL encodée
+  (avec la méthode `encodeURIComponent()` en JavaScript par exemple).
+
+Vous pouvez ajouter le paramètre `dataFormat` en fonction de la
+nature de vos données:
+
+* `geojson` (défaut)
+* `csv`
+* `gpx`
+* `georss`
+* `kml`
+* `osm`
+
+Cet exemple, utilisant le paramètre `data`, va charger une carte avec un marqueur
+positionné sur les Chutes du Niagara à partir de données en CSV :
+
+https://umap.openstreetmap.fr/fr/map/?data=name%252Clatitude%252Clongitude%250AChutes%20du%20Niagara%252C43.084799710219066%252C-79.0693759918213&dataFormat=csv
+
+Cet exemple, utilisant le paramètre `dataUrl`, va charger une carte avec les contours géographiques pour
+la commune d’Arles, récupérés dynamiquement depuis
+[geo.api.gouv.fr](https://geo.api.gouv.fr/) en GeoJSON :
+
+https://umap.openstreetmap.fr/fr/map/?dataUrl=https%3A%2F%2Fgeo.api.gouv.fr%2Fcommunes%3Fcode%3D13004%26format%3Dgeojson%26geometry%3Dcontour

docs-users/fr/support/faq.md

@@ -1,6 +1,6 @@
 # Questions Fréquemment Posées (FAQ)
 
-## Quelle syntaxe est acceptée dans les champs de description ?
+## Quelle syntaxe est acceptée dans les champs de description ?  {: #text-formatting }
 
 * `*simple astérisque pour italique*` → *simple astérisque pour italique*
 * `**double astérisque pour gras**` → **double astérisque pour gras**
@@ -10,3 +10,109 @@
 * `Lien simple : [[http://example.com]]` → Lien simple : [http://example.com](http://example.com)
 * `Lien avec texte : [[http://exemple.fr|texte du lien]]` → Lien avec texte : [texte du lien](http://example.com)
 * `--- pour un séparateur horizontal` ⤵ <hr>
+
+## Quels sont les raccourcis clavier? {: #keyboard-shortcuts}
+
+Sur macOS, utliser `Cmd` à la place de `Ctrl`.
+
+### Génériques
+
+* `Ctrl+F` → ouvre le panneau de recherche
+* `Ctrl+E` → bascule en mode édition
+* `Escape` → ferme le panneau ou la fenêtre dialogue ouverte
+* `Shift+drag` sur la carte → zoom vers cette zone
+* `Shift+click` sur les boutons de zoom → zoom ou dézoom de trois niveaux
+
+### En mode édition
+
+* `Ctrl+E` → retour à l’aperçu
+* `Ctrl+S` → sauvegarde la carte
+* `Ctrl+Z` → annule tous les changements depuis la dernière sauvegarde
+* `Ctrl+M` → ajouter un nouveau marqueur
+* `Ctrl+P` → commence un nouveau polygone
+* `Ctrl+L` → commence une nouvelle ligne
+* `Ctrl+I` → ouvre le panneau d’import de données
+* `Ctrl+O` → ouvre le panneau d’import et le navigateur de fichiers
+* `Ctrl++` → zoom
+* `Ctrl+-` → dézoome
+* `Shift+click` sur un élément → ouvre le panneau d’édition de cet élément
+* `Ctrl+Shift+click` sur un élément → ouvre le panneau d’édition du calque de cet élément
+
+## Quelle syntaxe est acceptée dans les règles de formattage conditionnel ? {: #conditional-rules }
+
+* `macolonne=impair` → cible les éléments dont la colonne  `macolonne` vaut `impair`
+* `macolonne!=impair` → cible les éléments dont la colonne `macolonne` est absente ou dont la valeur est différente de `impair`
+* `macolonne>12` → cible les éléments dont la colonne `macolonne` est supérieur au nombre `12`
+* `macolonne<12.34` → cible les éléments dont la colonne `macolonne` est inférieure au nombre `12.34`
+* `macolonne=` → cible les éléments dont la colonne `macolonne` est vide
+* `macolonne!=` → cible les éléments dont la colonne `macolonne` n'est pas vide
+* `macolonne=true/false` → cible les éléments dont la colonne `macolonne` est explicitement `true` (ou `false`)
+* `macolonne!=true/false` → cible les éléments dont la colonne `macolonne` est différente de `true` (ou `false`)
+
+Quand la condition est vraie pour un élément donné, le style associé sera appliqué.
+
+
+## Comment utiliser les variables ? {: #variables}
+
+Utiliser une variable est aussi simple que `{variable}`.
+
+Il est possible de définir une seconde variable de repli, dans le cas où la première ne serait pas définie: `{variable|repli}`
+
+La valeur de repli peut être une chaîne, définie entre guillemets: `{variable|"repli"}`
+
+Il est possible d'enchaîner plusieurs variables: `{variable|autrevariable|"une chaîne"}`
+
+Il est possible d'utiliser une variable à l'intérieur d'une URL: `[[https://domain.org/?locale={locale}|Wikipedia]]`
+
+Ou même comme chemin vers une image: `{{{variable}}}` (noter le triple `{}`).
+
+### Variables disponibles pour les éléments de la carte:
+
+Ces variables peuvent être utilisées dans le champ description d'un élément, ou comme gabarit manuel de popup.
+
+Toute propriété de l'élément sera disponible, ainsi que:
+
+- `{lat}/{lng}` → la position de l'élément (ou le centroïde dans le cas d'une ligne ou d'un polygone)
+- `{alt}` → l'altitude (pour les points uniquement), si elle est définie dans les données
+- `{locale}` → la langue sous la forme `fr` ou `fr_CA` quand une variante est utilisée
+- `{lang}` → la langue sous la forme `fr` ou `fr-ca` quand une variante est utilisée
+- `{measure}` → la longueur d'une ligne ou la surface d'un polygone
+- `{gain}`/`{loss}` → la dénivelée positive/négative d'une ligne (seulement si elle contient les altitudes)
+- `{rank}` → la rang d'un élément dans son calque
+- `{layer}` → le nom du calque de l'élément
+- `{zoom}` → le zoom actuel de la carte
+
+### Variables disponibles dans les URL de données distantes:
+
+- `{bbox}` → la bbox de la carte sous la forme `sud_ouest_lng,sud_ouest_lat,nord_est_lng,nord_est_lat`
+- `{north}/{top}` → la latitude nord de la vue actuelle de la carte
+- `{south}/{bottom}` → la latitude sud de la vue actuelle de la carte
+- `{east}/{right}` → la longitude est de la vue actuelle de la carte
+- `{west}/{left}` → la longitude ouest de la vue actuelle de la carte
+- `{zoom}` → le zoom actuel de la carte
+- `{lat}` → la latitude du centre actuel de la carte
+- `{lng}` → la longitude du centre actuel de la carte
+
+
+## Quels statuts peut avoir une carte ? {: #map-statuses}
+
+### En accès
+
+* **Brouillon (privé)**: Vous seul et votre équipe pouvez accéder à la carte.
+* **Tout le monde (public)**: Tout le monde peut accéder à la carte, qui est visible dans la recherche et la page d’accueil. La carte est indexée dans les moteurs de recherche (Google, etc.).
+* **Quiconque a le lien**: La carte est visible par toutes les personnes qui en ont le lien. Elle n’est pas indexée dans les moteurs de recherche.
+* **Éditeurs et équipe seulement**: Vous seul et votre équipe pouvez accéder à la carte.
+
+Les personnes affichant une carte à laquelle elles n’ont pas accès auront une page d’erreur 403.
+
+### En édition
+
+* **Propriétaire uniquement**: Vous seul pouvez modifier la carte.
+* **Éditeurs et équipe seulement**: Vous seul et votre équipe pouvez modifier la carte.
+* **Tout le monde**: Tout le monde peut modifier la carte, même les comptes anonymes.
+
+Pour les cartes créées sans compte :
+
+* **Modifiable seulement avec le lien d’édition secret**: Seules les personnes avec un lien d’édition pourront modifier la carte.
+
+Ces réglages sont aussi disponibles pour chaque calque.

docs-users/fr/tutorials/10-embed-remote-data.md

@@ -7,6 +7,7 @@
     - Utiliser un portail *open data*
     - Créditer la source des données pour respecter la licence
 
+
 ## Procédons par étapes
 
 Jusqu’ici toutes les cartes que nous avons créées montrent des données
@@ -156,8 +157,11 @@ calque*. Les différents types de calques sont :
     cercle.
 -   **Heatmap** : les données sont représentées sous forme de *carte de
     chaleur*.
--   **Cloroplèthe** : cet affichage est adapté aux polygones, et permet
+-   **Choroplèthe** : cet affichage est adapté aux polygones, et permet
     de graduer leur couleur.
+-   **Cercles proportionnels** : cette représentation est adaptée pour
+    des valeurs quantitatives absolues (qui peuvent s’ajouter).
+    La surface des cercles est proportionnelle à la quantité.
 
 Les types *Avec cluster* et *Heatmap* sont plutôt adaptés aux calques
 contenant uniquement des points. Lorsqu’on choisit un de ces modes, un

docs-users/fr/tutorials/12-display-grist-data.md

@@ -0,0 +1,141 @@
+!!! abstract "Ce que nous allons apprendre"
+
+    - Créer un gabarit Grist compatible uMap
+    - Géocoder des adresses (:fontawesome-solid-landmark-flag: pour les agents publics seulement)
+    - Rendre un document Grist public
+    - Lier le CSV de Grist avec un calque uMap
+
+
+Un [un film tutoriel](https://tube.numerique.gouv.fr/w/kya6m1aFtgDcy2LMkgUBya?start=12s)
+a été créé pour montrer le déroulé de ce tutoriel.
+
+
+## 1. Créer un gabarit Grist compatible uMap
+
+!!! osm-instance "Pour le grand public, les associations…"
+
+    Rendez-vous sur le [site officiel de Grist](https://www.getgrist.com/) ou votre propre instance.
+
+!!! french-instance "Pour les agents publics"
+
+    Rendez-vous sur le site Grist agents publics via
+    [La Suite Numérique](https://lasuite.numerique.gouv.fr/services/grist).
+
+Créer un nouveau document vide :
+
+![Interface pour créer un nouveau document Grist.](../../static/tutoriels/grist-new-document.png)
+
+Ajouter les colonnes nécessaires, plus au moins ces trois colonnes : `Adresse`, `Latitude`, `Longitude`.
+
+![Interface d’un nouveau document Grist vide.](../../static/tutoriels/grist-empty-document.png)
+
+
+!!! warning
+
+    Attention, il faut mettre les colonnes `Latitude` et `Longitude` en type `Texte` :
+
+    ![Interface pour renseigner le type des colonnes.](../../static/tutoriels/grist-column-type-text.png)
+
+
+## 2. Géocoder des adresses (:fontawesome-solid-landmark-flag: pour les agents publics seulement)
+
+!!! french-instance "Pour les agents publics"
+
+    Cette conversion n’est accessible qu’aux agents publics, elle consiste
+    à convertir automatiquement les adresses en coordonnées géographiques
+    (latitude, longitude). Si vous avez déjà ces informations dans votre
+    document, vous pouvez passer à l’étape 3 ci-dessous.
+
+
+Il faut maintenant ajouter l’outil de géocodage développé par l’ANCT.
+Pour ça, cliquer sur « Ajouter une vue à la page » :
+
+![Interface pour créer une vue Grist.](../../static/tutoriels/grist-empty-view.png)
+
+
+Puis choisir `Custom`, sélectionner le nom de la table dans la source des données
+(ici « Table1 »), et aussi sélectionner la table dans `Select by` :
+
+![Interface pour créer une vue custom Grist.](../../static/tutoriels/grist-custom-view.png)
+
+Dans la colonne de droite, si on est sur l’instance Grist de l’ANCT,
+choisir « Geocodeur » dans la liste déroulante,
+sinon choisir `Custom URL` et ajouter l’URL suivante:
+
+<https://betagouv.github.io/grist-custom-widgets-fr-admin/geocode>
+
+Dans le panneau de droite, sélectionner les colonnes permettant de connecter
+l’outil à notre tableau :
+
+![Interface pour associer les colonnes sur une vue Grist.](../../static/tutoriels/grist-columns-view.png)
+
+La colonne `Adresse` comme source, puis bien référence les colonnes `Latitude` et `Longitude`.
+
+On peut optionnellement ajouter une colonne `Adresse normalisée` (dans le tableur)
+et la référencer ici, dans ce cas le géocodeur affichera l’adresse qu’il a trouvé.
+Ça permet un contrôle de plus.
+
+Renseigner ensuite une ou plusieurs lignes de données,
+en essayant d’avoir une adresse aussi précise que possible :
+
+![Interface pour convertir via une vue Grist.](../../static/tutoriels/grist-conversion-view.png)
+
+Puis cliquer sur « Traitement spécifique » pour ne traiter
+que la ligne sélectionnée, ou bien sur « Traitement global »
+pour traiter toutes les lignes du document.
+
+![Interface pour convertir via une vue Grist (résultat).](../../static/tutoriels/grist-conversion-view-result.png)
+
+
+## 3. Rendre un document Grist public
+
+Il faut ensuite rendre le document Grist public pour pouvoir ensuite le référencer côté uMap.
+
+Pour ça, aller dans « Gérer les utilisateurs » :
+
+![Interface pour gérer les utilisateurs dans Grist.](../../static/tutoriels/grist-user-management.png)
+
+Puis activer l’accès public :
+
+![Interface pour ouvrir les permissions dans Grist.](../../static/tutoriels/grist-permissions-management.png)
+
+
+## 4. Lier le CSV de Grist avec un calque uMap
+
+Pour copier l’URL qu’on va indiquer côté uMap, c’est ici
+(clic droit « enregistrer le lien ») :
+
+![Interface pour copier le lien vers l’export CSV dans Grist.](../../static/tutoriels/grist-download-csv.png)
+
+Le lien devrait ressembler à quelque chose comme ça :
+
+https://grist.incubateur.net/o/docs/api/docs/4McELEs6kBpQAkmzupHy9F/download/csv?viewSection=1&tableId=Table1&activeSortSpec=%5B%5D&filters=%5B%5D&linkingFilter=%7B%22filters%22%3A%7B%7D%2C%22operations%22%3A%7B%7D%7D
+
+Maintenant, créer une carte sur uMap et ajouter un calque :
+
+![Interface pour ajouter un calque dans uMap.](../../static/tutoriels/grist-umap-newlayer.png)
+
+![Interface pour ajouter un calque dans uMap avec un nom.](../../static/tutoriels/grist-umap-newlayer-name.png)
+
+Dans « Données distantes », ajouter l’URL de Grist et choisir le format `CSV` :
+
+![Interface pour ajouter un calque dans uMap avec une URL.](../../static/tutoriels/grist-umap-newlayer-url.png)
+
+Pour une meilleure expérience utilisateurs, vous pouvez choisir
+l’option `Proxy` avec un cache de la bonne durée selon la fréquence
+de mise à jour des données dans Grist :
+
+![Interface pour ajouter un calque dans uMap avec un proxy.](../../static/tutoriels/grist-umap-newlayer-proxy.png)
+
+Pour améliorer l'intégration des données, allez dans les paramètres avancés
+de la carte, puis dans les propriétés par défaut et :
+
+- ajouter `Nom` comme clé pour le libellé, le filtre et la recherche
+- ajouter `Catégorie` pour générer des filtres automatiques
+
+![Interface pour ajouter un calque avec des filtres dans uMap.](../../static/tutoriels/grist-umap-newlayer-advanced.png)
+
+Et voilà !
+
+![Interface de la carte finale dans uMap.](../../static/tutoriels/grist-umap-result.png)
+

docs-users/fr/tutorials/2-first-map.md

@@ -11,8 +11,14 @@ lieux (domicile, vacances, travail, etc.). Procédons par étapes.
 
 ### 1. Le mode édition
 
-Rendez-vous sur le site <http://umap.openstreetmap.fr/> et cliquez sur
-le bouton **Créer une carte** suivant :
+!!! osm-instance "Pour le grand public, les associations…"
+
+    Rendez-vous sur l’instance uMap d’OSM <https://umap.openstreetmap.fr/>
+
+!!! french-instance "Pour les agents publics"
+
+    Rendez-vous sur le site uMap agents publics <https://umap.incubateur.anct.gouv.fr/>
+    et connectez-vous en haut à gauche. La connexion utilise ProConnect.
 
 <shot-scraper
     data-output="static/tutoriels/create-map.png"
@@ -83,15 +89,15 @@ reviendrons.
 Maintenant, sauvegardez la carte avec le bouton **Enregistrer** : un
 texte est affiché en haut de la carte, comme celui ci-dessous :
 
+#### Pour le grand public sur l'instance OSM
+
 <shot-scraper
     data-output="static/tutoriels/create-map-alert.png"
     data-url="https://umap.openstreetmap.fr/fr/map/new/"
     data-alt="Message d’alerte contenant le lien d’édition."
     data-width="790"
     data-height="226"
-    data-selector="#umap-alert-container"
-    data-wait-for="document.querySelector('#umap-alert-container .umap-alert-actions')"
-    data-javascript="document.querySelector('button.leaflet-control-edit-save').click()"
+    data-selector='umap-alert-creation [role="dialog"]'
     >Message d’alerte contenant le lien d’édition.</shot-scraper>
 
 Ce texte explique que vous venez de créer une carte **anonyme** et vous
@@ -99,10 +105,20 @@ donne un lien (une URL) pour pouvoir modifier la carte. En effet la
 carte que vous avez créée n’est associée à aucun compte, et **uMap**
 considère que seules les personnes ayant ce *lien secret* peuvent la
 modifier. Vous devez donc conserver ce lien si vous souhaitez pouvoir
-modifier la carte. Nous verrons dans [le prochain tutoriel](3-create-account.md)
+modifier la carte ou saisir votre adresse de courriel pour le recevoir.
+
+Nous verrons dans [le prochain tutoriel](3-create-account.md)
 comment créer son catalogue de cartes en utilisant un compte, il n’est alors pas
 nécessaire de conserver de lien secret.
 
+#### Pour les agents publics sur l’instance qui leur est dédiée
+
+S’ils ne se sont pas connectés avant de créer leur carte, le message est différent :
+
+![Le lien vers la connexion MonComptePro](../../static/tutoriels/proconnect-connexion.png)
+
+Il n’est pas possible d’enregistrer les modifications apportées à une carte anonyme sur cette instance.
+
 ### 3. Ajouter un marqueur
 
 Commencez par déplacer et zoomer la carte pour visualiser l’endroit
@@ -125,7 +141,7 @@ Le curseur prend la forme d’un signe
 le bouton gauche de la souris : un *marqueur bleu* et carré est créé à
 cet endroit et un panneau apparaît à droite.
 
-![umap_marqueur.jpg](../../static/tutoriels/2-je-cree-ma-premiere-carte-umap/umap_marqueur.jpg)
+![Un marqueur uMap.](../../static/tutoriels/2-je-cree-ma-premiere-carte-umap/umap_marqueur.jpg)
 
 Ce panneau vous permet
 d’associer un nom et une description au marqueur :
@@ -180,13 +196,19 @@ actuels**.
 
 ### 5. Enregistrer la carte
 
-Toute modification de la carte doit être sauvegardée sur le serveur uMap
+Toute modification de la carte doit être sauvegardée
 en cliquant sur le bouton **Enregistrer** en haut à droite. Cette
 opération enregistre toutes les modifications depuis la dernière
 sauvegarde : vous pouvez donc réaliser plusieurs modifications à la
 suite puis les enregistrer. A l’inverse le bouton **Annuler** permet de
 supprimer toutes les modifications depuis la dernière sauvegarde.
 
+!!! note
+    L’enregistrement se fait sur les serveurs d’OpenStreetMap dans le cas
+    d’une utilisation d’uMap OSM ou ceux de l’ANCT si uMap pour
+    les agents publics est utilisé.
+
+
 Après avoir enregistré les modifications, le bouton Annuler est remplacé
 par **Désactiver l’édition**. Cela vous permet de quitter le mode
 édition pour voir la carte en mode consultation. Vous pouvez alors

docs-users/fr/tutorials/3-create-account.md

@@ -1,41 +1,44 @@
 !!! abstract "Ce que nous allons apprendre"
 
-    - Utiliser un compte pour retrouver ses cartes
-    - Changer la forme, la couleur et le pictogramme d’un marqueur
-    - Créer et modifier une ligne
-    - Contrôler l’affichage des étiquettes
+    - utiliser un compte pour retrouver ses cartes
+    - créer une équipe
+    - partager une carte avec une équipe
 
 ## Procédons par étapes
 
-Nous avons appris dans
-[le tutoriel précédent](2-first-map.md) comment créer une
-carte anonyme contenant un marqueur. Nous allons à présent créer une
-carte plus complète : la carte de nos vacances au [Camping de la plage
-Goulien](http://www.openstreetmap.org/way/119055693) sur la Presqu’île
-de Crozon en Bretagne.
+Nous avons appris dans [le tutoriel précédent](2-first-map.md) comment créer une
+carte anonyme contenant un marqueur. Nous allons à présent créer un compte et une équipe.
+
+Nota : il n’y a pas de carte anonyme sur
+[l’instance uMap pour les agents publics](https://umap.incubateur.anct.gouv.fr/fr/).
 
 Au lieu de créer une carte anonyme, nous allons utiliser un compte pour
 créer cette carte.
 
 ### 1. Utiliser un compte
 
-**uMap** permet d’associer ses cartes à un compte. Cela présente deux
-avantages importants par rapport à la création de cartes anonymes :
+**uMap** permet d’associer ses cartes à un compte. Cela présente plusieurs
+avantages importants par rapport à la création de cartes anonymes :
 
 -   les cartes créées avec un compte constituent un catalogue permettant
     d’accéder facilement à ses cartes
 -   on peut modifier chaque carte du catalogue sans avoir besoin de
     conserver un lien d’édition
+-   on peut gérer ses cartes en équipe et afficher le nom de l’équipe comme auteur
+-   pour les agents publics sur uMap ANCT : une fois connecté avec MonComptePro, on peut utiliser d’autres outils en association avec uMap, comme Grist.
 
-Le logiciel umap ne gère pas directement de comptes utilisateurs : la
-gestion des comptes dépend de la configuration du logiciel. Sur
-<http://umap.openstreetmap.fr>, vous pouvez utiliser un compte que vous
+Le logiciel umap ne gère pas directement de comptes utilisateurs : la
+gestion des comptes dépend de la configuration du logiciel.
+
+#### Pour le grand public, les associations…
+
+Sur <https://umap.openstreetmap.fr>, vous pouvez utiliser un compte que vous
 avez ouvert sur un site Web au choix : OpenStreetMap, Github,
 ou Bitbucket. Si vous n’avez aucun compte sur ces outils, c’est le
 moment de vous inscrire sur le site www.openstreetmap.org : cliquez
 **Créer un compte** dans le coin supérieur droit et suivez les
 instructions - une adresse mail vous sera demandée ([plus
-d’infos](http://openstreetmap.fr/inscription-openstreetmap)).
+d’infos](https://openstreetmap.fr/inscription-openstreetmap)).
 
 ![umap_header.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_header.png)
 
@@ -52,158 +55,53 @@ permettant d’accéder à l’ensemble des cartes créées avec ce compte.
 
 Notez l’URL de la barre d’adresse quand vous consultez votre catalogue
 de cartes : celle-ci contient le nom de votre compte - par exemple
-<http://umap.openstreetmap.fr/fr/user/cartocite/>. Vous pouvez
+<https://umap.openstreetmap.fr/fr/user/cartocite/>. Vous pouvez
 l’utiliser pour accéder à votre catalogue de cartes, même sans être
 connecté à votre compte : vous pouvez diffuser cette URL, les
 récipiendaires ne pourront pas modifier vos cartes.
 
-Toutes les cartes que vous créez en étant connecté à votre compte sont
-ajoutées à votre catalogue.
+#### :fontawesome-solid-landmark-flag: Pour les agents publics
 
-### 2. Créer un joli marqueur
+1. Se connectez à ProConnect : <https://moncomptepro.beta.gouv.fr/> <br>
+   Toute personne qui travaille pour un service public y a accès.
+2. Créez un compte, l’opération peut prendre quelques minutes.
+3. Sur [le site uMap pour les agents publics](https://umap.incubateur.anct.gouv.fr/fr/),
+   cliquez sur `Me Connecter`.
 
-Commençons par créer une carte : donnons-lui un nom, définissons une
-emprise et ajoutons un marqueur à [l’emplacement du
-camping](http://www.openstreetmap.org/?mlat=48.2387&mlon=-4.5434#map=16/48.2387/-4.5434).
-Nous avons vu dans [le tutoriel précédent](2-first-map.md) comment effectuer ces opérations.
+On peut accéder à la page de création de compte ProConnect directement
+depuis [uMap pour les agents publics](https://umap.incubateur.anct.gouv.fr/fr/).
 
-![umap_marqueur_props.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_marqueur_props.png)
+Le tableau de bord s’ouvre, il affiche l’ensemble des cartes que
+vous créez ainsi que les équipes auxquelles vous participez.
 
-Ce gros marqueur bleu n’est pas très explicite pour figurer un camping.
-Remédions à cela. Dans le panneau latéral visible lorsqu’un marqueur est
-sélectionné, le menu **Propriétés de la forme** permet de modifier
-l’apparence du marqueur :
+!!! french-instance "Pour les agents publics"
+    Associer une carte à une équipe vous permet d’afficher le nom de cette équipe au lieu du vôtre sur une carte (noms de votre commune, de votre service,…). Une équipe peut se composer d’une seule personne.
 
--   **Couleur** : cliquer sur `définir` permet de choisir une couleur.
-    Notez que vous pouvez définir une couleur par [son nom
-    CSS](http://www.w3schools.com/cssref/css_colors.asp) ou par son code
-    héxadécimal, que vous pouvez choisir par exemple avec ce [sélecteur
-    de couleurs](http://htmlcolorcodes.com/fr/selecteur-de-couleur/).
--   **Forme de l’icône** : le choix `Par défaut` correspond au marqueur
-    actuel, les autres choix sont Cercle, Goutte et Épingle.
--   **Image de l’icône** : cliquer sur `définir` pour choisir parmi une
-    centaine de pictogrammes. Notez que le picto n’est affiché que pour
-    les formes d’icônes `Par défaut` et `Goutte`.
+### 2. Créer une équipe
 
-Voici le marqueur obtenu avec les propriétés ci-contre :
+Une fois connecté sur l’instance uMap,
+cliquer sur « Mon espace », puis « Mes équipes » :
 
-![umap_camping.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_camping.png)
+![Lien vers l’onglet des équipes](../../static/tutoriels/my-teams.png)
 
-#### Modifier un marqueur
+Puis sur « Nouvelle équipe » et renseigner les informations
 
-![umap_modifier_marqueur.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_modifier_marqueur.png)
+![Formulaire d’édition des équipes](../../static/tutoriels/my-teams-form.png)
 
-Pour modifier un marqueur de la carte, plusieurs possibilités s’offrent à vous :
+Lorsqu’un nouvel utilisateur est associé à une équipe,
+il voit l’équipe s’afficher sur son tableau de bord,
+il accède à toutes les cartes qui sont partagées et il peut les modifier.
 
--   un clic sur le marqueur vous permet soit d’afficher le panneau
-    d’édition (stylo), soit de supprimer le marqueur (corbeille)
--   **shift-clic** est un raccourci qui affiche directement le panneau
-    d’édition
--   un glisser-déposer vous permet de déplacer le marqueur sur la carte
+!!! note
+    Tous les membres d’une équipe partagent les mêmes droits d’édition sur une carte
+    qui est associée à une équipe. Une équipe peut être supprimée,
+    ou son nom modifié en un simple clic.
 
-### 3. Créer une ligne
+### 3. Partager une carte avec une équipe
 
-Le premier jour de vacances nous allons en kayak de mer jusqu’à la
-Pointe de Dinan à l’ouest de la plage de Goulien. Traçons l’itinéraire
-suivi.
-
-<shot-scraper
-    data-output="static/tutoriels/draw-polyline.png"
-    data-url="https://umap.openstreetmap.fr/fr/map/new/"
-    data-alt="Bouton de dessin d’une ligne."
-    data-width="46"
-    data-height="47"
-    data-selector=".leaflet-toolbar-icon.umap-draw-polyline"
-    data-padding="5"
-    >Bouton de dessin d’une ligne.</shot-scraper>
-
-Le bouton **Dessiner une ligne** permet de tracer, point par point,
-une ligne constiutée de plusieurs segments.
-Cliquez à nouveau sur le dernier point tracé pour
-terminer la ligne : apparaît alors à droite un panneau permettant de
-donner un nom et une description à la ligne, comme pour les marqueurs.
-
-#### Modifier une ligne
-
-A tout moment vous pouvez sélectionner une ligne en double-cliquant
-dessus. Vous pouvez alors éditer ses propriétés dans le panneau latéral,
-ou modifier son tracé sur la carte :
-
--   **supprimer un point** de la ligne, matérialisé par un carré blanc,
-    en cliquant dessus
--   **déplacer un point** par un glisser-déposer
--   **insérer un point** en cliquant sur un carré gris se trouvant au
-    milieu de chaque segment
--   **allonger la ligne** avec un Ctrl-Clic lorsque le curseur est placé
-    sur le premier ou dernier point
--   **couper la ligne** en deux : Clic droit sur un point puis choisir
-    l’option `Scinder la ligne`
-
-![umap_ligne.jpg](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_ligne.jpg)
-
-#### Propriétés d’une ligne
-
-![umap_ligne_props.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_ligne_props.png)
-
-Les propriétés d’une
-ligne permettent de définir sa couleur et d’autres paramètres
-définissant son *style* :
-
--   l’**opacité** va de transparent à gauche à totalement opaque à
-    droite. Plus le trait est épais plus il peut être transparent.
--   l’**épaisseur** est définie en pixels, sa valeur par défaut est 3 :
-    glisser le curseur vers la droite pour un trait plus épais (qui sera
-    plus facile à sélectionner).
-
-Les **propriétés avancées** permettent de :
-
--   **simplifier** le tracé permet de réduire le nombre de points pour
-    l’adapter au niveau de zoom. Il est en général inutile de simplifier
-    un tracé réalisé *à la main*.
--   définir un **traitillé**, par une série de chiffres séparés par des
-    virgules : longueur (en pixels) visible, longueur invisible,
-    longueur visible, etc. L’épaisseur du trait doit être prise en
-    compte : plus les traits sont épais plus les intervalles doivent
-    être grands.
-
-Voici le style de trait obtenu avec les propriétés ci-contre :
-
-![umap_ligne_tirets.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_ligne_tirets.png)
-
-### 4. Ajouter des étiquettes
-
-![etiquettes.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/etiquettes.png)
-
-Pour aider l’identification des
-différents éléments de notre carte, nous pouvons leur associer une
-étiquette. L’onglet **Options d’interaction** permet de contrôler
-l’affichage d’une étiquette associée à chaque élément :
-
--   **Afficher une étiquette** active son affichage, elle est alors
-    placée automatiquement
--   **Direction de l’étiquette** vous permet de fixer la position, à
-    droite ou à gauche de l’élément, ou encore au-dessus ou en-dessous
--   **Afficher seulement au survol** de la souris est une option
-    intéressante si la carte est dense : afficher toutes les étiquettes
-    surchagerait la carte
--   **Étiquette cliquable** permet d’afficher l’infobulle correspondante
-    si l’utilisateur clique sur l’étiquette, et non seulement en cas de
-    clic sur la *géométrie* de l’élément.
-
-
-## Faisons le point
-
-Notre deuxième carte est déjà plus intéressante que la première, et nous
-savons la retrouver facilement. Nous avons vu comment créer, *styliser*
-et modifier points et lignes. Nous n’avons pas traité ici des polygones,
-qui représentent des surfaces. Certaines fonctionnalités propres aux
-polygones méritent d’être détaillées, ce que nous ferons dans le
-tutoriel [Le cas des polygones](8-polygons.md).
-
-Pour le moment voyons comment nous pouvons davantage
-[personnaliser notre carte](4-customize-map.md).
-
-??? info "Licence"
-
-    Travail initié par Antoine Riche sur [Carto’Cité](https://wiki.cartocite.fr/doku.php?id=umap:3_-_j_utilise_un_compte_et_cree_une_belle_carte) sous licence [CC-BY-SA 4](https://creativecommons.org/licenses/by-sa/4.0/deed.fr).
+Une fois l’équipe créée, il reste encore à donner les droits de modification
+d’une carte à ses membres. Pour ce faire : ouvrez la carte,
+puis sur cliquez sur « Editer » et cliquez en haut de page
+à droite du titre sur « Visibilité : Définir qui peut voir et modifier la carte ».
 
+![Panneau de permissions pour la sélection des équipes](../../static/tutoriels/my-teams-permissions.png)

docs-users/fr/tutorials/4-customize-map.md

@@ -85,8 +85,8 @@ carte peut vous aider à en choisir un plutôt qu’un autre, par exemple :
 
 !!! note
 
-    Tous les fonds de carte utilisés par umap, à
-    l’exception des images aériennes de l’IGN, sont réalisées à partir des
+    Tous les fonds de carte utilisés par uMap, à
+    l’exception des images aériennes de l’IGN, sont réalisés à partir des
     données OpenStreetMap. Ils sont produits par des associations, des
     entreprises ou des bénévoles qui les mettent gracieusement à
     disposition.
@@ -170,9 +170,11 @@ Dans les deux cas un message vous demande de confirmer l’opération.
 
 ## Faisons le point
 
-Ce tutoriel nous mène à la fin du niveau débutant. Vous savez créer,
-modifier et personnaliser une carte. Vous savez styliser vos marqueurs,
-lignes et polygones. Enfin vous savez gérer votre catalogue de cartes.
+Vous savez créer, modifier et personnaliser une carte.
+Vous savez styliser vos marqueurs, lignes et polygones.
+Enfin vous savez gérer votre catalogue de cartes.
+Vous allez découvrir comment importer des données en « un clic »
+issues de l’open data et gagner du temps par rapport au dessin de toutes les formes.
 
 Une fois ces opérations maîtrisées, les tutoriels de niveau
 intermédiaire vous apprendront à structurer vos cartes avec des calques

docs-users/fr/tutorials/4-draw-items.md

@@ -0,0 +1,158 @@
+!!! abstract "Ce que nous allons apprendre"
+
+    - Changer la forme, la couleur et le pictogramme d’un marqueur
+    - Créer et modifier une ligne
+    - Contrôler l’affichage des étiquettes
+
+Voici comment réaliser une carte contenant de jolis marqueurs et des lignes
+avec pour exemple la carte de nos vacances au
+[Camping de la plage Goulien](https://www.openstreetmap.org/way/119055693)
+sur la Presqu’île de Crozon en Bretagne.
+
+### 1. Créer un joli marqueur
+
+Commençons par créer une carte : donnons-lui un nom, définissons une
+emprise et ajoutons un marqueur à [l’emplacement du
+camping](http://www.openstreetmap.org/?mlat=48.2387&mlon=-4.5434#map=16/48.2387/-4.5434).
+Nous avons vu dans [le tutoriel précédent](2-first-map.md) comment effectuer ces opérations.
+
+![umap_marqueur_props.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_marqueur_props.png)
+
+Ce gros marqueur bleu n’est pas très explicite pour figurer un camping.
+Remédions à cela. Dans le panneau latéral visible lorsqu’un marqueur est
+sélectionné, le menu **Propriétés de la forme** permet de modifier
+l’apparence du marqueur :
+
+-   **Couleur** : cliquer sur `définir` permet de choisir une couleur.
+    Notez que vous pouvez définir une couleur par [son nom
+    CSS](http://www.w3schools.com/cssref/css_colors.asp) ou par son code
+    héxadécimal, que vous pouvez choisir par exemple avec ce [sélecteur
+    de couleurs](http://htmlcolorcodes.com/fr/selecteur-de-couleur/).
+-   **Forme de l’icône** : le choix `Par défaut` correspond au marqueur
+    actuel, les autres choix sont Cercle, Goutte et Épingle.
+-   **Image de l’icône** : cliquer sur `définir` pour choisir parmi une
+    centaine de pictogrammes. Notez que le picto n’est affiché que pour
+    les formes d’icônes `Par défaut` et `Goutte`.
+
+Voici le marqueur obtenu avec les propriétés ci-contre :
+
+![umap_camping.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_camping.png)
+
+#### Modifier un marqueur
+
+![umap_modifier_marqueur.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_modifier_marqueur.png)
+
+Pour modifier un marqueur de la carte, plusieurs possibilités s’offrent à vous :
+
+-   un clic sur le marqueur vous permet soit d’afficher le panneau
+    d’édition (stylo), soit de supprimer le marqueur (corbeille)
+-   **shift-clic** est un raccourci qui affiche directement le panneau
+    d’édition
+-   un glisser-déposer vous permet de déplacer le marqueur sur la carte
+
+### 2. Créer une ligne
+
+Le premier jour de vacances nous allons en kayak de mer jusqu’à la
+Pointe de Dinan à l’ouest de la plage de Goulien. Traçons l’itinéraire
+suivi.
+
+<shot-scraper
+    data-output="static/tutoriels/draw-polyline.png"
+    data-url="https://umap.openstreetmap.fr/fr/map/new/"
+    data-alt="Bouton de dessin d’une ligne."
+    data-width="46"
+    data-height="47"
+    data-selector=".leaflet-toolbar-icon.umap-draw-polyline"
+    data-padding="5"
+    >Bouton de dessin d’une ligne.</shot-scraper>
+
+Le bouton **Dessiner une ligne** permet de tracer, point par point,
+une ligne constiutée de plusieurs segments.
+Cliquez à nouveau sur le dernier point tracé pour
+terminer la ligne : apparaît alors à droite un panneau permettant de
+donner un nom et une description à la ligne, comme pour les marqueurs.
+
+#### Modifier une ligne
+
+A tout moment vous pouvez sélectionner une ligne en double-cliquant
+dessus. Vous pouvez alors éditer ses propriétés dans le panneau latéral,
+ou modifier son tracé sur la carte :
+
+-   **supprimer un point** de la ligne, matérialisé par un carré blanc,
+    en cliquant dessus
+-   **déplacer un point** par un glisser-déposer
+-   **insérer un point** en cliquant sur un carré gris se trouvant au
+    milieu de chaque segment
+-   **allonger la ligne** avec un Ctrl-Clic lorsque le curseur est placé
+    sur le premier ou dernier point
+-   **couper la ligne** en deux : Clic droit sur un point puis choisir
+    l’option `Scinder la ligne`
+
+![umap_ligne.jpg](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_ligne.jpg)
+
+#### Propriétés d’une ligne
+
+![umap_ligne_props.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_ligne_props.png)
+
+Les propriétés d’une
+ligne permettent de définir sa couleur et d’autres paramètres
+définissant son *style* :
+
+-   l’**opacité** va de transparent à gauche à totalement opaque à
+    droite. Plus le trait est épais plus il peut être transparent.
+-   l’**épaisseur** est définie en pixels, sa valeur par défaut est 3 :
+    glisser le curseur vers la droite pour un trait plus épais (qui sera
+    plus facile à sélectionner).
+
+Les **propriétés avancées** permettent de :
+
+-   **simplifier** le tracé permet de réduire le nombre de points pour
+    l’adapter au niveau de zoom. Il est en général inutile de simplifier
+    un tracé réalisé *à la main*.
+-   définir un **traitillé**, par une série de chiffres séparés par des
+    virgules : longueur (en pixels) visible, longueur invisible,
+    longueur visible, etc. L’épaisseur du trait doit être prise en
+    compte : plus les traits sont épais plus les intervalles doivent
+    être grands.
+
+Voici le style de trait obtenu avec les propriétés ci-contre :
+
+![umap_ligne_tirets.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/umap_ligne_tirets.png)
+
+### 3. Ajouter des étiquettes
+
+![etiquettes.png](../../static/tutoriels/3-jutilise-un-compte-et-cree-une-belle-carte/etiquettes.png)
+
+Pour aider l’identification des
+différents éléments de notre carte, nous pouvons leur associer une
+étiquette. L’onglet **Options d’interaction** permet de contrôler
+l’affichage d’une étiquette associée à chaque élément :
+
+-   **Afficher une étiquette** active son affichage, elle est alors
+    placée automatiquement
+-   **Direction de l’étiquette** vous permet de fixer la position, à
+    droite ou à gauche de l’élément, ou encore au-dessus ou en-dessous
+-   **Afficher seulement au survol** de la souris est une option
+    intéressante si la carte est dense : afficher toutes les étiquettes
+    surchagerait la carte
+-   **Étiquette cliquable** permet d’afficher l’infobulle correspondante
+    si l’utilisateur clique sur l’étiquette, et non seulement en cas de
+    clic sur la *géométrie* de l’élément.
+
+
+## Faisons le point
+
+Notre deuxième carte est déjà plus intéressante que la première, et nous
+savons la retrouver facilement. Nous avons vu comment créer, *styliser*
+et modifier points et lignes. Nous n’avons pas traité ici des polygones,
+qui représentent des surfaces. Certaines fonctionnalités propres aux
+polygones méritent d’être détaillées, ce que nous ferons dans le
+tutoriel [Le cas des polygones](8-polygons.md).
+
+Pour le moment voyons comment nous pouvons davantage
+[personnaliser notre carte](4-customize-map.md).
+
+??? info "Licence"
+
+    Travail initié par Antoine Riche sur [Carto’Cité](https://wiki.cartocite.fr/doku.php?id=umap:3_-_j_utilise_un_compte_et_cree_une_belle_carte) sous licence [CC-BY-SA 4](https://creativecommons.org/licenses/by-sa/4.0/deed.fr).
+

docs-users/fr/tutorials/4-find-data.md

@@ -0,0 +1,221 @@
+!!! abstract "Ce que nous allons apprendre"
+
+    - consulter des sources de données
+    - découvrir des exemples de cartes
+    - cloner une carte uMap
+    - cas pratique : utiliser un jeu de données placé sur data.gouv.fr
+
+## L’open data (données ouvertes)
+
+Outre les données produites par ma communauté OpenStreetMap, accessibles sur [GeoDataMine](https://geodatamine.fr/) et dans [l’assistant d’import de données de uMap](6-one-click-data-import.md), les ressources d’open data sont nombreuses et variées. En effet, les collectivités de plus de 3 500 habitants et les services publics doivent placer leurs données en open data conformément à la [Loi pour une République numérique](https://www.vie-publique.fr/eclairage/20301-loi-republique-numerique-7-octobre-2016-loi-lemaire-quels-changements). Le service public de la donnée organise leur publication sur [data.gouv.fr](https://www.data.gouv.fr/fr/) qui est un portail généraliste.
+
+Il existe également des bases plus adaptées à des jeux de données, par exemple les archives, des données géographiques, socio-économiques… Les collectivités mettent parfois aussi directement leurs données à disposition sur leurs portails open data. Des éditeurs de solutions proposent également des bases de données.
+
+
+## 1. Formats de données utilisés par uMap
+
+### geojson
+
+Ce format est utilisé pour des données de type point, ligne, chaîne de caractères, polygone.
+
+Toutes les propriétés sont importées dans uMap.
+
+❓ Usage très large dans uMap.
+
+### gpx
+
+Ce format ouvert permet l’échange de coordonnées géographiques issues de GPS, points de cheminement (*waypoints*), traces (*tracks*) ou itinéraires (*routes*).
+
+Propriétés importées dans uMap : `name`, `desc`. (format pour des itinéraires)
+
+❓ Les fichiers gpx peuvent provenir d’enregistrements personnels, par exemple de traces recueillies randonnées.
+
+### kml
+
+Format propriétaire qui contient des coordonnées géographiques, balisage, styles pour représenter des points, des lignes et des polygones.
+
+Propriétés importées dans uMap : `name`, `description`.
+
+### csv
+
+C’est un format texte ouvert représentant des données tabulaires sous forme de valeurs séparées par des virgules. Pour utiliser un fichier Excel, il faut d’abord le convertir en `.csv`.
+
+Propriétés importées dans uMap : virgule, tabulation ou point virgule pour séparer des valeurs. La projection SRS WGS84 est implicite. Seuls les points géométriques sont importés. L’importation se référera au titre dans les entêtes de colonnes de `lat` et `lon` au début de l’entête, et est insensible à la casse (peu importe les majuscules ou minuscules). Toutes les autres colonnes sont importées en tant que propriétés.
+
+❓ Usage très large dans uMap, aussi bien pour des données en *open data* que pour ses propres données.
+
+### umap
+
+C’est le format d’enregistrement d’une carte, très utilisé par exemple pour cloner une carte sur l’instance OSM et l’importer sur l’instance uMap pour les agents publics. uMap importe toutes les données de la carte, y compris les calques et les propriétés. Il s’agit d’un bon moyen de sauvegarder sa carte uMap.
+
+❓ Voir plus loin, comment cloner une carte uMap.
+
+Ainsi qu’osm et georss.
+
+## 2. S’orienter sur data.gouv.fr
+
+La plateforme [data.gouv.fr](https://www.data.gouv.fr/fr/) propose des données harmonisées, précise la date de mise à jour et permet de contacter l’administrateur qui a déposé le jeu de données. Il suffit d’utiliser l’outil de recherche pour préciser sa demande puis sélectionner le résultat voulu.
+La principale difficulté : savoir quel jeu de données répondrait au besoin. Dans ce cas, il est conseillé de regarder aussi les « thématiques » et les « réutilisations » en bas de page d’accueil.
+
+
+## 3. Gallica ! les archives de la Bibliothèque Nationale de France
+
+La [base Gallica](https://gallica.bnf.fr/accueil/fr/content/accueil-fr?mode=desktop) est particulièrement utile pour afficher dans uMap des images, des cartes postales, des fonds de cartes anciennes. Il n’est pas obligatoire de télécharger l’illustration, certaines cartes se contentent de placer le lien pour qu’elle s’affiche :
+
+### Vues de villes aux XVIe et XVIIe siècles
+
+![Capture d’écran de la carte](../../static/tutoriels/find-data-villes.png)
+
+[Lien vers la carte en ligne](https://umap.openstreetmap.fr/fr/map/vues-de-villes-aux-xvie-et-xviie-siecles_635544#7/46.241/-1.329){ .md-button }
+
+Deux exemples utilisant un plan ancien comme fond, en plus des images anciennes qui s’affichent en cliquant sur un pointeur :
+
+### Photographies de Marseille 1862 à 1866 par A. Terris
+
+
+![Capture d’écran de la carte](../../static/tutoriels/find-data-photos-marseille.png)
+
+[Lien vers la carte en ligne](https://umap.openstreetmap.fr/nl/map/photographies-de-marseille-1862-a-1866-par-a-terri_277962#14/43.2909/5.3815){ .md-button }
+
+### Metz 1872
+
+![Capture d’écran de la carte](../../static/tutoriels/find-data-metz-1872.png)
+
+[Lien vers la carte en ligne](https://umap.incubateur.anct.gouv.fr/fr/map/metz-1872_50#13/49.1201/6.1419){ .md-button }
+
+Dans ces deux derniers cas, le fond de carte doit être « redressé » avant d’être utilisé dans uMap comme [fond personnalisé](https://forum.openstreetmap.fr/t/integrer-un-fonds-de-carte-personnalise-sur-umap/19606).
+
+## 4. Bases de données statistiques
+
+uMap permet de représenter des données quantitatives par le biais de [cercles proportionnels](8-proportional-circles.md) ou de [cartes choroplèthes](10-embed-remote-data.md#produire-une-carte-de-chaleur-ou-heatmap) c’est à dire des plages de couleurs.
+
+L’[INSEE](https://www.insee.fr/fr/accueil) et [Eurostat](https://ec.europa.eu/eurostat/fr/data/database) permettent de télécharger des fichiers statistiques généralistes.
+
+Une fois un fichier enregistré, il faut vérifier le format des données et le modifier au besoin. Attention par exemple aux cellules fusionnées et aux espaces entre les séries de zéro.
+
+## 5. Cloner une carte uMap
+
+Pour utiliser les données d’une carte sur un autre fond, en faire plusieurs versions, il suffit de cloner la carte.
+
+Exemple de besoin : présenter sur un site Internet la même carte plusieurs fois, en diversifiant le centrage et les fonds de cartes. La même carte initiale fournit plusieurs vues provenant de clones.
+
+!!! french-instance "Pour les agents publics"
+
+    Cette fonctionnalité permet également d’importer sur [l’instance uMap agents publics](https://umap.incubateur.anct.gouv.fr/fr/) une carte réalisée sur une autre instance.
+
+    Voici les actions :
+
+    - sauvegardez la carte que vous souhaitez cloner
+    - créez une nouvelle carte - pour cloner la carte sur une nouvelle instance : connectez-vous à la nouvelle instance puis créez cette nouvelle carte et
+    - importez la carte.
+
+    Les deux cartes co-existent, une modification sur une carte n’impacte pas l’autre carte. Si la carte est partagée sur un site Internet, il faut veiller à **mettre à jour le lien** en cas de changement d’instance.
+
+### 1. Sauvegarder la carte
+
+Cliquez à gauche sur « Partager et télécharger »
+
+<shot-scraper
+    data-output="static/tutoriels/control-embed.png"
+    data-url="https://umap.openstreetmap.fr/en/map/new/"
+    data-alt="Icône du partage et de l’intégration."
+    data-selector=".leaflet-control-embed"
+    data-width="48"
+    data-height="48"
+    data-padding="5"
+    >Permet de partager la carte ou d’en exporter les données.</shot-scraper>
+
+puis une fois l’écran latéral affiché :
+
+![Capture d’écran du panneau de téléchargement de la carte](../../static/tutoriels/find-data-download.png)
+
+Cliquez sur « Sauvegarde complète » en bas.
+
+### 2. Créer une carte et importer le fichier
+
+Quitter cet écran, créer une nouvelle carte puis cliquer à droite sur « Importer des données » puis une fois l’écran latéral affiché :
+
+![Capture d’écran du module d’import](../../static/tutoriels/find-data-import-umap.jpg)
+
+
+Le format de l’import reconnaît uMap et le précise.
+
+Cliquez sur « Importer », puis enregistrez.
+
+## 6. Cas pratique : utiliser un jeu de données placé sur data.gouv.fr
+
+Pour un usage dans uMap, les fichiers doivent contenir les coordonnées géographiques des objets. Si le fichier choisi n’en contient pas, voir [ici](12-display-grist-data.md#2-geocoder-des-adresses-pour-les-agents-publics-seulement) comment les ajouter (géocodage).
+
+Voici les actions pour dresser la carte des arbres remarquables à Metz : rechercher les données, les importer dans uMap et les retravailler pour améliorer le placement des étiquettes.
+
+### Rechercher les données
+
+La plateforme ouverte des données publiques françaises recense des milliers de jeux de données. Rechercher « Arbres Metz » dans l’outil de recherche.
+
+Deux solutions pour utiliser ces données :
+
+* récupérer le fichier au format json : il faudra mettre à jour la carte de temps en temps lorsque les données sources sont mises à jour. Bénéfice : une carte à jour à une date précise.
+
+ou
+
+* utiliser le lien vers les données : dans ce cas, la carte se mettra automatiquement à jour (suppression d’arbres coupés par exemple, ajout de nouveaux). Inconvénient : la carte est une carte au temps T, on ne conserve pas l’historique dans ce cas.
+
+![Capture d’écran du site datagouv](../../static/tutoriels/find-data-datagouv.jpg)
+
+Vous avez le choix. Une fois le fichier téléchargé ou le lien copié, cliquer dans la carte sur uMap le bouton "Importer des données" dans la barre de droite puis dans le cadre au choix :
+
+* Parcourir les fichiers téléchargés et choisir le fichier des arbres remarquables au format Geojson
+
+ou
+
+* Coller l’URL stable dansla ligne prévue
+
+![Capture d’écran du panneau d’import (1)](../../static/tutoriels/find-data-import-panel-1.png)
+![Capture d’écran du panneau d’import (2)](../../static/tutoriels/find-data-import-panel-2.png)
+
+Dans « Choisir le format des données » : sélectionner `Geojson`. Dans le cas où vous choisissez l’URL stable, vous pouvez choisir `Associer au calque comme données distantes` et dans ce cas la carte se met automatiquement à jour si le fichier est modifié.
+
+Choisir `Copier dans le calque` pour que la carte reste telle quelle à une date T.
+
+La carte se centre automatiquement sur Metz et tous les arbres remarquables sont placés :
+
+![Capture d’écran de la carte](../../static/tutoriels/find-data-screenshot-trees.png)
+
+Les informations présentes dans le fichier sont répercutées et accessibles dans un tableau ou en cliquant sur chaque arbre.
+
+### Modifier l’apparence des pointeurs pour adapter à la charte d’un site
+
+Sélectionner le calque dans la barre de droite et modifier ses réglages en cliquant sur le petit stylo :
+
+![Capture d’écran du panneau de visualisation](../../static/tutoriels/find-data-visualize-data.png)
+
+Nom : Arbres remarquables (ou par exemple Feuillus ou Arbres de plus de 50 ans…), autant de possibilités que de calques et de couleurs. Puis cliquer sur les propriétés de la forme pour choisir la couleur et la forme du pointeur, mais aussi les options d’interaction : afficher une étiquette au survol par exemple.
+
+![Capture d’écran de la carte et du panneau de personnalisation](../../static/tutoriels/find-data-trees-customisation.png)
+
+### Afficher les noms des arbres au survol
+
+Toutes les données affichables dans l’étiquette sont présentées dans les colonnes du tableau associé au calque. Cliquez sur l’explorateur de données à gauche puis sur le visuel "Éditer dans un tableau" (juste à gauche de la corbeille):
+
+<shot-scraper
+    data-output="static/tutoriels/control-browse.png"
+    data-url="https://umap.openstreetmap.fr/en/map/new/"
+    data-alt="Icône du sélecteur de calque(s)."
+    data-selector=".umap-control-browse"
+    data-width="48"
+    data-height="48"
+    data-padding="5"
+    >Icône du sélecteur de calque(s).</shot-scraper>
+
+Dans le cas du fichier des arbres remarquables de Metz, le nom des arbres est renseigné comme `nom_commun` et `nom_latin`. Or dans uMap, par défaut, les étiquettes qui s’affichent utilisent `name`. Pour que le nom commun s’affiche, il faut remplacer `name` par `nom_commun` à droite dans les « Propriétés avancées » (Panneau d’information de ce calque):
+
+![Capture d’écran de la carte et du panneau de personnalisation](../../static/tutoriels/find-data-trees-customisation-advanced.png)
+
+Pour que l’étiquette s’affiche seulement au survol, choisir `Caché` un peu plus bas dans « Afficher une étiquette ».
+
+!!! note
+
+    - Pour s’entraîner, ouvrir les réglages, la carte peut être clonée ici :
+    https://umap.incubateur.anct.gouv.fr/fr/map/diaporama-des-arbres-remarquables-a-metz_528
+    - Pour cloner une carte, voir l’explication au point 5 plus haut.
+

docs-users/fr/tutorials/5-multimedia-tooltips.md

@@ -12,7 +12,7 @@
     data-url="https://umap.openstreetmap.fr/fr/map/new/"
     data-alt="Panneau d’aide au formatage."
     data-caption="Panneau d’aide au formatage."
-    data-selector=".umap-help-box"
+    data-selector=".umap-dialog"
     data-width="510"
     data-height="326"
     data-padding="5"
@@ -132,18 +132,6 @@ cette photo. Pour cela nous devons :
 #### Afficher vos photos
 
 Si vous disposez d’un serveur vous pouvez l’utiliser stocker vos photos.
-Si ce n’est pas le cas vous pouvez utiliser un service comme
-**[Framapic](https://framapic.org/)**, un service de stockage libre que
-l’association **[Framasoft](https://framasoft.org/)** met à la
-disposition de tous sans contre-partie. L’opération est très simple :
-
-1.  stockez votre photo sur Framapic par un glisser-déposer depuis votre
-    explorateur de fichier vers le navigateur
-2.  copiez le lien d’affichage de la photo
-3.  collez ce lien entre **double accolades** dans la description de
-    l’infobulle : `{{https://framapic.org/xxx/yyy.jpg}}`
-
-![lienframapic.png](../../static/tutoriels/5-je-cree-des-infobulles-multimedia/lienframapic.png)
 
 #### Modifier la taille d’une image
 

docs-users/fr/tutorials/6-one-click-data-import.md

@@ -0,0 +1,99 @@
+!!! abstract "Ce que nous allons apprendre"
+
+    - Importer le contour d’une commune
+    - Importer les contours des départements ou des régions
+    - Importer un point d’intérêt (bibliothèques, parkings, …) qui est enregistré sur OpenStreetMap
+
+## Procédons par étapes
+
+Il est conseillé de vérifier si les données n’existent pas avant de se lancer dans leur dessin. On peut gagner un temps précieux avec l’assistant d’importation intégré dans uMap et conserver une carte qui n’est pas trop lourde au chargement.
+
+Voilà les deux actions à effectuer une fois une carte préexistante, ou une nouvelle carte vierge ouverte :
+
+- Cliquez sur l’outil d’import de données dans la barre de droite puis sélectionnez les données déjà prêtes à l’emploi
+- Cliquez sur « Importer » et le cas échéant enjolivez la carte, car des figurés par défaut sont utilisés
+
+uMap permet d’utiliser des données produites par de nombreux services et placées en open data sous différents formats. Nous verrons ultérieurement (niveau intermédiaire) où rechercher ces sources. D’ores et déjà, vous pouvez utiliser l’assistant d’importation pour récupérer en un clic des contours administratifs et des points d’intérêt.
+
+### Ressources disponibles (20/09/2024)
+
+Au 20 septembre 2024, les imports suivants sont disponibles :
+
+- contour d’une commune
+- contours des départements et des régions
+- données issues d’OpenStreetMap placées dans [GeoDataMine](https://geodatamine.fr/). Comme son nom l’indique, GeoDataMine est une véritable mine de données très utiles pour les services publics :
+    - Aire de jeux
+    - Aménagements cyclables
+    - Banques et DAB
+    - Base Adresse
+    - Bibliothèques
+    - Cimetière
+    - Cinémas
+    - Commerces
+    - Covoiturage
+    - Déchets et recyclage… jusqu’à Toilettes
+- overpass : pour se familiariser avec les types de requêtes à renseigner dans l’assistant, consulter les tutos plus avancés et la [page wiki](https://wiki.openstreetmap.org/wiki/Overpass_turbo/Wizard)
+
+
+!!! note
+    Il manque des données ? N’hésitez pas à contribuer pour les ajouter et vous en serez les premiers bénéficiaires !
+
+
+### Cliquez sur l’outil d’import des données
+
+Voici un bref passage en revu des différents imports proposés et pour finir l’import de la localisation des bibliothèques de Clermont- Ferrand :
+
+![Gif animé montrant l’usage de l’assistant d’import](../../static/tutoriels/importer.gif)
+
+## 1. Importer le contour d’une commune
+
+Cliquez sur l’outil d’importation en bas de la barre de droite, puis cliquez sur le lien « Assistants d’import ».
+
+Cliquez sur « Communes France » et sélectionnez la commune souhaitée dans une liste déroulante. Une fois la commune sélectionnée, le format est reconnu automatiquement (geojson) puis le type de calque (cliquer sur « ? » pour savoir quel choix opérer)
+
+1. Pour que les données soient simplement copiées, choisir « Copier dans le calque ».
+2. Pour que la carte évolue si le contour change, choisir « Associer au calque comme donnée distante ».
+
+!!! note
+    Le code affiché n’est pas le code postal mais le code INSEE de la commune.
+
+Voici le résultat avec la commune d’Arles (la plus vaste de France métropolitaine, un gain certain si on fait l’économie de dessiner son contour !)
+![Une carte avec le dessin de la commune d’Arles importée](../../static/tutoriels/importer-arles.png)
+
+Une fois cet import réalisé, tout est réglable : couleur de contour, de fond, affichage oui non d’une étiquette.
+
+## 2. Importer les contours des départements ou des régions
+
+Cliquez sur l’outil d’importation en bas de la barre de droite, puis cliquez sur le lien « Assistants d’import ».
+
+Cliquez sur « Contours nationaux » puis soit départements, soit régions et enfin le type de calque (voir supra l’explication). Tous les départements sont importés :
+
+![Une carte avec le dessin de chaque département importé](../../static/tutoriels/importer-departements.png)
+
+## 3. Importer un point d’intérêt issu de GeoDataMine
+
+Cliquez sur l’outil d’importation en bas de la barre de droite, puis cliquez sur le lien « Assistants d’import ».
+
+Cliquez sur « GeoDataMine (thèmes OSM) » et sélectionnez les informations souhaitées, routes, bâtiments, commerces, services publics, …
+Par exemple, en sélectionnant les points d’eau potable de la CA du Grand Avignon, puis « Copier dans un calque »
+
+![Une carte avec les points d’eau potable issus d’OpenStreetMap](../../static/tutoriels/importer-geodatamine.png)
+
+Voici une réelle économie de temps plutôt que de placer pointeur après pointeur tous les points d’eau.
+
+## 4. La carte combinée
+
+Bien entendu, on peut tout à fait combiner les différentes couches d’information et présenter par exemple la carte des Points d’eau potable dans la CA du Grand Avignon, avec les contours des communes qui composent l’EPCI, du département et de la région :
+
+### Points d’eau potable du Grand Avignon
+
+![Une carte combinant plusieurs imports](../../static/tutoriels/importer-multi.png)
+
+[Voir la carte en plein écran](https://umap.openstreetmap.fr/fr/map/points-deau-potable-grand-avignon_1116739?scaleControl=false&miniMap=false&scrollWheelZoom=true&zoomControl=true&editMode=disabled&moreControl=true&searchControl=null&tilelayersControl=null&embedControl=null&datalayersControl=true&onLoadPanel=none&captionBar=false&captionMenus=true#11/43.9889/4.7962){ .md-button }
+
+Il faudra dans ce cas supprimer toutes les informations inutiles dans le tableau de données qui est accessible dans la barre de gauche pour chaque calque.
+
+Pour gagner du temps : sélectionner tous les départements et désélectionner seulement le Vaucluse, puis cliquer sur « Supprimer les lignes sélectionnées ».
+
+
+

docs-users/fr/tutorials/8-proportional-circles.md

@@ -0,0 +1,62 @@
+!!! abstract "Ce que nous allons apprendre"
+
+    - Vérifier le formats du fichier
+    - Importer le fichier dans uMap
+    - Régler l’apparences des cercles
+
+## Procédons par étapes
+
+Nous allons importer des données quantitatives et les représenter sous forme de cercles proportionnels. On peut aussi représenter des données distantes par cercles proportionnels (voir les tutoriels plus avancés).
+
+
+### 1. Vérifier le format du fichier
+
+Pour être utilisable dans uMap, le fichier doit être enregistré au format `.csv`, il doit intégrer les cordonnées géographiques. Sans ces deux conditions, le fichier de données n’est pas traité.
+
+Il faut également éviter les mises en forme du type espace entre des blocs de trois zéros, sans quoi les cercles ne seront pas proportionnels, mais tous de même taille.
+
+Si la latitude et la longitude ne sont pas présentes, le fichier doit être géocodé.
+Le site de la Base Adresse Nationale propose un outil très pratique : <https://adresse.data.gouv.fr/csv>
+
+Il suffit de placer un fichier au format `.csv` contenant des adresses et de cliquer sur « géocodage ». L’outil en ligne ajoute les coordonnées géographiques des adresses.
+
+### 2. Importer le fichier dans uMap
+
+Cliquer sur l’outil d’importation en barre de droite :
+
+<shot-scraper
+    data-output="static/tutoriels/upload-data.png"
+    data-url="https://umap.openstreetmap.fr/fr/map/new/"
+    data-alt="Bouton d’import de données."
+    data-width="46"
+    data-height="47"
+    data-selector=".leaflet-toolbar-icon.upload-data"
+    data-padding="5"
+    >Bouton d’import de données.</shot-scraper>
+
+Puis choisir le fichier, par exemple ici la population municipale du Cher, le format est `.csv` et cliquer sur « importer » :
+
+![](../../static/tutoriels/circles-markers.png)
+
+Toutes les communes sont représentées par un pointeur. Il reste juste à préciser que les données de ce calque doivent être affichées par cercles proportionnels. Pour ce faire, cliquer sur l’outil « Gérer les calques » en barre de droite :
+
+<shot-scraper
+    data-output="static/tutoriels/control-browse.png"
+    data-url="https://umap.openstreetmap.fr/en/map/new/"
+    data-alt="Icône du sélecteur de calque(s)."
+    data-selector=".umap-control-browse"
+    data-width="48"
+    data-height="48"
+    data-padding="5"
+    >Icône du sélecteur de calque(s).</shot-scraper>
+
+Puis dans le menu déroulant, sélectionner « Cercles proportionnels » et la donnée de votre tableau que vous voulez représenter en cercles proportionnels :
+
+![](../../static/tutoriels/circles-proportional.jpg)
+
+Il est tout à fait possible de régler la proportionnalité sur les barres de rayon minimum et maximum pour modifier le rendu : l’écart est alors amplifié ou plutôt écrasé.
+
+!!! notes
+
+    Pour modifier les couleurs des cercles, voir le tutoriel
+    [Dessiner sur sa carte](/fr/tutorials/4-draw-items/).

docs-users/fr/videos.md

@@ -1,5 +1,21 @@
 # Vidéos uMap
 
+## Faire la carte de son marché de Noël
+
+<iframe title="Faire la carte de son marché de Noël" width="560" height="315" src="https://tube.numerique.gouv.fr/videos/embed/7d3a95ad-37dc-4af1-ac15-17992cb95869" frameborder="0" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups allow-forms"></iframe>
+
+## Atelier « Afficher des donnees Grist dans uMap »
+
+<iframe title="Atelier Afficher des donnees Grist dans uMap" width="560" height="315" src="https://tube.numerique.gouv.fr/videos/embed/517beed6-ed57-430d-ad76-61e0c4784338" frameborder="0" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups allow-forms"></iframe>
+
+## Transformer un tableau Grist en carte avec uMap
+
+<iframe title="Transformer une table Grist en carte avec uMap" width="560" height="315" src="https://tube.numerique.gouv.fr/videos/embed/9e5b09d5-c660-41a0-8591-cae347c88e65" frameborder="0" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups allow-forms"></iframe>
+
+## uMap incubé par l’État, ça donne quoi ?
+
+<iframe title="uMap incubé par l’État, ça donne quoi ?" width="560" height="315" src="https://peertube.openstreetmap.fr/videos/embed/c564dcfd-4b0b-4796-86ac-ca8624226cd3" frameborder="0" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups allow-forms"></iframe>
+
 ## uMap a 10 ans, bilan et perspectives
 
 <iframe title="uMap a 10 ans, bilan et perspectives" width="560" height="315" src="https://peertube.openstreetmap.fr/videos/embed/f4f122d4-0ff5-4015-bd64-ea507ad5f5b5" frameborder="0" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups"></iframe>

docs-users/index.md

@@ -2,11 +2,11 @@
 
 uMap lets you create maps with OpenStreetMap layers in a minute, and embed them in your site.
 
-- 📺 Check out [videos](videos.md).
+- 🤓 Check out [videos](videos.md) and [articles](articles.md).
 - 🤔 Explore [questions/answers from FAQ](support/faq.md).
 - 🤕 Browse [potential errors and their details](support/errors.md).
 
-!!! info "User docs"
+!!! info "Are you a developer?"
 
     This documentation is intended for users.
 

docs-users/requirements.txt

@@ -1,5 +1,5 @@
 # Force rtfd to use a recent version of mkdocs
-mkdocs==1.6.0
-pymdown-extensions==10.8.1
-mkdocs-material==9.5.23
-mkdocs-static-i18n==1.2.3
+mkdocs==1.6.1
+pymdown-extensions==10.14.3
+mkdocs-material==9.6.12
+mkdocs-static-i18n==1.3.0

docs-users/stylesheets/extra.css

@@ -3,4 +3,30 @@
 }
 .md-typeset a {
   color: #7990be !important;
-}
+}
+
+:root {
+  --md-admonition-icon--french-instance: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M272 0l80 0c8.8 0 16 7.2 16 16l0 64c0 8.8-7.2 16-16 16l-80 0 0 32 192 0c17.7 0 32 14.3 32 32s-14.3 32-32 32L48 192c-17.7 0-32-14.3-32-32s14.3-32 32-32l192 0 0-112c0-8.8 7.2-16 16-16l16 0zM64 224l64 0 0 192 40 0 0-192 64 0 0 192 48 0 0-192 64 0 0 192 40 0 0-192 64 0 0 196.3c.6 .3 1.2 .7 1.8 1.1l48 32c11.7 7.8 17 22.4 12.9 35.9S494.1 512 480 512L32 512c-14.1 0-26.5-9.2-30.6-22.7s1.1-28.1 12.9-35.9l48-32c.6-.4 1.2-.7 1.8-1.1L64 224z"/></svg>');
+  --md-admonition-icon--osm-instance: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M2.672 23.969c-.352-.089-.534-.234-1.471-1.168C.085 21.688.014 21.579.018 20.999c0-.645-.196-.414 3.368-3.986c3.6-3.608 3.415-3.451 4.064-3.449c.302 0 .378.016.62.14l.277.14l1.744-1.744l-.218-.343c-.425-.662-.825-1.629-1.006-2.429a7.66 7.66 0 0 1 1.479-6.44c2.49-3.12 6.959-3.812 10.26-1.588c1.812 1.218 2.99 3.099 3.328 5.314c.07.467.07 1.579 0 2.074a7.55 7.55 0 0 1-2.205 4.402a6.7 6.7 0 0 1-1.943 1.401c-.959.483-1.775.71-2.881.803c-1.573.131-3.32-.305-4.656-1.163l-.343-.218l-1.744 1.744l.14.28c.125.241.14.316.14.617c.003.651.156.467-3.426 4.049c-2.761 2.756-3.186 3.164-3.398 3.261c-.271.125-.69.171-.945.106zM17.485 13.95a6.43 6.43 0 0 0 4.603-3.51c1.391-2.899.455-6.306-2.227-8.108c-.638-.43-1.529-.794-2.367-.962c-.581-.117-1.809-.104-2.414.025a6.6 6.6 0 0 0-2.452 1.064c-.444.315-1.177 1.048-1.487 1.487a6.384 6.384 0 0 0 .38 7.907a6.4 6.4 0 0 0 3.901 2.136c.509.078 1.542.058 2.065-.037zm-3.738 7.376a81 81 0 0 1-2.196-.651c-.025-.028 1.207-4.396 1.257-4.449c.023-.026 4.242 1.152 4.414 1.236c.062.026-.003.288-.525 2.102a399 399 0 0 0-.635 2.236c-.025.087-.069.156-.097.156c-.028-.003-1.028-.287-2.219-.631zm2.912.524c0-.053 1.227-4.333 1.246-4.347c.047-.034 4.324-1.23 4.341-1.211c.019.019-1.199 4.337-1.23 4.36c-.02.019-4.126 1.191-4.259 1.218c-.054.011-.098 0-.098-.019zm-7.105-1.911c.846-.852 1.599-1.627 1.674-1.728c.171-.218.405-.732.472-1.015c.026-.118.053-.352.058-.522l.011-.307l.182-.051c.103-.028.193-.044.202-.034c.023.025-1.207 4.321-1.246 4.36c-.02.016-.677.213-1.464.436l-1.425.405l1.537-1.542zm8.289-3.06a1.4 1.4 0 0 1-.059-.187l-.044-.156l.156-.028c1.339-.227 2.776-.856 3.908-1.713c.16-.125.252-.171.265-.134c.054.165.272.95.265.959c-.034.034-4.48 1.282-4.492 1.261zm-15.083-1.3c-.05-.039-1.179-3.866-1.264-4.29c-.016-.084.146-.044 2.174.536c2.121.604 2.192.629 2.222.74c.028.098.011.129-.125.223c-.084.059-.769.724-1.523 1.479a64 64 0 0 1-1.39 1.367c-.016 0-.056-.025-.093-.054zm.821-4.378c-1.188-.343-2.164-.623-2.167-.626c-.016-.012 1.261-4.433 1.285-4.46c.022-.022 4.422 1.211 4.469 1.252c.009.009-.269 1.017-.618 2.239c-.576 2.02-.643 2.224-.723 2.22c-.05-.003-1.059-.285-2.247-.626zm2.959.538c.012-.031.212-.723.444-1.534l.42-1.476l.056.321c.093.556.265 1.188.464 1.741c.106.296.187.539.181.545c-.008.006-.332.101-.719.212c-.389.109-.741.21-.786.224q-.085.025-.059-.034zM4.905 6.112c-1.187-.339-2.167-.635-2.18-.654c-.04-.062-1.246-4.321-1.23-4.338c.026-.025 4.31 1.204 4.351 1.246c.047.051 1.28 4.379 1.246 4.376L4.91 6.113zm2.148-1.713l-.519-1.806l-.078-.28l1.693-.483c.934-.265 1.724-.495 1.76-.508c.034-.016-.083.14-.26.336A8.7 8.7 0 0 0 7.69 5.23a4 4 0 0 0-.132.561c0 .293-.115-.025-.505-1.39z"/></svg>');
+}
+.md-typeset .admonition.french-instance,
+.md-typeset details.french-instance {
+  border-color: rgb(0, 0, 145);
+}
+.md-typeset .french-instance > .admonition-title::before,
+.md-typeset .french-instance > summary::before {
+  background-color: rgb(0, 0, 145);
+  -webkit-mask-image: var(--md-admonition-icon--french-instance);
+          mask-image: var(--md-admonition-icon--french-instance);
+}
+
+.md-typeset .admonition.osm-instance,
+.md-typeset details.osm-instance {
+  border-color: #77cc6d;
+}
+.md-typeset .osm-instance > .admonition-title::before,
+.md-typeset .osm-instance > summary::before {
+  background-color: #77cc6d;
+  -webkit-mask-image: var(--md-admonition-icon--osm-instance);
+          mask-image: var(--md-admonition-icon--osm-instance);
+}

docs-users/support/advanced.md

@@ -0,0 +1,31 @@
+# uMap advanced usages
+
+## Preloading a map with data {: #preloading-data }
+
+You can preload a map using the `data` or the `dataUrl` parameter:
+
+* The `data` parameter must be URI encoded
+  (using JavaScript’s `encodeURIComponent()` for instance).
+* The `dataURL` parameter must link to an encoded URL
+  (using JavaScript’s `encodeURIComponent()` for instance).
+
+You can add the `dataFormat` parameter given the nature of your data:
+
+* `geojson` (default)
+* `csv`
+* `gpx`
+* `georss`
+* `kml`
+* `osm`
+
+
+This example, using the `data` parameter, will load a map with a marker
+set on Niagara Falls from CSV formatted data:
+
+https://umap.openstreetmap.fr/en/map/?data=name%252Clatitude%252Clongitude%250ANiagara%20Falls%252C43.084799710219066%252C-79.0693759918213&dataFormat=csv
+
+That example, using the `dataUrl` parameter, will load a map with
+borders for Arles, dynamically fetched from
+[geo.api.gouv.fr](https://geo.api.gouv.fr/) in GeoJSON:
+
+https://umap.openstreetmap.fr/en/map/?dataUrl=https%3A%2F%2Fgeo.api.gouv.fr%2Fcommunes%3Fcode%3D13004%26format%3Dgeojson%26geometry%3Dcontour

docs-users/support/faq.md

@@ -1,6 +1,6 @@
 # Frequently Asked Questions (FAQ)
 
-## Which syntax is allowed in description fields?
+## Which syntax is allowed in description fields? {: #text-formatting }
 
 * `*single star for italic*` → *single star for italic*
 * `**double star for bold**` → **double star for bold**
@@ -10,3 +10,109 @@
 * `Simple link: [[http://example.com]]` → Simple link: [http://example.com](http://example.com)
 * `Link with text: [[http://example.com|text of the link]]` → Link with text: [text of the link](http://example.com)
 * `--- for a horizontal rule` ⤵ <hr>
+
+## What are the available keyboard shortcuts? {: #keyboard-shortcuts}
+
+With macOS, replace `Ctrl` by `Cmd`.
+
+### Globals
+
+* `Ctrl+F` → open search panel
+* `Ctrl+E` → switch to edit mode
+* `Escape` → close open panel or dialog
+* `Shift+drag` on the map → zoom to this map extent
+* `Shift+click` on the zoom buttons → zoom in/out by 3 levels
+
+### In edit mode
+
+* `Ctrl+E` → back to preview mode
+* `Ctrl+S` → save map
+* `Ctrl+Z` → undo all changes until last save
+* `Ctrl+M` → add a new marker
+* `Ctrl+P` → start a new polygon
+* `Ctrl+L` → start a new line
+* `Ctrl+I` → open importer panel
+* `Ctrl+O` → open importer panel and file browser
+* `Ctrl++` → zoom in
+* `Ctrl+-` → zoom out
+* `Shift+click` on a feature → edit this feature
+* `Ctrl+Shift+click` on a feature → edit this feature layer
+
+## Which syntax is allowed in conditional rules? {: #conditional-rules }
+
+* `mycolumn=odd` → will match features whose column `mycolumn` equal `odd`
+* `mycolumn!=odd` → will match features whose column `mycolumn` is missing or different from `odd`
+* `mycolumn>12` → will match features whose column `mycolumn` is greater than `12` (as number)
+* `mycolumn<12.34` → will match features whose column `mycolumn` is lower than `12.34` (as number)
+* `mycolumn=` → will match features whose column `mycolumn` has no or null value
+* `mycolumn!=` → will match features whose column `mycolumn` has any defined
+* `mycolumn=true/false` → will match features whose column `mycolumn` is explicitely `true` (or `false`)
+* `mycolumn!=true/false` → will match features whose column `mycolumn` is different from `true` (or `false`)
+
+When the condition match, the associated style will be applied to the corresponding feature.
+
+
+## How to use variables? {: #variables}
+
+In general, using a variable is as simple as `{myvar}`.
+
+It's possible to define another variable as fallback of the first one like this: `{myvar|fallbackvar}`.
+
+To fallback to a string, add it between double quotes: `{myvar|"fallback"}`.
+
+It's possible to combine more variables: `{myvar|othervar|"some string"}`.
+
+It's possible to use a variable inside an URL, for example: `[[https://domain.org/?locale={locale}|Wikipedia]]`.
+
+Or even as source for an image: `{{{myvar}}}` (note the triple `{}`).
+
+### Available variables for features:
+
+Those variables can be used in a feature description, or in popup content templates.
+
+Any property of the feature will be available, plus:
+
+- `{lat}/{lng}` → the feature position (or centroid in case of line or polygon)
+- `{alt}` → the altitude of a marker, if defined in the data
+- `{locale}` → the locale in the form `en` or `en_US` when a variant is used
+- `{lang}` → the lang in the form `en` or `en-us` when a variant is used
+- `{measure}` → the length of a line or the area of a polygon
+- `{gain}`/`{loss}` → the elevation gain/loss of a line (only if it contains the altitude information)
+- `{rank}` → the rank of the feature in the layer
+- `{layer}` → the name of the feature's layer
+- `{zoom}` → the current map zoom
+
+### Available variables in URL for remote data:
+
+- `{bbox}` → the current bbox of the map in the form `southwest_lng,southwest_lat,northeast_lng,northeast_lat`
+- `{north}/{top}` → the North latitude of the current map view
+- `{south}/{bottom}` → the South latitude of the current map view
+- `{east}/{right}` → the East longitude of the current map view
+- `{west}/{left}` → the West longitude of the current map view
+- `{zoom}` → the current map zoom
+- `{lat}` → the latitude of the current map center
+- `{lng}` → the longitude of the current map center
+
+
+## Which statuses can have a map? {: #map-statuses}
+
+### Access statuses
+
+* **Draft (private)**: Only you and your collaborators are able to see the map.
+* **Everybody (public)**: Everybody can see your map, it is listed on search results and potentially the homepage. It is indexed by search engines like Google.
+* **Anyone with link**: The map will be accessible only to people knowing the link. The map is not indexed by search engines.
+* **Editors and team only**: Only you and your collaborators will be able to see the map.
+
+Providing a link of a map to unallowed people will display a `403 Forbidden` error.
+
+### Edit statuses
+
+* **Owner only**: only the owner of the map can edit it.
+* **Editors and team only**: the owner, editors and members of the linked team will be able to edit the map.
+* **Everyone**: Everybody can edit the map without even being logged in.
+
+Only for maps created without an account:
+
+* **Only editable with secret edit link**: Only people with a secret link will be able to edit the map.
+
+These settings are also available for each layer.

docs-users/tutorials/12-display-grist-data.md

@@ -0,0 +1,4 @@
+!!! example "This is an ongoing work."
+
+    [Let us know](https://github.com/umap-project/umap/issues)
+    if you are interested [to translate it from French](/fr/tutorials/12-display-grist-data/).

docs-users/tutorials/4-draw-items.md

@@ -0,0 +1,4 @@
+!!! example "This is an ongoing work."
+
+    [Let us know](https://github.com/umap-project/umap/issues)
+    if you are interested [to translate it from French](/fr/tutorials/4-draw-items/).

docs-users/tutorials/4-find-data.md

@@ -0,0 +1,4 @@
+!!! example "This is an ongoing work."
+
+    [Let us know](https://github.com/umap-project/umap/issues)
+    if you are interested [to translate it from French](/fr/tutorials/4-find-data/).

docs-users/tutorials/6-one-click-data-import.md

@@ -0,0 +1,4 @@
+!!! example "This is an ongoing work."
+
+    [Let us know](https://github.com/umap-project/umap/issues)
+    if you are interested [to translate it from French](/fr/tutorials/6-one-click-data-import/).

docs-users/tutorials/8-proportional-circles.md

@@ -0,0 +1,4 @@
+!!! example "This is an ongoing work."
+
+    [Let us know](https://github.com/umap-project/umap/issues)
+    if you are interested [to translate it from French](/fr/tutorials/8-proportional-circles/).

docs/changelog.md

@@ -1,5 +1,555 @@
 # Changelog
 
+## 3.0.5 - 2025-04-25
+
+* allow to save a remote data with unloaded data by @yohanboniface in #2657
+* allow to save/undo/sync drag'n'drop of datalayers by @yohanboniface in #2677
+* setting center and zoom manually should set dirty status by @yohanboniface in #2676
+* fix error when saving and deleting heatmap layer by @yohanboniface in #2681
+* make rules reordering syncable, savable and undoable by @yohanboniface in #2672
+* loading remote data should not make the map dirty  by @yohanboniface in #2679
+* implement a design system for UI consistency by @davidbgk in #2654
+* pass CSRF_TRUSTED_ORIGINS env to settings by @lippoliv in #2656
+* do not display "saved" message if some request failed by @yohanboniface in #2669
+* show an error message if saving layer failed by @yohanboniface in #2670
+* naive support for GeometryCollection as Feature geometry by @yohanboniface in #2658
+* add a back button in rules form by @yohanboniface in #2673
+
+## New Contributors
+* @lippoliv made their first contribution in #2656
+
+## 3.0.4 - 2025-04-14
+
+* do not show "back to home" button in iframes by @yohanboniface in #2644
+* remove "hide home button" shown twice in map settings by @yohanboniface in #2645
+* adapt Helm chart to match La Suite's expectations by @ohemelaar in #2646
+* update colors by @yohanboniface in #2647
+
+
+## 3.0.3 - 2025-04-11
+
+* do not try to remove a feature not yet added by @yohanboniface in #2637
+* document that nginx needs to be added in Docker stack to serve statics by @yohanboniface in #2636
+* display back help button in switch fields by @yohanboniface in #2634
+* use Last-Modified header from remote data when available by @yohanboniface in #2624
+* fix text overflow on search results by @yohanboniface in #2628
+* redirect to user dashboard after map delete by @yohanboniface in #2626
+* add missing margin-bottom in importers by @yohanboniface in #2627
+* fix pictogram categories always hidden by @yohanboniface in #2630
+* display search category on list page by @davidbgk in #2635
+* allow to hide the layer switcher from bottom bar by @davidbgk in #2639
+* hidden download button in browser when embedControl=false by @yohanboniface in #2640
+* allow to hide the back to home button by @davidbgk in #2638
+
+
+## 3.0.2 - 2025-04-08
+
+* fix copiable input CSS by @yohanboniface in #2616
+* fix categorized layer crashing with null value by @yohanboniface in #2621
+* properly call endEdit for markers by @yohanboniface in #2617
+* fix result tools buttons background color by @yohanboniface in #2620
+* fix min-height of select in caption bar by @yohanboniface in #2622
+* give priority to small usernames on autocomplete by @yohanboniface in #2604
+
+## 3.0.1 - 2025-04-07
+
+* fix showLabel wrongly using MultiChoices by @yohanboniface in #2609
+
+
+## 3.0.0 - 2025-04-07
+
+This is the first release to officially support colaborative real-time map editing.
+It introduces ASGI deployement, to support websockets, and adds Redis in the stack.
+But it's still possible to continue deploying in WSGI for now, and Redis is only
+mandatory when using the real-time feature.
+
+How to use the real-time editing feature in your instance:
+  - you need to deploy with ASGI, see https://docs.umap-project.org/en/stable/deploy/asgi/
+  - you need to set `REALTIME_ENABLED=True` in your settings
+
+Other notable changes:
+  - a first version of a real undo/redo
+  - map categories; those are defined through the `UMAP_TAGS` settings
+
+Note: you may want to update your search index to include the category search,
+see https://docs.umap-project.org/en/stable/config/settings/#umap_search_configuration
+
+
+### Breaking change
+
+* The Docker image will not serve assets and data files anymore, an Nginx container must
+  be configured. See [docker-compose.yml](https://github.com/umap-project/umap/blob/master/docker-compose.yml)
+  for an example.
+
+### New features
+* add collaborative real-time map editing
+* add atomic undo redo by @yohanboniface in #2570
+* expose active sessions in stats endpoint by @yohanboniface in #2544
+* add more users counts in /stats/ by @yohanboniface in #2555
+* add new "Back to home" icon by @yohanboniface in #2551
+* add experimental BAN importer by @yohanboniface in #2565
+* add titles in the text formatting dialog by @yohanboniface in #2584
+* layers selector in bottom bar by @yohanboniface in #2579
+* display maps list as a grid now by @yohanboniface in #2590
+* add Map.tags and allow to edit from client by @yohanboniface in #2530
+* add minimal "raw" icon shape by @yohanboniface in #2597
+
+### Bug fixes
+* cast value to string before calling trim by @yohanboniface in #2567
+* import iconUrl as absolute when possible by @yohanboniface in #2563
+* iconUrl field was broken on older browsers by @yohanboniface in #2575
+* do not fail when trying to read metadata of a missing geojson by @yohanboniface in #2592
+* remote data loading on import from umap backup by @davidbgk in #2598
+* do not export layer ids in umap backup by @davidbgk in #2600
+* use the multichoices for ttl in remote data form by @davidbgk in #2599
+
+### Internal changes
+* refactor search UX by @yohanboniface in #2545
+* new icon, colors and title for search buttons by @yohanboniface in #2556
+* use real redraw for datalayer, instead of hide/show by @yohanboniface in #2568
+* order importers by name instead of id by @yohanboniface in #2578
+* update the Dockerfile to expose websockets by @almet in #2576
+* remove confirm delete for features and datalayers by @yohanboniface in #2603
+
+### Accessibility
+* a11y: turn embeded maps into inert elements by @davidbgk in #2533
+
+### Changed templates
+  - auth/user_detail.html
+  - auth/user_stars.html
+  - umap/content.html
+  - umap/home.html
+  - umap/map_fragment.html
+  - umap/map_list.html
+  - umap/search.html
+  - umap/search_bar.html
+  - umap/team_detail.html
+
+
+## 2.9.3 - 2025-03-07
+
+* be explicit in the message that logout is needed after adding a new oauth provider
+
+
+## 2.9.2 - 2025-03-04
+
+* measure/drawing tooltip was misplaced by @yohanboniface in #2541
+* be defensive when getting the backend name from the session by @yohanboniface in #2540
+
+
+## 2.9.1 - 2025-03-03
+
+* be more persuasive in deprecating twitter login backend by @yohanboniface in #2538
+
+
+## 2.9.0 - 2025-03-03
+
+This release is mainly about making the sync feature deployable and more stable (but still
+not yet activated by default).
+
+### New features
+* display map's "created at" and "modified at" in the caption by @yohanboniface in #2424
+* allow to define sortKey at layer level by @yohanboniface in #2449
+* move star button to caption by @yohanboniface in #2442
+* add a debounce for Input and Textarea fields by @yohanboniface in #2445
+* soft delete datalayers by @yohanboniface in #2459
+* add DEPRECATED_AUTHENTICATION_PROVIDERS setting by @yohanboniface in #2461
+* expose teams in users’ CSV export by @davidbgk in #2484
+* add title attribute to layers in browser by @yohanboniface in #2489
+* make the tooltip sticky in hover mode for paths by @yohanboniface in #2507
+* make vertex icons bigger (and round) by @yohanboniface in #2506
+* add a quick link to layer's permalink by @yohanboniface in #2529
+
+### Bug fixes
+* display a more usefull message when error in remote data by @yohanboniface in #2443
+* fix circle icon no longer hihlighted by @yohanboniface in #2440
+* keep layer visibility after clicking on toggle all by @yohanboniface in #2439
+* update map.modified_at when saving a datalayer by @yohanboniface in #2423
+* do not consume ctrl-Z in textarea or input by @yohanboniface in #2441
+* Fix categorized layers colors palette not updating by @yohanboniface in #2447
+* reference secret-env by fullname instead release-name by @swarnat in #2406
+* correctly parse http link including another http link in the path by @yohanboniface in #2460
+* display current configured oauth as icon instead of text by @yohanboniface in #2375
+* better buttons positionning for the homepage by @davidbgk in #2463
+* catch cluster error at zoom in certain situation by @yohanboniface in #2464
+* display a more descriptive alert on invalid geojson error by @yohanboniface in #2466
+* do not try to backup an undefined geojson by @yohanboniface in #2468
+* do not error when escape during marker creation by @davidbgk in #2483
+* do not import empty features by @yohanboniface in #2485
+* do not display an error for an empty CSV by @yohanboniface in #2505
+* try to reconnect after network error when getting token by @yohanboniface in #2502
+* wait for websocket full connection by @yohanboniface in #2503
+* feature edit status not disabled on hide by @yohanboniface in #2534
+
+### Internal changes
+* deactivate cancel and hide button when sync is active by @yohanboniface in #2413
+* do not try to reconnect after end edit by @yohanboniface in #2412
+* handle sync of datalayer delete by @yohanboniface in #2416
+* internalize FormBuilder by @yohanboniface in #2420
+* POC of using Redis for pubsub by @yohanboniface in #2426
+* include site description within page titles by @davidbgk in #2455
+* Sync show usernames by @yohanboniface in #2444
+* only allow to set a map as sync when it is already saved by @yohanboniface in #2465
+* move DrawToolbar and SettingsToolbar to bar.js module by @yohanboniface in #2482
+* add very minimal documentation for deploying uMap with ASGI by @yohanboniface in #2480
+* use default value from schema for non inheritable fields by @yohanboniface in #2513
+* sync save state by @yohanboniface in #2487
+* use our contexmenu class for inplace toolbar by @yohanboniface in #2510
+* make sure we sync a line when hitting esc while drawing by @yohanboniface in #2526
+* make datalayer upsert idempotent by @yohanboniface in #2528
+
+### Accessibility
+* set an aria-label for unlabelled search input by @davidbgk in #2531
+* switch to better contrasted links by @davidbgk in #2532
+
+### New Contributors
+* @swarnat made their first contribution in #2406
+
+
+## 2.8.2 - 2024-12-26
+
+### Bug fixes
+* fix create marker from search result by @yohanboniface in #2404
+* fix startMarker/Polyline/Polygon on right click by @yohanboniface in #2403
+
+## 2.8.1 - 2024-12-24
+
+### Bug fixes
+
+* honour carriage returns in layer description (in caption panel) by @yohanboniface in #2386
+* update star icon on star/unstar by @yohanboniface in #2387
+* reconnect websocket on disconnection by @almet in #2389
+* fix duplicated content during sync by @yohanboniface in #2388
+* main help button was broken by @yohanboniface in #2393
+* split zoomTo to accept bounds by @davidbgk in #2394
+* zoom to droped file once loaded by @davidbgk in #2401
+* do not load all datalayers at once by @yohanboniface in #2402
+* add a 403.html template by @yohanboniface in #2396
+
+
+## 2.8.0 - 2024-12-18
+
+### What's Changed
+
+This release is mainly about being able to deploy uMap on helm/k8s, with a S3-compatible storage. Doing so,
+we introduce two new map statuses:
+
+  - "draft" (which is now the default, unless you change the UMAP_DEFAULT_SHARE_STATUS setting), which
+    makes the maps private by default
+  - "deleted", which make that now a delete will be a soft delete (and the command `umap empty_trash`
+    could be run to do the real delete).
+
+Also pursuing the code cleaning (more modules and spliting uMap core code from Leaflet rendering one).
+
+Finally, this is now the javascript who create the datalayer uuid, and then push it to the back. This
+is for preparing for the synchronisation between clients.
+
+### Breaking change
+
+* if you use `X-Accel-Redirect` with Nginx, you **must** make sure that the `X-DataLayer-Version` header
+  is forwarded to the client. This is the line you usually need to add in your Nginx `/internal/` config:
+
+        add_header X-DataLayer-Version $upstream_http_x_datalayer_version;
+
+  See the [documentation](deploy/nginx.md) for more informations.
+
+### New features
+* add umap helm chart for Kubernetes deployment by @NaPs in #2286
+* support storing layer data in S3 like servers by @yohanboniface in #2304
+* introduce Map.share_status=DRAFT and DELETED by @yohanboniface in #2357
+* highlight importer URL field when it is fulfilled by @yohanboniface in #2323
+* swap import and settings buttons in edit toolbar by @yohanboniface in #2329
+* make expression persistent in the overpass importer by @yohanboniface in #2339
+* add basic autocompletion on inputs expecting a field name by @yohanboniface in #2281
+* allow to configure the default label keys per instance by @yohanboniface in #2291
+* display an image from Panoramax in OSM template when tag is defined by @yohanboniface in #2338
+* add a disabled/active mode to the submit button of import panel  by @yohanboniface in #2341
+* open importers in a dialog instead of in the form by @yohanboniface in #2327
+* display wikipedia link in OSM popup template when possible by @yohanboniface in #2358
+* move labelKey field on the top datalayer form by @yohanboniface in #2350
+* add elevation gain and loss in extended properties by @yohanboniface in #2343
+* add a back button to importers dialog by @yohanboniface in #2364
+* load all datalayers in parallel by @yohanboniface in #2370
+* parse files in parallel at import when multiple by @yohanboniface in #2372
+* allow to edit datalayer name in datalayers list by @yohanboniface in #2349
+* experimental popup template for wikipedia by @yohanboniface in #2365
+
+### Bug fixes
+* honour custom labelKey in default popup template by @yohanboniface in #2271
+* honour `rules` and `slideshow` when importing a umap file by @yohanboniface in #2270
+* use our fork of csv2geojson to be able to parse lat/lon with commas by @yohanboniface in #2263
+* allow spaces in iframe query strings in HTML formatting by @yohanboniface in #2292
+* do not fail when navigating with popup arrows in cluster mode by @yohanboniface in #2307
+* better login page styles and incentive by @davidbgk in #2293
+* compute length of all shapes for MultiLineString (not only first) by @yohanboniface in #2310
+* avoid map-panning on mobile using two fingers navigation by @fttriquet in #2340
+* do not try to restore a newly created layer on reset by @yohanboniface in #2381
+* do not unset map dirty status if it has not yet been saved once by @yohanboniface in #2382
+* refactor importer feedback by @yohanboniface in #2363
+* make sure we set X-DataLayer-Version even when using X-Accel-Redirect by @yohanboniface in #2361
+* bring marker to front on highlight by @yohanboniface in #2377
+* show private/draft maps in team maps for members by @yohanboniface in #2373
+
+### Internal changes
+* introduce SaveManager class by @yohanboniface in #2240
+* split umap.js in two modules by @yohanboniface in #2257
+* make the client create the DataLayer.id by @yohanboniface in #2259
+* move editToolBar and captionBar to modules by @yohanboniface in #2272
+* update browserslist to be more explicit by @davidbgk in #2277
+* explicitely set postgis as db engine by @yohanboniface in #2285
+* add logo for social_core.backends.keycloak.KeycloakOAuth2 by @tomamplius in #2258
+
+### Changed templates
+* umap/css.html:
+    * added `umap/css/bar.css`
+    * added `umap/css/popup.css`
+* umap/js.html:
+    * added `umap/css/bar.js`
+* umap/templates/registration/login.html
+* umap/templates/umap/map_init.html
+    * changed the way we instanciate `Umap` (instead of `U.Map`)
+* umap/templates/umap/user_dashboard.html
+    * changed the way we instanciate `Umap` (instead of `U.Map`)
+
+### New Contributors
+* @NaPs made their first contribution in #2286
+* @tomamplius made their first contribution in #2258
+* @fttriquet made their first contribution in #2340
+
+
+## 2.7.1 - 2024-10-25
+
+### Bug fixes
+* use shutil.move instead of Path.rename to move to purgatory by @yohanboniface in #2236
+* always unset editedFeature on editPanel close by @yohanboniface in #2237
+
+## 2.7.0 - 2024-10-24
+
+### New features
+* delete datalayer's files on delete by @yohanboniface in #2158
+  - deleted files will be moved to `UMAP_PURGATORY_ROOT`, so set this setting to
+    somewhere meaningful for your instance (default is `/tmp/umappurgatory`)
+* very minimal CSV export of users and maps in admin by @yohanboniface in #2131
+* add a setting to prevent users from editing their profile by @davidbgk in #2133
+* allow to search by code INSEE in communes importer by @yohanboniface in #2188
+* add a profile drop-down menu by @yohanboniface in #2194
+* only add visible markers (and tooltips) to DOM by @yohanboniface in #2204
+* add a global toolbox in browser by @yohanboniface in #2160
+* add importer for French cadastre by @yohanboniface in #2223
+* display the number of connected peers in the interface. by @almet in #2177
+* allow to run umap with asgi by @yohanboniface in #2209
+
+### Bug fixes
+* make sure maps of demo instances of uMap are no indexed by @yohanboniface in #2203
+* fix contextmenu positionning when map is not full screen by @yohanboniface in #2198
+* honour carriage returns in permanent credits by @yohanboniface in #2206
+* do not show browser counter when layer is empty or not loaded by @yohanboniface in #2217
+* fix dispeared icons from panel titles by @yohanboniface in #2222
+* use correct icon for layer download advanced action by @yohanboniface in #2224
+* do not try to create legend for non loaded classified layer by @yohanboniface in #2234
+* icon alignement in browser, and user icon-xxx class by @yohanboniface in #2132
+* editing coordinates manually would not be saved by @yohanboniface in #2147
+* remoteData helpEntries were not on the right format by @yohanboniface in #2183
+* polygon with interactive=false was still interactive by @yohanboniface in #2151
+* allow to draw new proprotional circles and to drag them by @yohanboniface in #2172
+* make sure anonymous is owner at create by @yohanboniface in #2189
+
+### Internal changes
+* deactivate contextmenu and shortcuts in map preview by @yohanboniface in #2199
+* use pytest-rerunfailed by @yohanboniface in #2205
+* simplify contextmenu items by @yohanboniface in #2216
+* Docker: `version` is obsolete. by @Luen in #2220
+* get Github release notes from command line by @yohanboniface in #2130
+* rework permissions panel by @yohanboniface in #2121
+* new tutorial and improvements by @C-Sophie by @davidbgk in #2156 #2167
+* use GeoRSStoGeoJSON as ES module by @yohanboniface in #2168
+* add clean_tilelayer management command by @yohanboniface in #1670
+* send remote operations to peers when they join by @almet in #2082
+* spawn the websocket server in the docker image. by @almet in #2175
+* use our own contextmenu by @yohanboniface in #2109
+* display user maps in admin and add in csv export by @yohanboniface in #2169
+* remove zoom in and out from contextmenu by @yohanboniface in #2195
+
+### Changed templates
+* umap/css.html:
+  - removed `umap/vendors/contextmenu/leaflet.contextmenu.min.css`
+  - added `umap/css/contextmenu.css`
+* umap/js.html:
+  - removed `umap/vendors/contextmenu/leaflet.contextmenu.min.js`
+* umap/templates/umap/map_detail.html:
+  - changed robot directive
+* umap/templates/umap/dashboard_menu.html
+  - use of `UMAP_ALLOW_EDIT_PROFILE`
+
+Thanks @Luen for their first contribution!
+
+## 2.6.3 - 2024-09-11
+
+* delete shape from edit toolbar by @yohanboniface in #2126
+* fix merge lines on vertex click by @yohanboniface in #2128
+* clicking feature in the browser would not open popup in cluster by @yohanboniface in #2129
+
+## 2.6.2 - 2024-09-10
+
+### Bug fixes
+
+* fix German translation breaking home page in /de/
+
+## 2.6.1 - 2024-09-10
+
+### Bug fixes
+
+* fix `teams.all()` called by mistake on anonymous users
+
+## 2.6.0 - 2024-09-10
+
+### New features
+* add teams by @yohanboniface in #2062
+* add "Proportional Circles" layer type by @yohanboniface in #2053
+* better RTL support by @fim100 in #2078
+* display contact infos in the footer by @yohanboniface in #2080
+* add a "+" button in the tilelayer switcher by @yohanboniface in #1994
+* add {layer} as popup variable (aka extended properties) by @yohanboniface in #2008
+* allow to display a polygon "negative" by @yohanboniface in #2041
+* add more context in overpass importer autocomplete results by @yohanboniface in #2087
+* make boundary persistent in overpass importer by @yohanboniface in #2094
+* add a "Copy as GeoJSON" entry in the contextmenu by @yohanboniface in #2108
+* only show visible vertexmarkers and do not show when there are too much  by @yohanboniface in #2107
+* add explicit empty/not empty check in conditional rules by @yohanboniface in #2105
+
+### Bug fixes
+* feature.isOnScreen is now passing the "bounds" argument by @yohanboniface in #2111
+* move bottom controls below panels by @yohanboniface in #2112
+* only show + button in tilelayer switcher when more available by @yohanboniface in #2095
+* make sure to compare comparable values in ternary operators by @yohanboniface in #2098
+* register fa-ir in LANG_INFO by @yohanboniface in #2099
+* make sure datalayersControl=expanded does not override onLoadPanel by @yohanboniface in #2101
+* do not fail when trying to edit a circlemarker by @yohanboniface in #2102
+* do not try to display author name/url for anonymous maps by @yohanboniface in #2104
+* correct Dockerfile statics path by @davidbgk in #2037
+* fix georss import by @yohanboniface in #2035
+* show delete button for owner and anonymous owner by @yohanboniface in #2039
+* deactivate loader on map fragments by @yohanboniface in #2033
+* import GPX desc as description by @yohanboniface in #2059
+* do not append HTML element as title in GeoRSSLink popup by @yohanboniface in #2060
+* catch login_required from map page and add a way to login by @yohanboniface in #2025
+* correctly add drawn latlng when continuing line backward by @yohanboniface in #2077
+* remove position fixed for input and textarea in tableeditor by @yohanboniface in #2076
+
+### Internal changes
+* include vendorized static dependencies by @davidbgk in #2042
+* use preferred tile.openstreetmap.org URL by @Dimitar5555 in #2063
+
+
+Thanks to @fim100 and @Dimitar5555!
+
+## 2.5.1 - 2024-07-12
+
+### Bug fixes
+* fix a bug where collectstatic was not replacing correctly dynamic imports
+
+## 2.5.0 - 2024-07-12
+
+### New features
+* add new type of layer Categorized by @yohanboniface in #1953
+* add AutocompleteDatalist and use it for conditional rules by @yohanboniface in #1981
+* refactor the table editor including mass actions and filters by @yohanboniface in #1968
+
+### Bug fixes
+* add throttle in autocomplete by @yohanboniface in #1964
+* allow to search a French departement in Overpass importer by @yohanboniface in #1963
+* main help button from edit toolbar was broken by @yohanboniface in #1958
+* make sure panels are above controls by @yohanboniface in #1972
+* BlurInput was not updating the object in some situations by @yohanboniface in #1979
+* use correct color for categorized/choropleth layers in browser by @yohanboniface in #1982
+* import unified relations from OSM data (use latest osmtogeojson) by @yohanboniface in #1980
+
+### Internal changes
+* create a WithTemplate base class by @davidbgk in #1969
+* move slideshow to a module by @yohanboniface in #1971
+* move formatters and share to a module, and use new GPX library by @yohanboniface in #1945
+
+## 2.4.2 - 2024-06-26
+
+### New features
+* handle multiple dataUrl parameters on map load by @davidbgk in #1943
+
+### Bug fixes
+* fix ajax proxy broken when using overpass URL that includes spaces
+* Distinction between clearing data vs. layers by @davidbgk in #1938
+* better spacing for the alert box, when activated by @almet in #1935
+* rationalize z-indexes in CSS by @davidbgk in #1942
+* Multiple sync-related fixes by @almet in #1936
+
+### Internal changes
+* setup Biome to replace Prettier by @davidbgk in #1939
+* apply Biome safe changes by @davidbgk in #1940
+* apply Biome unsafe changes by @davidbgk in #1944
+
+## 2.4.1 - 2024-06-24
+
+* fix path disappearing when changing its datalayer by @yohanboniface in #1933
+
+## 2.4.0 - 2024-06-21
+
+### New features
+* importers for custom external sources by @yohanboniface in #1857
+* very minimal experimental conditional style rules by @yohanboniface in #1776
+* display an alert if the import is successful by @davidbgk in #1916
+
+### Bug fixes
+* invert star icons when map is starred or not by @davidbgk in #1852
+* allow audio and video tags (+attributes) in HTML by @davidbgk in #1851
+* panel condensed height should never be bigger than screen by @yohanboniface in #1859
+* caption title rendering on multiple lines by @yohanboniface in #1864
+* refactor new line management in popups by @yohanboniface in #1865
+* show message in case of xml parsing error by @yohanboniface in #1867
+* support old storage options when importing a umap file by @yohanboniface in #1868
+* display layer in naturel order in caption by @yohanboniface in #1875
+* use correct icon class in edit feature panel by @yohanboniface in #1894
+* display an alert on any request error by @yohanboniface in #1895
+* add icon to "edit map details" panel title by @yohanboniface in #1925
+* do not set overlay=null as default by @yohanboniface in #1920
+* use layer labelKey if any when filtering features by @yohanboniface in #1921
+* increase popup min-width by @yohanboniface in #1924
+* give precedence to feature in query string over onLoadPanel by @yohanboniface in #1930
+
+### Internal changes
+* use web components to display alerts + a11y roles by @davidbgk in #1876
+* allow real-time collaboration by @almet in #1754 (code merged in master, but feature not yet active)
+* move ui to dedicated modules by @yohanboniface in #1847
+* move autocomplete to modules/ by @yohanboniface in #1846
+* move importer to modules/ by @yohanboniface in #1856
+* move help to a separate module by @yohanboniface in #1881
+* remove U.Keys, and refactor global shorcuts by @yohanboniface in #1883
+* better browser labels by @yohanboniface in #1809
+* smaller headings in descriptions by @yohanboniface in #1922
+* change heading CSS size by @yohanboniface in #1929
+* remove custom styles for radio inputs by @davidbgk in #1914
+
+### Documentation
+* docs: aggregate articles in English and French by @davidbgk in #1838
+
+## 2.3.1 - 2024-05-17
+
+### Bug fixes
+* display all layers in caption by @yohanboniface in #1821
+* do not autoclose panel blindly after map save by @yohanboniface in #1833
+* do not consider shortcuts if shift is also pressed by @yohanboniface in #1834
+* do not close blindly editPanel when deleting a layer by @yohanboniface in #1832
+* error when clicking on the geolocate button by @yohanboniface in #1823
+* use accent color for switch and multichoices on dark background by @yohanboniface in #1822
+* only set panel mode once, and then keep user choice by @yohanboniface in #1829
+* always display data in browser unless in "layers" mode by @yohanboniface in #1837
+
+### Internal changes
+* chore: replace DomUtil.classIf by classList.toggle by @yohanboniface in #1835
+
+### Documentation
+* Tutorials review and improvements by @davidbgk in #1810
+* Expanded docker.md documentation by @CampaniaGuy in #1802
+
+
 ## 2.3.0 - 2024-05-09
 
 ### New features

docs/config/settings.md

@@ -28,6 +28,14 @@ Can be set through env var too: `ALLOWED_HOSTS=umap.mydomain.org,u.mydomain.org`
 
 Set it to `True` for easier debugging in case of error.
 
+#### DEPRECATED_AUTHENTICATION_BACKENDS
+
+List of auth backends to deprecate. Defining this will display a message to
+all users using this provider, to encourage them to configure another provider to
+their account.
+
+    DEPRECATED_AUTHENTICATION_BACKENDS = ["social_core.backends.twitter_oauth2.TwitterOAuth2"]
+
 #### EMAIL_BACKEND
 
 Must be configured if you want uMap to send emails to anonymous users.
@@ -80,6 +88,19 @@ Nginx configuration.
 
 See [Django documentation for MEDIA_ROOT](https://docs.djangoproject.com/en/4.2/ref/settings/#media-root)
 
+#### REALTIME_ENABLED
+
+Setting `REALTIME_ENABLED` to `True` will allow users to enable real-time collaboration.
+A switch will be available for them in the "advanced properties" of the map.
+
+See [the documentation about ASGI deployment](../deploy/asgi.md) for more information.
+
+#### REDIS_URL
+
+Connection URL to the Redis server. Only need for the real-time editing.
+
+Default: `redis://localhost:6379`
+
 #### SECRET_KEY
 
 Must be defined to something unique and secret.
@@ -89,13 +110,6 @@ Running uMap / Django with a known SECRET_KEY defeats many of Django’s securit
 See [Django documentation for SECRET_KEY](https://docs.djangoproject.com/en/4.2/ref/settings/#secret-key)
 
 
-#### SITE_URL
-
-The final URL of you instance, including the protocol:
-
-`SITE_URL=http://umap.org`
-
-
 #### SHORT_SITE_URL
 
 If you have a short domain for sharing links.
@@ -105,7 +119,26 @@ Eg.: `SHORT_SITE_URL=https://u.umap.org`
 
 #### SITE_NAME
 
-The name of the site, to be used in header and HTML title.
+The name of the site, to be used in header.
+
+
+#### SITE_DESCRIPTION
+
+The description of the site, to be used in HTML title.
+
+
+#### SITE_URL
+
+The final URL of you instance, including the protocol:
+
+`SITE_URL=http://umap.org`
+
+
+#### SOCIAL_AUTH_OPENSTREETMAP_OAUTH2_KEY, SOCIAL_AUTH_OPENSTREETMAP_OAUTH2_SECRET
+
+If you use OpenStreetMap as OAuth 2 provider, you can use those settings.
+
+Otherwise, use any valid [python-social-auth configuration](https://python-social-auth.readthedocs.io/en/latest/configuration/django.html).
 
 
 #### STATIC_ROOT
@@ -115,6 +148,12 @@ Nginx configuration.
 
 See [Django documentation for STATIC_ROOT](https://docs.djangoproject.com/en/4.2/ref/settings/#static-root)
 
+
+#### STORAGES
+
+See [storage](storage.md).
+
+
 #### USE_I18N
 
 Default is True. Set it to False if you don't want uMap to localize the app.
@@ -144,6 +183,12 @@ Should uMap allows user without an account to create maps (default is False).
 
 Can be set through env var: `UMAP_ALLOW_ANONYMOUS=1`
 
+#### UMAP_ALLOW_EDIT_PROFILE
+
+Should uMap allows users to edit their profile (default is True).
+
+Can be unset through env var: `UMAP_ALLOW_EDIT_PROFILE=0`
+
 #### UMAP_CUSTOM_TEMPLATES
 To be used when you want to override some HTML templates:
 
@@ -169,11 +214,6 @@ UMAP_EXTRA_URLS = {
 }
 ```
 
-#### UMAP_KEEP_VERSIONS
-
-How many datalayer versions to keep. 10 by default.
-
-
 #### UMAP_DEFAULT_EDIT_STATUS
 
 Define the map default edit status.
@@ -199,7 +239,7 @@ Possible values:
 Set to True if you want to display a message saying that your instance is not
 ready for production use (no backup, etc.)
 
-#### UMAP_FEEDBACK_LINK
+#### UMAP_HELP_URL
 
 Link to show on the header under the "Feedback and help" label.
 
@@ -211,6 +251,69 @@ Which feed to display on the home page. Three valid values:
 - `"highlighted"`, which shows the maps that have been starred by a staff member
 - `None`, which does not show any map on the home page
 
+#### UMAP_HOST_INFOS
+
+Informations about the entity hosting this uMap instance.
+
+```
+UMAP_HOST_INFOS = {
+    "name": "OpenStreetMap France",
+    "url": "https://openstreetmap.fr",
+    "contact": "blah@openstreetmap.fr"
+}
+```
+
+
+#### UMAP_IMPORTERS
+
+Activate preset importers to connect uMap with external sources.
+
+Must be a dict in the form: `{"importer_name": {"option1": "value"}}`.
+
+Only the key is mandatory to activate an importer (eg. `{"overpass": {}}`).
+
+Example:
+
+```
+UMAP_IMPORTERS = {
+    "geodatamine": {"name": "my custom name"},
+    "overpass": {"url": "https://overpass-api.de/api/interpreter"},
+    "communesfr": {"name": "Communes françaises"},
+    "datasets": {
+        "choices": [
+            {
+                "label": "Régions",
+                "url": "https://domain.org/path/to/file.geojson",
+                "format": "geojson",
+            },
+            {
+                "label": "Départements",
+                "url": "https://domain.org/path/to/other/file.csv",
+                "format": "csv",
+            },
+        ]
+    },
+}
+
+```
+
+Available importers:
+
+- `overpass`: very lite form to build a URL retrieving data from Overpass API.
+- `geodatamine`: allow to interact with [GéoDataMine](https://geodatamine.fr/) API
+- `communesfr`: download French communes boundaries, from https://geo.api.gouv.fr/
+- `datasets`: define URLs you want to promote to users, with a `name` and a `format`
+
+#### UMAP_KEEP_VERSIONS
+
+How many datalayer versions to keep. 10 by default.
+
+#### UMAP_LABEL_KEYS
+
+List of properties to consider as "Feature label" (to show in popup or in browser).
+
+    UMAP_LABEL_KEYS = ["name", "title"]
+
 #### UMAP_MAPS_PER_PAGE
 
 How many maps to show in maps list, like search or home page.
@@ -240,7 +343,10 @@ CREATE EXTENSION btree_gin;
 ALTER TEXT SEARCH CONFIGURATION umapdict ALTER MAPPING FOR hword, hword_part, word WITH unaccent, simple;
 
 # Now create the index
-CREATE INDEX IF NOT EXISTS search_idx ON umap_map USING GIN(to_tsvector('umapdict', COALESCE(name, ''::character varying)::text), share_status);
+CREATE INDEX IF NOT EXISTS search_idx ON umap_map USING GIN(to_tsvector('umapdict', COALESCE(name, ''::character varying)::text), share_status, tags);
+
+# You should also create an index for tag filtering:
+CREATE INDEX IF NOT EXISTS tags_idx ON umap_map USING GIN(share_status, tags);
 ```
 
 Then set:
@@ -262,9 +368,3 @@ Should uMap gzip datalayers geojson.
 Can be set to `X-Accel-Redirect` to enable the [NGINX X-Accel](https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/) feature.
 
 See the NGINX documentation in addition.
-
-#### SOCIAL_AUTH_OPENSTREETMAP_OAUTH2_KEY, SOCIAL_AUTH_OPENSTREETMAP_OAUTH2_SECRET
-
-If you use OpenStreetMap as OAuth 2 provider, you can use those settings.
-
-Otherwise, use any valid [python-social-auth configuration](https://python-social-auth.readthedocs.io/en/latest/configuration/django.html).

docs/config/storage.md

@@ -0,0 +1,81 @@
+# Storage
+
+uMap stores metadata (such as owner, permissions…) in PostgreSQL, and the data itself (the content of a layer)
+in geojson format, by default on the local file system, but optionally in a S3 like server.
+
+This can be configured through the `STORAGES` settings. uMap will use three keys:
+
+- `default`, used only for the pictogram files, it can use whatever storage suits your needs
+- `staticfiles`, used to store the static files, it can use whatever storage suits your needs,
+  but by default uses a custom storage that will add hash to the filenames, to be sure they
+  are not kept in any cache after a release
+- `data`, used to store the layers data. This one should follow the uMap needs, and currently
+  uMap provides only two options: `umap.storage.fs.FSDataStorage` and `umap.storage.s3.S3DataStorage`
+
+## Default settings:
+
+This will use the file system for everything, including the data.
+
+```
+STORAGES = {
+    "default": {
+        "BACKEND": "django.core.files.storage.FileSystemStorage",
+    },
+    "data": {
+        "BACKEND": "umap.storage.fs.FSDataStorage",
+    },
+    "staticfiles": {
+        "BACKEND": "umap.storage.staticfiles.UmapManifestStaticFilesStorage",
+    },
+}
+```
+
+## Using S3
+
+To use an S3 like server for the layers data, the first thing is to install
+the needed dependencies: `pip install umap-project[s3]`.
+
+Then, change the `STORAGES` settings with something like this:
+
+```
+STORAGES = {
+    "default": {
+        "BACKEND": "storages.backends.s3.S3Storage",
+        "OPTIONS": {
+            "access_key": "xxx",
+            "secret_key": "yyy",
+            "bucket_name": "umap-pictograms",
+            "endpoint_url": "http://127.0.0.1:9000",
+            "default_acl": "public-read",
+        },
+    },
+    "data": {
+        # Whatch out, this is a dedicated uMap class!
+        "BACKEND": "umap.storage.s3.S3DataStorage",
+        "OPTIONS": {
+            "access_key": "xxx",
+            "secret_key": "yyy",
+            "bucket_name": "umap-data",
+            "endpoint_url": "http://127.0.0.1:9000",
+        },
+    },
+    "staticfiles": {
+        "BACKEND": "storages.backends.s3.S3Storage",
+        "OPTIONS": {
+            "access_key": "xxx",
+            "secret_key": "yyy",
+            "bucket_name": "umapstatics",
+            "endpoint_url": "http://127.0.0.1:9000",
+            "default_acl": "public-read",
+        },
+    },
+}
+```
+
+As you can see in this example, both `staticfiles` and `default` use the storage class provided
+by `django-storages` (`storages.backends.s3.S3Storage`), but the `data` one uses a specific class
+(`umap.storage.s3.S3DataStorage`).
+
+In order to store old versions of a layer, the versioning should be activated in the bucket.
+
+See more about the configuration on the [django-storages documentation](https://django-storages.readthedocs.io/en/latest/backends/amazon-S3.html).

docs/contributing.md

@@ -33,7 +33,7 @@ make develop
 
 For JavaScript, here is the tooling we use:
 
-- Format your code with [Prettier](https://prettier.io/)
+- Format your code with [Biome](https://biomejs.dev/)
 - Be sure to configure your editor to insert new lines at the end of files.
 
 ### Hack!

docs/deploy/asgi.md

@@ -0,0 +1,92 @@
+# ASGI
+
+While uMap has been historically deployed using the WSGI specification,
+there is now an **experimental** ASGI endpoint. This will be the way to
+deploy uMap to use the live collaborative editing feature, which needs
+websockets.
+
+## Nginx
+
+When using ASGI, the [nginx](nginx.md), the `/` entrypoint should be:
+
+```
+location / {
+    proxy_set_header Host $http_host;
+    proxy_set_header X-Forwarded-For $remote_addr;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection $connection_upgrade;
+    proxy_redirect off;
+    proxy_buffering off;
+    proxy_pass http://umap/;
+}
+```
+
+Also add this mapping for the `$connection_upgrade` variable:
+
+```
+map $http_upgrade $connection_upgrade {
+    default upgrade;
+    ''      close;
+}
+```
+
+## Uvicorn
+
+Uvicorn must be installed in the umap virtualenv:
+
+    /path/to/umap/venv/bin/pip install uvicorn
+
+And could then be run like this:
+
+    /path/to/umap/venv/bin/uvicorn \
+    --proxy-headers \
+    --uds /srv/umap/umap.sock \
+    --no-access-log \
+    umap.asgi:application
+
+## Systemd
+
+Here is an example service to manage uvicorn with systemd:
+
+```
+[Unit]
+Description=umap
+After=network.target
+Requires=postgresql.service
+
+[Service]
+Type=simple
+User=umap
+
+WorkingDirectory=/srv/umap/
+PrivateTmp=true
+
+EnvironmentFile=/srv/umap/env
+
+ExecStart=/srv/umap/venv/bin/uvicorn \
+    --proxy-headers \
+    --uds /srv/umap/uvicorn.sock \
+    --no-access-log \
+    umap.asgi:application
+ExecReload=/bin/kill -HUP ${MAINPID}
+RestartSec=1
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Then to install it and enable it, copy it to `/etc/systemd/system/umap.service`
+and run:
+
+    sudo systemctl enable umap.service
+
+## Env
+
+Uvicorn can be [configured](https://www.uvicorn.org/deployment/) from env vars,
+for example to define the number of workers:
+
+```env title="/srv/umap/env"
+UVICORN_WORKERS=4
+```

docs/deploy/docker.md

@@ -3,7 +3,6 @@
 An official uMap docker image is [available on the docker hub](https://hub.docker.com/r/umap/umap). But, if you prefer to run it with docker compose, here is the configuration file:
 
 ```yaml title="docker-compose.yml"
-version: '3'
 services:
   db:
     # check https://hub.docker.com/r/postgis/postgis to see available versions
@@ -15,7 +14,7 @@ services:
 
   app:
     # Check https://hub.docker.com/r/umap/umap/tags to find the latest version
-    image: umap/umap:2.0.2
+    image: umap/umap:2.9.3
     ports:
       # modify the external port (8001, on the left) if desired, but make sure it matches SITE_URL, below
       - "8001:8000"
@@ -49,3 +48,45 @@ User accounts can be managed via the Django admin page ({SITE_URL}/admin). The r
 ```bash
 umap createsuperuser
 ```
+
+## Developping with Docker
+
+If you want to develop with podman or docker, here are commands that might be useful, given that you have a postgreSQL server running locally and that your settings are located at `umap.conf`:
+
+You can build the docker image with:
+
+```bash
+podman build -t umap .
+```
+
+And run it with:
+
+```bash
+podman run -v ./umap.conf:/tmp/umap.conf -e UMAP_SETTINGS=/tmp/umap.conf -it --network host umap  
+```
+
+## Real time collaboration
+
+To enable real time collaboration when using Docker, a Redis service must be added. Something like this in `docker-compose.py` world:
+
+```yaml title="docker-compose.yml"
+services
+  redis:
+    image: redis:latest
+    healthcheck:
+      test: ["CMD-SHELL", "redis-cli ping | grep PONG"]
+…
+    command: ["redis-server"]
+…
+  app:
+    depends_on:
+…
+      redis:
+        condition: service_healthy
+…
+    environment:
+      - REALTIME_ENABLED=1
+      - REDIS_URL=redis://redis:6379
+…
+
+```

docs/deploy/helm.md

@@ -0,0 +1,7 @@
+# Helm
+
+To deploy using helm:
+
+    helm install <my-release> oci://registry-1.docker.io/umap/umap
+
+Helm chart is pushed here: https://hub.docker.com/repository/docker/umap/umap/tags

docs/deploy/nginx.md

@@ -1,84 +1,10 @@
 # Configuring Nginx
 
-Here are some configuration files to use umap with nginx and [uWSGI](https://uwsgi-docs.readthedocs.io/en/latest/), a server for python, which will handle your processes for you.
+See [WSGI](wsgi.md) or [ASGI](asgi.md) for a basic setup.
 
-```nginx title="nginx.conf"
-upstream umap {
-    server unix:///srv/umap/uwsgi.sock;
-}
+Then consider adding this configuration
 
-server {
-    # the port your site will be served on
-    listen      80;
-    listen   [::]:80;
-    listen      443 ssl;
-    listen   [::]:443 ssl;
-    # the domain name it will serve for
-    server_name your-domain.org;
-    charset     utf-8;
-
-    # max upload size
-    client_max_body_size 5M;   # adjust to taste
-
-    # Finally, send all non-media requests to the Django server.
-    location / {
-        uwsgi_pass  umap;
-        include /srv/umap/uwsgi_params;
-    }
-}
-```
-
-## uWSGI
-
-
-```nginx title="uwsgi_params"
-uwsgi_param  QUERY_STRING       $query_string;
-uwsgi_param  REQUEST_METHOD     $request_method;
-uwsgi_param  CONTENT_TYPE       $content_type;
-uwsgi_param  CONTENT_LENGTH     $content_length;
-
-uwsgi_param  REQUEST_URI        $request_uri;
-uwsgi_param  PATH_INFO          $document_uri;
-uwsgi_param  DOCUMENT_ROOT      $document_root;
-uwsgi_param  SERVER_PROTOCOL    $server_protocol;
-uwsgi_param  REQUEST_SCHEME     $scheme;
-uwsgi_param  HTTPS              $https if_not_empty;
-
-uwsgi_param  REMOTE_ADDR        $remote_addr;
-uwsgi_param  REMOTE_PORT        $remote_port;
-uwsgi_param  SERVER_PORT        $server_port;
-uwsgi_param  SERVER_NAME        $server_name;
-```
-
-
-```ini title="uwsgi.ini"
-[uwsgi]
-uid = umap
-gid = users
-# Python related settings
-# the base directory (full path)
-chdir = /srv/umap/
-# umap's wsgi module
-module = umap.wsgi
-# the virtualenv (full path)
-home = /srv/umap/venv
-
-# process-related settings
-# master
-master = true
-# maximum number of worker processes
-processes = 4
-# the socket (use the full path to be safe)
-socket = /srv/umap/uwsgi.sock
-# ... with appropriate permissions - may be needed
-chmod-socket = 666
-stats = /srv/umap/stats.sock
-# clear environment on exit
-vacuum = true
-plugins = python3
-```
-
-## Static files
+## Static files and geojson
 
 ```nginx title="nginx.conf"
 location /static {
@@ -116,6 +42,53 @@ UMAP_XSENDFILE_HEADER = 'X-Accel-Redirect'
         internal;
         gzip_vary on;
         gzip_static on;
+        # Next line is very important!
+        add_header X-DataLayer-Version $upstream_http_x_datalayer_version;
         alias /path/to/umap/var/data/;
     }
 ```
+
+## Ajax proxy
+
+In order for users to load CORS protected data within a map, Nginx can act as a proxy.
+Here is an example configuration for this:
+
+```
+
+location ~ ^/proxy/(.*) {
+    internal;
+    add_header X-Proxy-Cache $upstream_cache_status always;
+    proxy_cache_background_update on;
+    proxy_cache_use_stale updating;
+    proxy_cache ajax_proxy;
+    proxy_cache_valid 1m;  # Default. Umap will override using X-Accel-Expires
+    set $target_url $1;
+    # URL is encoded, so we need a few hack to clean it back.
+    if ( $target_url ~ (.+)%3A%2F%2F(.+) ){ # fix :// between scheme and destination
+      set $target_url $1://$2;
+    }
+    if ( $target_url ~ (.+?)%3A(.*) ){ # fix : between destination and port
+      set $target_url $1:$2;
+    }
+    if ( $target_url ~ (.+?)%2F(.*) ){ # fix / after port, the rest will be decoded by proxy_pass
+      set $target_url $1/$2;
+    }
+    resolver 8.8.8.8;
+    add_header X-Proxy-Target $target_url; # For debugging
+    proxy_pass_request_headers off;
+    proxy_set_header Content-Type $http_content_type;
+    proxy_set_header Content-Encoding $http_content_encoding;
+    proxy_set_header Content-Length $http_content_length;
+    proxy_read_timeout 10s;
+    proxy_connect_timeout 5s;
+    proxy_ssl_server_name on;
+    proxy_pass $target_url;
+    proxy_intercept_errors on;
+    error_page 301 302 307 = @handle_proxy_redirect;
+}
+location @handle_proxy_redirect {
+    resolver 8.8.8.8;
+    set $saved_redirect_location '$upstream_http_location';
+    proxy_pass $saved_redirect_location;
+}
+```

docs/deploy/overview.md

@@ -0,0 +1,37 @@
+# Deploying uMap
+
+uMap is a python package, running [Django](https://docs.djangoproject.com/en/5.2/howto/deployment/),
+so anyone experimented with this stack will find it familiar, but there are some speficic details
+to know about.
+
+## Data
+One important design point of uMap is that while metadata are stored in a PostgreSQL database, the
+data itself is stored in the file system, as geojson files. This design choice has been made
+to make uMap scale better, as there are much more reads than writes, and when some
+map is shared a lot (like on a national media) we want to be able to serve it without needing an
+overcomplex and costly stack.
+
+So when a request for data is made (that is on a *DataLayer*), the flow is that uMap will read
+the request headers to check for permissions, and then it will forward the request to Nginx,
+that will properly serve the data (a geojson file), without consuming a python worker, and with
+much more efficiency than python.
+
+In DEBUG mode, uMap will serve the geojson itself, but this is not recommended in production,
+unless you have a very small audience.
+
+Data can also be stored in a [S3 like storage](../config/storage/#using-s3).
+
+## Assets (JS, CSS…)
+As any web app, uMap also needs static files to be served. In DEBUG mode, Django will do this
+kindly, but not in production. See [Nginx configuration](nginx.md) for this.
+
+Assets can also be stored in a [S3 like storage](../config/storage/#using-s3).
+
+## python app (metadata, permissions…)
+
+uMap needs a python server, which can either be of [WSGI](wsgi.md) or [ASGI](asgi.md) (this later
+is needed in order to use the collaborative live editing).
+
+## Redis
+
+Still when using the collaborative live editing, uMap needs a [Redis](../config/settings.md#redis_url) server, to act as pubsub.