Difference between revisions of "Module:Category handler/config"
From BESA® Wiki
(make this fit within 80 chars) |
(restructure, make most config optional, and add a few items to the blacklist) |
||
Line 10: | Line 10: | ||
-------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ||
− | -- | + | -------------------------------------------------------------------------------- |
− | -- | + | -- Parameter names -- |
− | -- | + | -- These configuration items specify custom parameter names. Values added -- |
− | -- | + | -- here will work in addition to the default English parameter names. -- |
− | -- | + | -- To add one extra name, you can use this format: -- |
− | -- | + | -- -- |
− | -- | + | -- cfg.foo = 'parameter name' -- |
− | -- | + | -- -- |
− | -- | + | -- To add multiple names, you can use this format: -- |
− | -- | + | -- -- |
− | -- cfg. | + | -- cfg.foo = {'parameter name 1', 'parameter name 2', 'parameter name 3'} -- |
− | -- | + | -------------------------------------------------------------------------------- |
− | -- | + | |
− | -- | + | |
− | -- | + | |
− | -- | + | |
− | cfg. | + | |
− | + | ||
− | -- The parameter | + | ---- The nocat and categories parameter suppress |
− | -- | + | ---- categorisation. They are used with Module:Yesno, and work as follows: |
− | -- | + | ---- |
− | -- cfg. | + | ---- cfg.nocat: |
− | cfg. | + | ---- Result of yesno(args[cfg.nocat]) Effect |
− | cfg. | + | ---- true Categorisation is suppressed |
− | cfg. | + | ---- false Categorisation is allowed, and the |
+ | ---- blacklist check is skipped | ||
+ | ---- nil Categorisation is allowed | ||
+ | ---- | ||
+ | ---- cfg.categories: | ||
+ | ---- Result of yesno(args[cfg.categories]) Effect | ||
+ | ---- true Categorisation is allowed, and the | ||
+ | ---- blacklist check is skipped | ||
+ | ---- false Categorisation is suppressed | ||
+ | ---- nil Categorisation is allowed | ||
+ | -- cfg.nocat = 'nocat' | ||
+ | -- cfg.categories = 'categories' | ||
− | -- | + | ---- The parameter name for the legacy "category2" parameter. This skips the |
− | -- cfg. | + | ---- blacklist if set to the cfg.category2Yes value, and suppresses |
− | -- | + | ---- categorisation if present but equal to anything other than cfg.category2Yes |
− | cfg. | + | ---- or cfg.category2Negative. |
− | cfg. | + | -- cfg.category2 = 'category2' |
− | cfg. | + | |
− | -- | + | ---- cfg.subpage is the parameter name to specify how to behave on subpages. |
− | cfg. | + | -- cfg.subpage = 'subpage' |
− | -- The parameter | + | ---- The parameter for data to return in all namespaces. |
− | + | -- cfg.all = 'all' | |
− | -- | + | |
− | cfg. | + | |
− | -- The parameter name used to specify a page other than the current page; used | + | ---- The parameter name for data to return if no data is specified for the |
− | -- for testing and demonstration. This must be the same as the cfg.page | + | ---- namespace that is detected. |
− | -- parameter in [[Module:Namespace detect]]. | + | -- cfg.other = 'other' |
− | cfg. | + | |
+ | ---- The parameter name used to specify a page other than the current page; used | ||
+ | ---- for testing and demonstration. This must be the same as the cfg.page | ||
+ | ---- parameter in [[Module:Namespace detect]]. | ||
+ | cfg.demopage = 'page' | ||
+ | |||
+ | -------------------------------------------------------------------------------- | ||
+ | -- Parameter values -- | ||
+ | -- These are set values that can be used with certain parameters. Only one -- | ||
+ | -- value can be specified, like this: -- | ||
+ | -- -- | ||
+ | -- cfg.foo = 'value name' -- | ||
+ | -- -- | ||
+ | -- These settings are optional. It is always possible to use the module -- | ||
+ | -- defaults instead. -- | ||
+ | -------------------------------------------------------------------------------- | ||
+ | |||
+ | ---- The following settings are used with the cfg.category2 parameter. Setting | ||
+ | ---- cfg.category2 to cfg.category2Yes skips the blacklist, and if cfg.category2 | ||
+ | ---- is present but equal to anything other than cfg.category2Yes or | ||
+ | ---- cfg.category2Negative then it supresses cateogrisation. | ||
+ | -- cfg.category2Yes = 'yes' | ||
+ | -- cfg.category2Negative = '¬' | ||
+ | |||
+ | ---- The following settings are used with the cfg.subpage parameter. | ||
+ | ---- cfg.subpageNo is the value to specify to not categorise on subpages; | ||
+ | ---- cfg.subpageOnly is the value to specify to only categorise on subpages. | ||
+ | -- cfg.subpageNo = 'no' | ||
+ | -- cfg.subpageOnly = 'only' | ||
+ | |||
+ | -------------------------------------------------------------------------------- | ||
+ | -- Blacklist -- | ||
+ | -- The categorisation blacklist. Pages that match Lua patterns in this list -- | ||
+ | -- will not be categorised. (However, see the explanation of cfg.nocat, -- | ||
+ | -- cfg.categories and cfg.category2 for some exceptions.) If the namespace -- | ||
+ | -- name has a space in, it must be written with an underscore, e.g. -- | ||
+ | -- "Wikipedia_talk". Other parts of the title can have either underscores or -- | ||
+ | -- spaces. -- | ||
+ | -------------------------------------------------------------------------------- | ||
− | |||
− | |||
− | |||
− | |||
− | |||
cfg.blacklist = { | cfg.blacklist = { | ||
− | + | '^Main Page$', -- don't categorise the main page. | |
− | + | ||
− | + | -- Don't categorise the following pages or their subpages. | |
− | + | '^Wikipedia:Cascade%-protected items$', | |
− | + | '^Wikipedia:Cascade%-protected items/.*$', | |
− | + | '^User:UBX$', -- The userbox "template" space. | |
− | + | '^User:UBX/.*$', | |
− | + | '^User_talk:UBX$', | |
− | + | '^User_talk:UBX/.*$', | |
− | + | ||
− | + | -- Don't categorise subpages of these pages, but allow | |
− | + | -- categorisation of the base page. | |
− | + | '^Wikipedia:Template messages/.+$', | |
− | + | ||
− | + | -- Don't categorise User CSD logs or PROD logs. | |
+ | '^User:.*/[cC][sS][dD] ?[lL][oO][gG]', | ||
+ | '^User:.*/[pP][rR][oO][dD] ?[lL][oO][gG]', | ||
+ | |||
+ | -- Don't categorise archives. | ||
+ | '/[aA]rchive', | ||
+ | "^Wikipedia:Administrators' noticeboard/IncidentArchive", | ||
+ | "^Wikipedia:Administrators' noticeboard/3RRArchive", | ||
} | } | ||
− | -- This is a table of namespaces to categorise by default. They should be in | + | -------------------------------------------------------------------------------- |
− | -- format of parameter names accepted by [[Module:Namespace detect]]. | + | -- Default namespaces -- |
+ | -- This is a table of namespaces to categorise by default. They should be in -- | ||
+ | -- the format of parameter names accepted by [[Module:Namespace detect]]. -- | ||
+ | -------------------------------------------------------------------------------- | ||
+ | |||
cfg.defaultNamespaces = { | cfg.defaultNamespaces = { | ||
− | + | 'main', | |
− | + | 'file', | |
− | + | 'help', | |
− | + | 'category' | |
} | } | ||
Revision as of 18:59, 7 April 2014
Documentation for this module may be created at Module:Category handler/config/doc
Script error: Lua error: Internal error: The interpreter exited with status 126.
-------------------------------------------------------------------------------- -- [[Module:Category handler]] configuration data -- -- Language-specific parameter names and values can be set here. -- -------------------------------------------------------------------------------- local cfg = {} -- Don't edit this line. -------------------------------------------------------------------------------- -- Start configuration data -- -------------------------------------------------------------------------------- -------------------------------------------------------------------------------- -- Parameter names -- -- These configuration items specify custom parameter names. Values added -- -- here will work in addition to the default English parameter names. -- -- To add one extra name, you can use this format: -- -- -- -- cfg.foo = 'parameter name' -- -- -- -- To add multiple names, you can use this format: -- -- -- -- cfg.foo = {'parameter name 1', 'parameter name 2', 'parameter name 3'} -- -------------------------------------------------------------------------------- ---- The nocat and categories parameter suppress ---- categorisation. They are used with Module:Yesno, and work as follows: ---- ---- cfg.nocat: ---- Result of yesno(args[cfg.nocat]) Effect ---- true Categorisation is suppressed ---- false Categorisation is allowed, and the ---- blacklist check is skipped ---- nil Categorisation is allowed ---- ---- cfg.categories: ---- Result of yesno(args[cfg.categories]) Effect ---- true Categorisation is allowed, and the ---- blacklist check is skipped ---- false Categorisation is suppressed ---- nil Categorisation is allowed -- cfg.nocat = 'nocat' -- cfg.categories = 'categories' ---- The parameter name for the legacy "category2" parameter. This skips the ---- blacklist if set to the cfg.category2Yes value, and suppresses ---- categorisation if present but equal to anything other than cfg.category2Yes ---- or cfg.category2Negative. -- cfg.category2 = 'category2' ---- cfg.subpage is the parameter name to specify how to behave on subpages. -- cfg.subpage = 'subpage' ---- The parameter for data to return in all namespaces. -- cfg.all = 'all' ---- The parameter name for data to return if no data is specified for the ---- namespace that is detected. -- cfg.other = 'other' ---- The parameter name used to specify a page other than the current page; used ---- for testing and demonstration. This must be the same as the cfg.page ---- parameter in [[Module:Namespace detect]]. cfg.demopage = 'page' -------------------------------------------------------------------------------- -- Parameter values -- -- These are set values that can be used with certain parameters. Only one -- -- value can be specified, like this: -- -- -- -- cfg.foo = 'value name' -- -- -- -- These settings are optional. It is always possible to use the module -- -- defaults instead. -- -------------------------------------------------------------------------------- ---- The following settings are used with the cfg.category2 parameter. Setting ---- cfg.category2 to cfg.category2Yes skips the blacklist, and if cfg.category2 ---- is present but equal to anything other than cfg.category2Yes or ---- cfg.category2Negative then it supresses cateogrisation. -- cfg.category2Yes = 'yes' -- cfg.category2Negative = '¬' ---- The following settings are used with the cfg.subpage parameter. ---- cfg.subpageNo is the value to specify to not categorise on subpages; ---- cfg.subpageOnly is the value to specify to only categorise on subpages. -- cfg.subpageNo = 'no' -- cfg.subpageOnly = 'only' -------------------------------------------------------------------------------- -- Blacklist -- -- The categorisation blacklist. Pages that match Lua patterns in this list -- -- will not be categorised. (However, see the explanation of cfg.nocat, -- -- cfg.categories and cfg.category2 for some exceptions.) If the namespace -- -- name has a space in, it must be written with an underscore, e.g. -- -- "Wikipedia_talk". Other parts of the title can have either underscores or -- -- spaces. -- -------------------------------------------------------------------------------- cfg.blacklist = { '^Main Page$', -- don't categorise the main page. -- Don't categorise the following pages or their subpages. '^Wikipedia:Cascade%-protected items$', '^Wikipedia:Cascade%-protected items/.*$', '^User:UBX$', -- The userbox "template" space. '^User:UBX/.*$', '^User_talk:UBX$', '^User_talk:UBX/.*$', -- Don't categorise subpages of these pages, but allow -- categorisation of the base page. '^Wikipedia:Template messages/.+$', -- Don't categorise User CSD logs or PROD logs. '^User:.*/[cC][sS][dD] ?[lL][oO][gG]', '^User:.*/[pP][rR][oO][dD] ?[lL][oO][gG]', -- Don't categorise archives. '/[aA]rchive', "^Wikipedia:Administrators' noticeboard/IncidentArchive", "^Wikipedia:Administrators' noticeboard/3RRArchive", } -------------------------------------------------------------------------------- -- Default namespaces -- -- This is a table of namespaces to categorise by default. They should be in -- -- the format of parameter names accepted by [[Module:Namespace detect]]. -- -------------------------------------------------------------------------------- cfg.defaultNamespaces = { 'main', 'file', 'help', 'category' } -------------------------------------------------------------------------------- -- End configuration data -- -------------------------------------------------------------------------------- return cfg -- Don't edit this line.