Add a mapping
A mapping says that a category here means the same as, or something close to, a category in another vocabulary, for example Wikidata. Mappings are optional and can be added at any time.
They sit right in the category's block in the list file, for example categories/topics.toml, so everything about a category is in one place:
[music]
exactMatch = ["http://www.wikidata.org/entity/Q638"] # Wikidata: music
[science-tech]
broader = ["http://www.wikidata.org/entity/Q336"] # Wikidata: science
There are three types of link:
| Link | Use it when... |
|---|---|
exactMatch |
the other category means exactly the same |
closeMatch |
the other category is similar, but not identical |
broader |
the other category is more general |
These are the links FEP-2fa1 defines. Other types (narrower, related) are not accepted as they are not yet considered to be of importance to the Fediverse.
Be conservative: use exactMatch only when the meanings really are the same.
When in doubt, use closeMatch.
Finding a Wikidata address
- Search for the concept on wikidata.org.
- Open the item (for example music,
Q638). - Use the address
http://www.wikidata.org/entity/followed by the number.
Links to another application's category work the same way: put that category's full web address in the list.
Every address must start with https:// or http://; python3 build.py --check tells you if something is wrong.
Multiple mappings
A category can have several links of the same type:
[music]
exactMatch = [
"http://www.wikidata.org/entity/Q638",
"https://other-application.example/vocab/music",
]