Needs some documentation

[SomeoneElseOSM]

https://github.com/geofabrik/shortbread-mapnik/blob/master/README.md is very lacking as it currently stands.

"Convert the .mbtiles file returned by Tilemaker into plain z/x/y.pbf structure using mbutil." implies that I should somehow install mbutil and run it with some parameters. In fact "mbutil" needs editing to run at all since it doesn't seem to know about python3. One of those parameters will be the .mbtiles file I created in the previous step, but the other it ought to be able to define as "Build map styles for zoom levels 0 to 14" uses that as input.

"Add geometry types to the metadata.json file of the vector tile tileset using the add_geometry_types.py script." does not specify what parameters that command needs.

Re "Build map styles for zoom levels 0 to 14", I'd expect most people in 2024 would just "sudo apt install node-carto" on Debian or Ubuntu, which will install carto into "/usr/bin/carto", somewhere that the make does not detect.

Once 15 "shortbread_mapnik_z(something).xml" files have been created, then what? With a "normal" raster tile setup, apache is told about mod_tile, which calls renderd which uses mapnik to create a raster tile which is returned to the user.

Here I'd expect that (some web server) is somehow configured to respond to user requests and somehow invoke mapnik with the appropriate shortbread_mapnik_z(something).xml config, in order to obtain something to return to the user. This seems to be missing entirely?