Erweiterung:Highlight Links in Category
Highlight Links in Category Freigabestatus: stabil |
|
---|---|
Einbindung | Benutzer-Schnittstelle, MeinWiki |
Beschreibung | Adds a CSS class to links pointing to members of a category |
Autor(en) | Brent Laabs (BrentLaabsDiskussion) |
Letzte Version | 0.9.0 (2021-05-29) |
MediaWiki | 1.25+ |
Datenbankänderungen | Nein |
Lizenz | MIT-Lizenz |
Herunterladen | GitHub: Hinweis: readme repository |
Beispiel | https://allthetropes.org/ |
$wgHighlightLinksInCategory |
|
Highlight Links in Category is an extension that adds a CSS class to links pointing to members of a category.
For reporting an issue or a bug, please use Miraheze Phabricator.
Installation
- Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens
HighlightLinksInCategory
im Ordnerextensions/
ablegen.
Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HighlightLinksInCategory - Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
wfLoadExtension( 'HighlightLinksInCategory' );
- Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
Konfigurationsparameter
- $wgHighlightLinksInCategory
- This global is an array that configures which categories get an added CSS class. The keys are the Category names, which must include underscores instead of spaces. Do not include the Category: namespace. The value for each key is the CSS class you would like to add to that category. For example:
$wgHighlightLinksInCategory = array(
"Disambiguation_pages" => 'disambig',
"Templates" => 'templates',
);
If you want add more than one class, separate the class names with spaces, like
$wgHighlightLinksInCategory = array( "My_Cat" => "class1 class2 class3" );
You can add as many of these as you want, but from a UX perspective it's probably not awesome to add 500 different style links.
If $wgHighlightLinksInCategory is not set or empty, this extension will do nothing.
If you're running a wiki farm and need to turn it off on some wikis, set $wgHighlightLinksInCategory = null
; using false
could lead to incorrect behavior.
Styling
Simply add the styles you need for these links to MediaWiki:Common.css on your wiki. For example:
a.disambig {
color: rebeccapurple
}
a.templates {
font-weight: bold;
background-color: #efe;
}
If you want one category to override another, you'll have to specify it with CSS.
a.templates.disambig {
font-weight: normal;
background-color: transparent;
color: rebeccapurple;
}
Or alternatively, you could have defined the original a.templates
rule as a.templates:not(.disambig)
instead.
There's also the link icon approach:
a.superlink {
background-image: url(super.png);
padding-left: 16px;
}
User Toggles
An easy way to set up toggling this highlighting on or off is to make a Gadget with CSS in it. Yes, this is a personalization extension that outsources the personalization part to other extensions; I can still sleep at night.
How this works
Right after MediaWiki determines which linked pages exist (to make redlinks), it runs the GetLinkColours
hook (see LinkHolderArray.php).
As we have a list of all of the page ids which are linked on that page, we can run one database query to see which of these links are in the set of categories we want to highlight.
Because the query only happens on an index of the categorylinks
table, it's reasonably fast.
Then CSS classes are assigned based on the result, using the configuration values the user sets in $wgHighlightLinksInCategory
.
Explaining how CSS works is outside the scope of this document.
Bekannte Probleme
- CSS styles are not added in Flow, because it doesn't appear to call the GetLinkColors hook there.
Siehe auch
- Category:LinkEnd extensions - which customize links in other ways
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |
Diese Erweiterung wird von Miraheze gepflegt. Einige Miraheze-Erweiterungen sind sehr Miraheze-spezifisch und du könntest auf Probleme stoßen, die du bei Miraheze nicht siehst. Wenn du einen Fehler melden oder eine Konfigurationsänderung beantragen möchtest, tue dies bitte auf dem Miraheze Issue Tracker und nicht auf Wikimedia Phabricator. |
- Stable extensions/de
- User interface extensions/de
- Personalization extensions/de
- MIT licensed extensions/de
- Extensions in GitHub version control/de
- GetLinkColours extensions/de
- All extensions/de
- Extensions included in Miraheze/de
- Extensions included in WikiForge/de
- Extensions by Miraheze/de
- Simple extensions/de
- Category extensions/de