We've created a POC Lua template to generate the grid. Could also do something similar for the wikitext table. The icon list should come from a json configuration page.

Module: https://www.mediawiki.org/wiki/Module:Sandbox/Adamw/Maki_icon_grid
Example usage: https://www.mediawiki.org/wiki/User:Adamw/Sandbox/Maki_grid_template

Once the test page and Lua module have been code-reviewed, we should put this task in Stalled and block on T302861 deployment to the beta cluster.

I would change the name of the template from Maki icon grid to Maki icon overview and the function name grid to map because the function creates a map that contains all the icons. The form could in theory also be something else than a grid.

current: {{#invoke:Maki icon grid|grid}}
my suggestion: {{#invoke:Maki icon overview|map}}

Would that work for you @awight?

I am also reconsidering your idea to use the maki version number as a parameter. It would make the switch easier. But is there a use case where we would need the old overview also after the update? 🤔

I changed the maki icon version to 7 to see if the commons files are fine. Since there are a few icon names in the list that do not have a representative at commons it looks like we mixed something up. I guess we should make sure we have the same icons at commons that we included in the code and then update the list in the lua script accordingly. 🤓

it looks like we mixed something up.

We did. See T315228#8198306 for details.

@ECohen_WMDE Can you suggest a nicer marker background color, or should we stick with the neutral default?

Also, we could use the "large" icons and put more space between grid points.

@ECohen_WMDE Can you suggest a nicer marker background color, or should we stick with the neutral default?

Good idea! Can you make them all Base20 or #54595d. Then they will still be neutral but will be easier to see. Thanks!

If it's not much effort, then large with more space would be nicer. Otherwise, it's alright to leave as is.

@ECohen_WMDE I changed the color and the size of the markers.

https://de.wikipedia.beta.wmflabs.org/wiki/Hilfe:Extension:Kartographer/Icons

Nice! I think the color is looking good.

Is it possible to also space out the markers more? I think the larger size is nicer to look at the icons, but without the additional spacing it's a bit cramped. Would either add the space if possible, or otherwise go back to medium size.

In T312752#8206051, @ECohen_WMDE wrote:

Is it possible to also space out the markers more? I think the larger size is nicer to look at the icons, but without the additional spacing it's a bit cramped. Would either add the space if possible, or otherwise go back to medium size.

I've added some spacing and played around with width, height, and column count until it looks reasonable on my display.

I have a naive understanding of on-wiki topics, but I'd still recommend that we don't encourage subst—editors are capable of finding this themselves, and our template by no means requires this usage (the ones that are used with subst usually do *require* being used this way, for example because they add timestamps). I have some new thoughts about how to easily provide documentation, which I'll add to the Lua module.

An update about i18n: the listing table now accepts optional arguments which can be used to document icons. For example, a simple usage

{{Maki icon list}}

can include documentation by adding parameters like this:

{{Maki icon list
 | animal-shelter = Domestic animal medical and adoption center.
}}

Also, our table columns are not translatable. I realized that we should be including these as messages in the Kartographer extension.

Change 829750 had a related patch set uploaded (by Awight; author: Awight):

[mediawiki/extensions/Kartographer@master] Include messages used in Maki icon documentation

https://gerrit.wikimedia.org/r/829750

I've included some built-in documentation explaining how to use the Lua module, including how to add descriptions for icons if desired:
https://de.wikipedia.beta.wmflabs.org/wiki/Modul:Maki_icon_overview

Change 829750 merged by jenkins-bot:

[mediawiki/extensions/Kartographer@master] Include messages used in Maki icon documentation

https://gerrit.wikimedia.org/r/829750

Change 830881 had a related patch set uploaded (by Awight; author: Awight):

[mediawiki/extensions/Kartographer@master] Drop an unused message

https://gerrit.wikimedia.org/r/830881

Change 830881 merged by jenkins-bot:

[mediawiki/extensions/Kartographer@master] Drop an unused message

https://gerrit.wikimedia.org/r/830881

Follow up: T317622: 429 Too Many Requests when first expanding icon help map

In T312752#8231612, @WMDE-Fisch wrote:

Review summary:
Test page looks good. Can be used in production when we deploy. One follow up issue with the icons not loading initially will be dealt with in a separate ticket.

@WMDE-Fisch Should we reopen this task as long as https://www.mediawiki.org/wiki/Help:Extension:Kartographer/Icons has not been updated?

That update should be scheduled for Monday, Sept 19, in the morning.