commons-diener

commons-diener

commons-diener is tool to prepare photos which shall be uploaded to Wikimedia Commons. It will create an XML export which can be used with VicuñaUploader.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

MakeFile

Run build make command with tests

make all

Build the application

make build

Run the application

make run

Create DB container

make docker-run

Shutdown DB Container

make docker-down

DB Integrations Test:

make itest

Live reload the application:

make watch

Run the test suite:

make test

Clean up binary from the last build:

make clean

Update all used dependencies

make update-deps

Example .env

PORT=8080
APP_ENV=local
BLUEPRINT_DB_URL=./db/test.db
SERVE_DIR=/

If you want to serve this application via a subdirectory and not at the root / of your domain, change the SERVE_DIR variable to match the subpath without a suffix slash.

Basis

Based on

• go-blueprint with the command: go-blueprint create --name commons-diener --framework gin --driver sqlite --advanced --feature htmx --feature githubaction --feature tailwind --feature docker --git stage
• htmx
• templ
• daisyui
• Location target icon

Assumptions

• a collection contains only photos from one day
• the description of the image is used as title or vice versa
• title gets suffixed with the ISO date YYYY-MM-DD
• no special chars are allowed in the title except: .-,
• show if there are no geocoordinates at all