Module:Documentation/config

From Coral Island Wiki
< Module:Documentation
Revision as of 13:07, 17 December 2023 by Salty Nori (talk | contribs) (Copied from Coral Island Wiki)
Jump to navigation Jump to search

Documentation for this module may be created at Module:Documentation/config/doc

--<pre>
----------------------------------------------------------------------------------------------------
--
--                         '''Configuration for [[Module:Documentation]]'''
--
-- Here you can set the values of the parameters and messages used in [[Module:Documentation]]
-- to localise it to your wiki and your language. Unless specified otherwise, values given here
-- should be string values.
--
-- @submodule documentation.config
-- @alias cfg
----------------------------------------------------------------------------------------------------

local cfg = {} -- Do not edit this line.

-- -------------------------------------------------------------------------------------------------
-- Protection template configuration
-- -------------------------------------------------------------------------------------------------

--- The protection reason for edit-protected templates to pass
--  to Module:Protection banner.
--  @property {string} cfg['protection-reason-edit']
cfg['protection-reason-edit'] = 'template'

-- -------------------------------------------------------------------------------------------------
-- Templates
-- -------------------------------------------------------------------------------------------------
--- A name of the template for Table of Contents in right alignment.
--  @property {string} cfg['template-tocright']
cfg['template-tocright'] = 'Tocright'

-- -------------------------------------------------------------------------------------------------
-- Sandbox notice configuration
--
-- On sandbox pages the module can display a template notifying users that the current page is a
-- sandbox, and the location of test cases pages, etc. The module decides whether the page is a
-- sandbox or not based on the value of cfg['sandbox-subpage']. The following settings configure the
-- messages that the notices contains.
-- -------------------------------------------------------------------------------------------------

-- Not yet converted to the new format

--- Whether to show the sandbox notice on `/sandbox` subpages
--  @property {boolean} cfg['sandbox-notice-show']
cfg['sandbox-notice-show'] = true

--- The file displayed in the sandbox notice.
--  @property {string} cfg['sandbox-notice-image']
cfg['sandbox-notice-image'] = 'Hinoki_bookcase.png'

--[[
-- cfg['sandbox-notice-pagetype-template']
-- cfg['sandbox-notice-pagetype-module']
-- cfg['sandbox-notice-pagetype-other']
-- The page type of the sandbox page. The message that is displayed depends on the current subject
-- namespace. This message is used in either cfg['sandbox-notice-blurb'] or
-- cfg['sandbox-notice-diff-blurb'].
--]]
cfg['sandbox-notice-pagetype-template'] = 'template draft page'
cfg['sandbox-notice-pagetype-module'] =   'module draft page'
cfg['sandbox-notice-pagetype-other'] = 'draft page'

--[[
-- cfg['sandbox-notice-blurb']
-- cfg['sandbox-notice-diff-blurb']
-- cfg['sandbox-notice-diff-display']
-- Either cfg['sandbox-notice-blurb'] or cfg['sandbox-notice-diff-blurb'] is the opening sentence
-- of the sandbox notice. The latter has a diff link, but the former does not. $1 is the page
-- type, which is either cfg['sandbox-notice-pagetype-template'],
-- cfg['sandbox-notice-pagetype-module'] or cfg['sandbox-notice-pagetype-other'] depending what
-- namespace we are in. $2 is a link to the main template page, and $3 is a diff link between
-- the sandbox and the main template. The display value of the diff link is set by
-- cfg['sandbox-notice-compare-link-display'].
--]]
cfg['sandbox-notice-blurb'] = 'This is the $1 for $2.'
cfg['sandbox-notice-diff-blurb'] = 'This is the $1 for $2 ($3).'
cfg['sandbox-notice-compare-link-display'] = 'diff'

--[[
-- cfg['sandbox-notice-testcases-blurb']
-- cfg['sandbox-notice-testcases-link-display']
-- cfg['sandbox-notice-testcases-run-blurb']
-- cfg['sandbox-notice-testcases-run-link-display']
-- cfg['sandbox-notice-testcases-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit. $1 is a link to the test cases page.
-- cfg['sandbox-notice-testcases-link-display'] is the display value for that link.
-- cfg['sandbox-notice-testcases-run-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit, along with a link to run it. $1 is a link to the test
-- cases page, and $2 is a link to the page to run it.
-- cfg['sandbox-notice-testcases-run-link-display'] is the display value for the link to run the test
-- cases.
--]]
cfg['sandbox-notice-testcases-show'] = true
cfg['sandbox-notice-testcases-blurb'] = 'See also the companion subpage for $1.'
cfg['sandbox-notice-testcases-link-display'] = 'test cases'
cfg['sandbox-notice-testcases-run-blurb'] = 'See also the companion subpage for $1 ($2).'
cfg['sandbox-notice-testcases-run-link-display'] = 'run'

--- A category to add to all template sandboxes.
--  @property {string} cfg['sandbox-category']
cfg['sandbox-category'] = 'Template drafts'
cfg['sandbox-module-category'] = 'Module drafts'

-- -------------------------------------------------------------------------------------------------
-- Start box configuration
-- -------------------------------------------------------------------------------------------------

--- The wikitext for the icon shown at the top of the template.
--  @property {string} cfg['documentation-icon-wikitext']
cfg['documentation-icon-wikitext'] = '[[File:$1|30px|link=|alt=Documentation icon]]'

--- The file name for the icon shown at the top of the template.
--  @property {string} cfg['documentation-icon']
cfg['documentation-icon'] = 'Hinoki_bookcase.png'

--- The file name for the icon shown at the top of the template when no /doc subpage exists.
--  @property {string} cfg['documentation-icon-nodoc']
cfg['documentation-icon-nodoc'] = 'Hinoki_bookcase.png'

--- The file name for the icon shown at the top of the template when the documentation is marked as bad.
--  @property {string} cfg['documentation-icon-baddoc']
cfg['documentation-icon-baddoc'] = 'Hinoki_bookcase.png'

-- -------------------------------------------------------------------------------------------------
-- Sandbox link configuration
-- -------------------------------------------------------------------------------------------------

--- Whether to show a link to the sandbox subpage
--  @property {boolean} cfg['sandbox-subpage-show']
cfg['sandbox-subpage-show'] = true

--- The name of the template subpage typically used for sandboxes.
--  @property {string} cfg['sandbox-subpage']
cfg['sandbox-subpage'] = 'Draft'

--- Preload file for template sandbox pages.
--  @property {string} cfg['template-sandbox-preload']
cfg['template-sandbox-preload'] = 'Template:Documentation/preload-sandbox'

--- Preload file for Lua module sandbox pages.
--  @property {string} cfg['module-sandbox-preload']
cfg['module-sandbox-preload'] = 'Template:Documentation/preload-module-sandbox'

--- The page to preload when a user clicks the "mirror" link.
--  @property {string} cfg['mirror-link-preload']
cfg['mirror-link-preload'] = 'Template:Documentation/mirror'

-- -------------------------------------------------------------------------------------------------
-- Test cases link configuration
-- -------------------------------------------------------------------------------------------------

--- The name of the template subpage typically used for test cases.
--  @property {string} cfg['testcases-subpage']
cfg['testcases-subpage'] = 'testcases'

--- Preload file for template test cases pages.
--  @property {string} cfg['template-testcases-preload']
cfg['template-testcases-preload'] = 'Template:Documentation/preload-testcases'

--- Preload file for Lua module test cases pages.
--  @property {string} cfg['module-testcases-preload']
cfg['module-testcases-preload'] = 'Template:Documentation/preload-module-testcases'

--- Preload file for Lua module test cases talk pages.
--  @property {string} cfg['module-testcases-run-preload']
cfg['module-testcases-run-preload'] = 'Template:Documentation/preload-module-testcases-run'

-- -------------------------------------------------------------------------------------------------
-- Add categories blurb configuration
-- -------------------------------------------------------------------------------------------------

--- The text to display when linking to the /doc subpage.
--  @property {string} cfg['doc-link-display']
cfg['doc-link-display'] = 'documentation'

-- -------------------------------------------------------------------------------------------------
-- Doc link configuration
-- -------------------------------------------------------------------------------------------------

--- The name of the subpage typically used for documentation pages.
--  @property {string} cfg['doc-subpage']
cfg['doc-subpage'] = 'doc'

--- Preload file for documentation page in the file namespace.
--  @property {string} cfg['file-docpage-preload']
cfg['file-docpage-preload'] = 'Template:Documentation/preload-filespace'

--- Preload file for template documentation pages in all namespaces.
--  @property {string} cfg['docpage-preload']
cfg['docpage-preload'] = 'Template:Documentation/preload'

--- Preload file for Lua module documentation pages.
--  @property {string} cfg['module-preload']
cfg['module-preload'] = 'Template:Documentation/preload-module-doc'

-- -------------------------------------------------------------------------------------------------
-- Print version configuration
-- -------------------------------------------------------------------------------------------------

--- Disables or enabled /print content
--  @property {boolean} cfg['print-show']
cfg['print-show'] = false

--- The name of the template subpage used for print versions.
--  @property {string} cfg['print-subpage']
cfg['print-subpage'] = 'Print'

--- The text to display when linking to the /Print subpage.
--  @property {string} cfg['print-link-display']
cfg['print-link-display'] = '/Print'

-- cfg['print-blurb']
-- Text to display if a /Print subpage exists. $1 is a link to the subpage with a display value of cfg['print-link-display'].
cfg['print-blurb'] = 'A [[Help:Books/for experts#Improving the book layout|print version]] of this template exists at $1.'
	.. ' If you make a change to this template, please update the print version as well.'

--- Set to true to enable output of cfg['print-category'] if a /Print subpage exists.
--  This should be a boolean value (either true or false).
--  @property {boolean} cfg['display-print-category']
cfg['display-print-category'] = false

--- Category to output if cfg['display-print-category'] is set to true, and a /Print subpage exists.
--  @property {string} cfg['print-category']
cfg['print-category'] = 'Templates with print versions'

-- -------------------------------------------------------------------------------------------------
-- HTML and CSS configuration
-- -------------------------------------------------------------------------------------------------

--- The "id" attribute of the main HTML "div" tag.
--  @property {string} cfg['main-div-id']
cfg['main-div-id'] = 'template-documentation'

--- The CSS classes added to the main HTML "div" tag.
--  @property {string} cfg['main-div-classes']
cfg['main-div-classes'] = 'template-documentation iezoomfix'

--- The CSS classes used for the start box "div" tag.
--  @property {string} cfg['start-box-div-classes']
cfg['start-box-div-classes'] = 'template-documentation-header'

--- The CSS classes used for the [view][edit][history] or [create] links in the start box.
--  @property {string} cfg['start-box-linkclasses']
cfg['start-box-linkclasses'] = 'mw-editsection-like plainlinks'

--- The HTML "id" attribute for the links in the start box.
--  @property {string} cfg['start-box-link-id']
cfg['start-box-link-id'] = 'doc_editlinks'

--- The CSS classes used for the languages list.
--  @property {string} cfg['languages-list-div-classes']
cfg['languages-list-div-classes'] = 'template-documentation-langs'

--- The CSS classes used for the content box "div" tag.
--  @property {string} cfg['content-box-div-classes']
cfg['content-box-div-classes'] = 'template-documentation-content'

--- The "id" attribute of the end box HTML "div" tag.
--  @property {string} cfg['end-box-div-id']
cfg['end-box-div-id'] = 'documentation-meta-data'

--- The CSS classes used for the end box "div" tag.
--  @property {string} cfg['end-box-div-classes']
cfg['end-box-div-classes'] = 'template-documentation-footer transclude-notice-bottom plainlinks'

-- -------------------------------------------------------------------------------------------------
-- Tracking category configuration
-- -------------------------------------------------------------------------------------------------

--- Set to true to enable output of cfg['strange-usage-category'] if the module is used on a /doc subpage
--  or a /testcases subpage. This should be a boolean value (either true or false).
--  @property {boolean} cfg['display-strange-usage-category']
cfg['display-strange-usage-category'] = true

--- Category to output if cfg['display-strange-usage-category'] is set to true and the module is used on a
--  /doc subpage or a /testcases subpage.
--  @property {string} cfg['strange-usage-category']
cfg['strange-usage-category'] = 'Pages with Strange ((documentation)) Usage'

--- Category to output if the /doc subpage is missing and the 'content' parameter is not specified
--  @property {string} cfg['nodoc-category-{template,module,file,other}']
cfg['nodoc-category-template'] = 'Templates with no documentation'
cfg['nodoc-category-module'] = 'Modules with no documentation'
cfg['nodoc-category-file'] = 'Files with no summary'
cfg['nodoc-category-other'] = 'Pages with no documentation'

--- Category to output if the documentation is marked as bad
--  @property {string} cfg['baddoc-category-{template,module,file,other}']
cfg['baddoc-category-template'] = 'Templates with bad documentation'
cfg['baddoc-category-module'] = 'Modules with bad documentation'
cfg['baddoc-category-file'] = 'Files with bad summary'
cfg['baddoc-category-other'] = 'Pages with bad documentation'

-- -------------------------------------------------------------------------------------------------
-- End configuration
--
-- Don't edit anything below this line.
-- -------------------------------------------------------------------------------------------------

return cfg