Template:Category handler/blacklist

From Linguifex
Jump to: navigation, search

noinclude>Actual code of this blacklist:

</noinclude>{{if pagename
<!-- Start of blacklist -->

| Main Page = hide   <!-- Don't categorise the main page -->

<!-- Don't categorise on centralised cascade page or its subpages -->
| Wikipedia:Cascade-protected items/+ = hide

<!-- Don't categorise userboxes in their own "template space" -->
| User:UBX/+ = hide 
| User talk:UBX/+ = hide 

| Wikipedia:Template messages/* = hide   <!-- Don't categorise on its subpages -->

| /archiv* = hide   <!-- Don't categorise on /archive pages -->

<!-- End of blacklist -->
| page = {{{page|}}}   <!-- Never change this one, see the doc -->
}}<noinclude>
Documentation icon Template documentation[view] [edit] [history] [purge]

This is the {{category handler/blacklist}}

sub-template.

Do not use this template directly, use {{category handler}}

instead. This template is called from {{category handler}}

, see user documentation there.

But if you came here to see or update the category suppression blacklist, then you are in the right place. P

Updating the blacklist

This template contains a blacklist of the pages and page types where templates should not auto-categorise. This blacklist is used by {{category handler}} to decide when not to categorise. To update the blacklist, edit this template.

This template uses {{if pagename}}

to do the pagename-detection, thus see {{if pagename}}
for the syntax to use for the blacklist rules.

When this template is placed on a page that should not categorise, then it should return . And when placed on any other page it should return an empty string.

Testing the blacklist

There are two ways you can test what this blacklist returns for a page:

You can put this template on the page you want to test, and see what output it produces. You can use edit preview, no need to save. Like this:

+{{category handler/blacklist}}+

Which here on this page returns this:

+noinclude>Actual code of this blacklist:
</noinclude>{{if pagename

<!-- Start of blacklist -->

| Main Page = hide <!-- Don't categorise the main page -->

<!-- Don't categorise on centralised cascade page or its subpages --> | Wikipedia:Cascade-protected items/+ = hide

<!-- Don't categorise userboxes in their own "template space" --> | User:UBX/+ = hide | User talk:UBX/+ = hide

| Wikipedia:Template messages/* = hide <!-- Don't categorise on its subpages -->

| /archiv* = hide <!-- Don't categorise on /archive pages -->

<!-- End of blacklist --> | page = {{{page|}}} <!-- Never change this one, see the doc -->

}}<noinclude>

Template loop detected: Template:Documentation </noinclude>+

The ++ used here is a simple way to make it visible when a template returns an empty string.

Or you can feed the pagename you want to test to this template. Then you can do all the testing for instance on the [[Template:Pgn/testcases|/testcases]] subpage of this template. Like this:

+{{category handler/blacklist| page = User:Example }}+
+{{category handler/blacklist| page = User:Example/Archive 5}}+

Which returns this:

+noinclude>Actual code of this blacklist:
</noinclude>{{if pagename

<!-- Start of blacklist -->

| Main Page = hide <!-- Don't categorise the main page -->

<!-- Don't categorise on centralised cascade page or its subpages --> | Wikipedia:Cascade-protected items/+ = hide

<!-- Don't categorise userboxes in their own "template space" --> | User:UBX/+ = hide | User talk:UBX/+ = hide

| Wikipedia:Template messages/* = hide <!-- Don't categorise on its subpages -->

| /archiv* = hide <!-- Don't categorise on /archive pages -->

<!-- End of blacklist --> | page = {{{page|}}} <!-- Never change this one, see the doc -->

}}<noinclude>

Template loop detected: Template:Documentation </noinclude>+

+noinclude>Actual code of this blacklist:
</noinclude>{{if pagename

<!-- Start of blacklist -->

| Main Page = hide <!-- Don't categorise the main page -->

<!-- Don't categorise on centralised cascade page or its subpages --> | Wikipedia:Cascade-protected items/+ = hide

<!-- Don't categorise userboxes in their own "template space" --> | User:UBX/+ = hide | User talk:UBX/+ = hide

| Wikipedia:Template messages/* = hide <!-- Don't categorise on its subpages -->

| /archiv* = hide <!-- Don't categorise on /archive pages -->

<!-- End of blacklist --> | page = {{{page|}}} <!-- Never change this one, see the doc -->

}}<noinclude>

Template loop detected: Template:Documentation </noinclude>+

Technical details

Currently this template is only called from {{category handler}}

, and indirectly from all templates that use {{category handler}}. But in the future this template might also be directly called from other templates similar to {{category handler}}. This means we can update the category suppression blacklist in one place.

See also