Модуль:Документация — различия между версиями
Материал из Hilarious Wiki
MailGik (обсуждение | вклад) (Новая страница: «local p = {} -- Creating a documentation page or transclution through {{subst:doc}} function p.create( f ) local args = require( 'Модуль:ProcessArgs' ).nor…») |
MailGik (обсуждение | вклад) |
||
(не показано 11 промежуточных версий этого же участника) | |||
Строка 67: | Строка 67: | ||
end | end | ||
− | local colour = ' | + | local colour = '161619' |
local message = '' | local message = '' | ||
if badDoc then | if badDoc then | ||
− | colour = ' | + | colour = '1b1814' |
message = "'''Документация " .. pageType .. " была отмечена как плохая. Пожалуйста, дополните или улучшите её.'''" | message = "'''Документация " .. pageType .. " была отмечена как плохая. Пожалуйста, дополните или улучшите её.'''" | ||
end | end | ||
Строка 85: | Строка 85: | ||
local out = table.concat( { | local out = table.concat( { | ||
− | '<div style="margin-bottom: 0.8em; padding: 0.8em 1em 0.7em; background-color: #' .. colour .. '; border: 1px solid # | + | '<div style="margin-bottom: 0.8em; padding: 0.8em 1em 0.7em; background-color: #' .. colour .. '; border: 1px solid #505050">', |
'<div style="float: right">[[' .. page:fullUrl( 'action=purge' ) .. ' обновить]]</div>', | '<div style="float: right">[[' .. page:fullUrl( 'action=purge' ) .. ' обновить]]</div>', | ||
'<p style="margin: 0">Это страница документации, ' .. certainty .. ' в основную страницу ' .. pageType .. '. Для дополнительной информации см. [[Шаблон:Документация]].</p>', | '<p style="margin: 0">Это страница документации, ' .. certainty .. ' в основную страницу ' .. pageType .. '. Для дополнительной информации см. [[Шаблон:Документация]].</p>', | ||
Строка 145: | Строка 145: | ||
local action = 'править' | local action = 'править' | ||
local preload = '' | local preload = '' | ||
− | local colour = ' | + | local colour = '161619' |
local message = '' | local message = '' | ||
local category = '' | local category = '' | ||
Строка 151: | Строка 151: | ||
action = 'создать' | action = 'создать' | ||
preload = '&preload=Шаблон:Документация/Предзагрузка' | preload = '&preload=Шаблон:Документация/Предзагрузка' | ||
− | colour = ' | + | colour = '161619' |
message = "'''У " .. pageType .. " нет документации. Если вы знаете, как использовать " .. pageType2 .. ", пожалуйста, добавьте соответствующую информацию.'''" | message = "'''У " .. pageType .. " нет документации. Если вы знаете, как использовать " .. pageType2 .. ", пожалуйста, добавьте соответствующую информацию.'''" | ||
if not args['некат'] then | if not args['некат'] then | ||
Строка 161: | Строка 161: | ||
end | end | ||
elseif badDoc then | elseif badDoc then | ||
− | colour = ' | + | colour = '1b1814' |
message = "'''Документация " .. pageType .. " была отмечена как плохая. Пожалуйста, дополните или улучшите её.'''\n" | message = "'''Документация " .. pageType .. " была отмечена как плохая. Пожалуйста, дополните или улучшите её.'''\n" | ||
if not args['некат'] then | if not args['некат'] then | ||
Строка 180: | Строка 180: | ||
table.insert( links, 1, '[[' .. docPage.fullText .. '|просмотр]]' ) | table.insert( links, 1, '[[' .. docPage.fullText .. '|просмотр]]' ) | ||
footer = table.concat( { | footer = table.concat( { | ||
− | '<div style="margin: 0.7em -1em -0.7em; background-color: # | + | '<div style="margin: 0.7em -1em -0.7em; background-color: #252527; border-top: 1px solid #505050; padding: 0.8em 1em 0.7em; clear: both">\n', |
'<div style="float: right">' .. mw.text.nowiki( '[' ) .. table.concat( links, ' | ' ) .. ']</div>\n', | '<div style="float: right">' .. mw.text.nowiki( '[' ) .. table.concat( links, ' | ' ) .. ']</div>\n', | ||
'<p style="margin: 0">Расположенная выше документация включена из [[' .. docPage.fullText .. ']].</p>\n', | '<p style="margin: 0">Расположенная выше документация включена из [[' .. docPage.fullText .. ']].</p>\n', | ||
Строка 188: | Строка 188: | ||
local out = { | local out = { | ||
− | '<div style="background-color: #' .. colour .. '; border: 1px solid # | + | '<div style="background-color: #' .. colour .. '; border: 1px solid #505050; padding: 0.8em 1em 0.7em; clear: both">\n', |
− | '<div style="margin: -0.8em -1em 0.8em; padding: 0.8em 1em 0.7em; background-color: # | + | '<div style="margin: -0.8em -1em 0.8em; padding: 0.8em 1em 0.7em; background-color: #252527; border-bottom: 1px solid #505050">\n', |
'<div style="float: right">' .. mw.text.nowiki( '[' ) .. table.concat( links, ' | ' ) .. ']</div>\n', | '<div style="float: right">' .. mw.text.nowiki( '[' ) .. table.concat( links, ' | ' ) .. ']</div>\n', | ||
'<span style="font-weight: bold; font-size: 130%">Документация</span>', | '<span style="font-weight: bold; font-size: 130%">Документация</span>', |
Текущая версия на 11:36, 5 августа 2016
Этот модуль необходим для работы шаблонов {{Документация}} и {{Документация/Шапка}}
Расположенная выше документация включена из Модуль:Документация/док.
local p = {}
-- Creating a documentation page or transclution through {{subst:doc}}
function p.create( f )
local args = require( 'Модуль:ProcessArgs' ).norm()
page = mw.title.getCurrentTitle()
namespace = args['тип'] or page.nsText
docPage = args['страница'] or namespace .. ':' .. page.baseText .. '/док'
local out
if page.fullText == docPage then
out = f:preprocess( '{{subst:Шаблон:Документация/Предзагрузка}}' )
else
local templateArgs = {}
if args['тип'] then
table.insert( templateArgs, 'тип=' .. args['тип'] )
end
if args['страница'] then
table.insert( templateArgs, 'страница=' .. args['страница'] )
end
out = '{{Документация|' .. table.concat( templateArgs, '|' ) .. '}}\n<!-- Размещайте категории/интервики на странице документации -->'
out = out:gsub( '|}}', '}}' )
end
if not mw.isSubsting() then
out = f:preprocess( out )
if not args['некат'] then
out = out .. '[[Категория:Страницы с требующими подстановки шаблонами]]'
end
end
return out
end
-- Header on the documentation page
function p.docPage(f)
local args = require( 'Модуль:ProcessArgs' ).merge( true )
local badDoc = args['плохдок']
if f:callParserFunction( '#dplvar:noheader' ) == '1' then
if badDoc then
f:callParserFunction( '#dplvar:set', 'baddoc', '1' )
end
return ''
end
local page = mw.title.getCurrentTitle()
local namespace = args['тип'] or page.nsText
local pageType = 'этого шаблона'
local pageType2 = 'этот шаблон'
local pageType3 = 'Шаблоны'
if namespace == 'Модуль' then
pageType = 'этого модуля'
pageType2 = 'этот модуль'
pageType3 = 'Модули'
elseif page.fullText:find( '.css$' ) then
pageType = 'этой таблицы стилей'
pageType2 = 'эту таблицу стилей'
pageType3 = 'Таблицы стилей'
elseif page.fullText:find( '.js$' ) then
pageType = 'этого скрипта'
pageType2 = 'этот скрипт'
pageType3 = 'Скрипты'
elseif namespace == 'MediaWiki' then
pageType = 'этого сообщения'
pageType2 = 'это сообщение'
pageType3 = 'Сообщения'
end
local colour = '161619'
local message = ''
if badDoc then
colour = '1b1814'
message = "'''Документация " .. pageType .. " была отмечена как плохая. Пожалуйста, дополните или улучшите её.'''"
end
local certainty = 'её следует включить'
if pageType2 == 'этот модуль' then
certainty = 'она будет включена'
end
local category = ''
if not args['некат'] then
category = '[[Категория:Страницы документации]]'
end
local out = table.concat( {
'<div style="margin-bottom: 0.8em; padding: 0.8em 1em 0.7em; background-color: #' .. colour .. '; border: 1px solid #505050">',
'<div style="float: right">[[' .. page:fullUrl( 'action=purge' ) .. ' обновить]]</div>',
'<p style="margin: 0">Это страница документации, ' .. certainty .. ' в основную страницу ' .. pageType .. '. Для дополнительной информации см. [[Шаблон:Документация]].</p>',
message,
'</div>',
category
}, '\n' )
return mw.text.trim( out )
end
-- Wrapper around the documentation on the main page
function p.page( f )
local args = require( 'Модуль:ProcessArgs' ).merge( true )
local page = mw.title.getCurrentTitle()
local namespace = args['тип'] or page.nsText
local docPage = mw.title.new( args['страница'] or namespace .. ':' .. page.text .. '/док' )
local noDoc = args['нетдок'] or not docPage.exists
local badDoc = args['плохдок']
local pageType = 'этого шаблона'
local pageType2 = 'этот шаблон'
local pageType3 = 'Шаблоны'
if namespace == 'Модуль' then
pageType = 'этого модуля'
pageType2 = 'этот модуль'
pageType3 = 'Модули'
elseif page.fullText:find( '.css$' ) then
pageType = 'этой таблицы стилей'
pageType2 = 'эту таблицу стилей'
pageType3 = 'Таблицы стилей'
elseif page.fullText:find( '.js$' ) then
pageType = 'этого скрипта'
pageType2 = 'этот скрипт'
pageType3 = 'Скрипты'
elseif namespace == 'MediaWiki' then
pageType = 'этого сообщения'
pageType2 = 'это сообщение'
pageType3 = 'Сообщения'
end
local docText = ''
if not noDoc then
f:callParserFunction( '#dplvar:set', 'noheader', '1' )
docText = mw.text.trim( f:expandTemplate{ title = ':' .. docPage.fullText } )
if f:callParserFunction( '#dplvar:baddoc' ) == '1' then
badDoc = 1
end
if docText == '' then
noDoc = 1
else
docText = '\n' .. docText .. '\n'
end
end
local action = 'править'
local preload = ''
local colour = '161619'
local message = ''
local category = ''
if noDoc then
action = 'создать'
preload = '&preload=Шаблон:Документация/Предзагрузка'
colour = '161619'
message = "'''У " .. pageType .. " нет документации. Если вы знаете, как использовать " .. pageType2 .. ", пожалуйста, добавьте соответствующую информацию.'''"
if not args['некат'] then
if mw.title.new( 'Категория:' .. pageType3 .. ' без документации' ).exists then
category = '[[Категория:' .. pageType3 .. ' без документации]]'
else
category = '[[Категория:Страницы без документации]]'
end
end
elseif badDoc then
colour = '1b1814'
message = "'''Документация " .. pageType .. " была отмечена как плохая. Пожалуйста, дополните или улучшите её.'''\n"
if not args['некат'] then
if mw.title.new( 'Категория:' .. pageType3 .. ' с плохой документацией' ).exists then
category = '[[Категория:' .. pageType3 .. ' с плохой документацией]]'
else
category = '[[Категория:Страницы с плохой документацией]]'
end
end
end
local links = {
'[' .. docPage:fullUrl( 'action=edit' .. preload ) .. ' ' .. action .. ']',
'[' .. page:fullUrl( 'action=purge' ) .. ' обновить]'
}
local footer = ''
if not noDoc then
table.insert( links, 1, '[[' .. docPage.fullText .. '|просмотр]]' )
footer = table.concat( {
'<div style="margin: 0.7em -1em -0.7em; background-color: #252527; border-top: 1px solid #505050; padding: 0.8em 1em 0.7em; clear: both">\n',
'<div style="float: right">' .. mw.text.nowiki( '[' ) .. table.concat( links, ' | ' ) .. ']</div>\n',
'<p style="margin: 0">Расположенная выше документация включена из [[' .. docPage.fullText .. ']].</p>\n',
'</div>\n'
} )
end
local out = {
'<div style="background-color: #' .. colour .. '; border: 1px solid #505050; padding: 0.8em 1em 0.7em; clear: both">\n',
'<div style="margin: -0.8em -1em 0.8em; padding: 0.8em 1em 0.7em; background-color: #252527; border-bottom: 1px solid #505050">\n',
'<div style="float: right">' .. mw.text.nowiki( '[' ) .. table.concat( links, ' | ' ) .. ']</div>\n',
'<span style="font-weight: bold; font-size: 130%">Документация</span>',
'</div>\n',
message,
docText,
footer,
'</div>\n',
category
}
return mw.text.trim( table.concat( out ) )
end
return p