Module:Excerpt:修订间差异
删除的内容 添加的内容
创建页面,内容为“-- Module:Excerpt implements the Excerpt template -- Documentation https://www.mediawiki.org/wiki/Module:Excerpt -- By User:Sophivorus, User:Certes & others -- Version 1.2.3 -- License CC BY-SA-3.0 local Transcluder = require( 'Module:Transcluder' ) local yesno = require( 'Module:Yesno' ) local ok, config = pcall( require, 'Module:Excerpt/config' ) if not ok then config = {} end local p = {} -- Helper function to get arguments local args function getArg( k…” |
小无编辑摘要 |
||
第2行: | 第2行: | ||
-- Documentation https://www.mediawiki.org/wiki/Module:Excerpt |
-- Documentation https://www.mediawiki.org/wiki/Module:Excerpt |
||
-- By User:Sophivorus, User:Certes & others |
-- By User:Sophivorus, User:Certes & others |
||
-- Version 1.2 |
-- Version 1.2 Chinese Version |
||
-- License CC |
-- License CC-BY-SA-4.0 |
||
local Transcluder = require( |
local Transcluder = require('Module:Transcluder') |
||
local yesno = require( |
local yesno = require('Module:Yesno') |
||
local ok, config = pcall( |
local ok, config = pcall(require, 'Module:Excerpt/config') |
||
if not ok then config = {} end |
if not ok then config = {} end |
||
第16行: | 第16行: | ||
-- Helper function to get arguments |
-- Helper function to get arguments |
||
local args |
local args |
||
function getArg( |
function getArg(key, default) |
||
value = args[key] |
|||
if value and mw.text.trim( |
if value and mw.text.trim(value) ~= '' then |
||
return value |
return value |
||
end |
end |
||
第25行: | 第25行: | ||
-- Helper function to handle errors |
-- Helper function to handle errors |
||
function getError( |
function getError(message, value) |
||
if type( |
if type(message) == 'string' then |
||
message = Transcluder.getError( |
message = Transcluder.getError(message, value) |
||
end |
end |
||
if config.categories and config.categories.errors and mw.title.getCurrentTitle().isContentPage then |
if config.categories and config.categories.errors and mw.title.getCurrentTitle().isContentPage then |
||
message:node( |
message:node('[[Category:' .. config.categories.errors .. ']]') |
||
end |
end |
||
return message |
return message |
||
第36行: | 第36行: | ||
-- Helper function to get localized messages |
-- Helper function to get localized messages |
||
function getMessage( |
function getMessage(key) |
||
local ok, TNT = pcall( |
local ok, TNT = pcall(require, 'Module:TNT') |
||
if not ok then return key end |
if not ok then return key end |
||
return TNT.format( |
return TNT.format('I18n/Module:Excerpt.tab', key) |
||
end |
end |
||
function p.main( |
function p.main(frame) |
||
args = Transcluder.parseArgs( |
args = Transcluder.parseArgs(frame) |
||
-- Make sure the requested page exists |
-- Make sure the requested page exists |
||
local page = getArg( |
local page = getArg(1, getArg('article') ) |
||
if not page then return getError( |
if not page then return getError('no-page') end |
||
local title = mw.title.new(page) |
local title = mw.title.new(page) |
||
if not title then return getError( |
if not title then return getError('no-page') end |
||
if title.isRedirect then title = title.redirectTarget end |
if title.isRedirect then title = title.redirectTarget end |
||
if not title.exists then return getError( |
if not title.exists then return getError('page-not-found', page) end |
||
page = title.prefixedText |
page = title.prefixedText |
||
-- Set variables from the template parameters |
-- Set variables from the template parameters |
||
local |
local link=getArg('link') |
||
local |
local fragment = getArg('fragment') |
||
local |
local section = fragment or getArg(2, getArg('section',mw.ustring.match( getArg(1, getArg('article') ), '[^#]+#(.+)') ) ) |
||
local |
local hat = yesno( getArg('hat', true) ) |
||
local |
local edit = yesno( getArg('edit', true) ) |
||
local |
local this = getArg('this') |
||
local |
local only = getArg('only') |
||
local |
local files = getArg('files', getArg('file', ( only == 'file' and 1 ) ) ) |
||
local |
local lists = getArg('lists', getArg('list', ( only == 'list' and 1 ) ) ) |
||
local |
local tables = getArg('tables', getArg('table', ( only == 'table' and 1 ) ) ) |
||
local |
local templates = getArg('templates', getArg('template', ( only == 'template' and 1 ) ) ) |
||
local |
local paragraphs = getArg('paragraphs', getArg('paragraph', ( only == 'paragraph' and 1 ) ) ) |
||
local |
local references = getArg('references') |
||
local |
local subsections = not yesno( getArg('subsections') ) |
||
local |
local noBold = not yesno( getArg('bold') ) |
||
local |
local freefiles = yesno( getArg('freefiles') ) |
||
local |
local inline = yesno( getArg('inline') ) |
||
local |
local quote = yesno( getArg('quote') ) |
||
local more = yesno( getArg('more') ) |
|||
local class = getArg('class') |
|||
-- Build the hatnote |
-- Build the hatnote |
||
第79行: | 第81行: | ||
hat = this |
hat = this |
||
elseif quote then |
elseif quote then |
||
hat = getMessage( |
hat = getMessage('this') |
||
elseif only then |
elseif only then |
||
hat = getMessage( |
hat = getMessage(only) |
||
else |
else |
||
hat = getMessage( |
hat = getMessage('section') |
||
end |
end |
||
hat = hat |
hat = hat .. getMessage('excerpt') |
||
if |
if link then |
||
hat = hat .. link |
|||
⚫ | |||
elseif section and not fragment then |
|||
⚫ | |||
⚫ | |||
⚫ | |||
else |
else |
||
hat = hat .. '[[:' .. page .. '|' .. page .. ']] |
hat = hat .. '[[:' .. page .. '|' .. page .. ']]' |
||
end |
end |
||
if edit then |
if edit then |
||
hat = hat .. '<span class="mw-editsection-like plainlinks"><span class="mw-editsection-bracket">[</span>[' |
hat = hat .. '<span class="mw-editsection-like plainlinks"><span class="mw-editsection-bracket">[</span>[' |
||
hat = hat .. title:fullUrl( |
hat = hat .. title:fullUrl('action=edit') .. ' ' .. mw.message.new('editsection'):plain() |
||
hat = hat .. ']<span class="mw-editsection-bracket">]</span></span>' |
hat = hat .. ']<span class="mw-editsection-bracket">]</span></span>' |
||
end |
end |
||
if config.hat then |
if config.hat then |
||
hat = config.hat .. hat .. '}}' |
hat = config.hat .. hat .. '}}' |
||
hat = frame:preprocess( |
hat = frame:preprocess(hat) |
||
else |
else |
||
hat = mw.html.create( |
hat = mw.html.create('div'):addClass('dablink excerpt-hat'):wikitext(hat) |
||
end |
end |
||
else |
else |
||
第109行: | 第113行: | ||
-- Build the "Read more" link |
-- Build the "Read more" link |
||
if more and not inline then |
if more and not inline then |
||
more = "'''[[" .. page .. '#' .. ( |
more = "'''[[" .. page .. '#' .. (section or '') .. "|" .. getMessage('more') .. "]]'''" |
||
more = mw.html.create( |
more = mw.html.create('div'):addClass('noprint excerpt-more'):wikitext(more) |
||
else |
else |
||
more = nil |
more = nil |
||
第124行: | 第128行: | ||
categories = 0, |
categories = 0, |
||
references = references, |
references = references, |
||
only = only and mw.text.trim( |
only = only and mw.text.trim(only, 's') .. 's', |
||
noBold = noBold, |
noBold = noBold, |
||
noSelfLinks = true, |
noSelfLinks = true, |
||
第134行: | 第138行: | ||
-- Get the excerpt itself |
-- Get the excerpt itself |
||
local title = page .. '#' .. ( |
local title = page .. '#' .. (section or '') |
||
local ok, excerpt = pcall( |
local ok, excerpt = pcall(Transcluder.get, title, options) |
||
if not ok then return getError( |
if not ok then return getError(excerpt) end |
||
if mw.text.trim( |
if mw.text.trim(excerpt) == '' and not only then |
||
if section then return getError( |
if section then return getError('section-empty', section) else return getError('lead-empty') end |
||
end |
end |
||
-- If no file was found, try to get one from the infobox |
-- If no file was found, try to get one from the infobox |
||
local fileNamespaces = Transcluder.getNamespaces( |
local fileNamespaces = Transcluder.getNamespaces('File') |
||
if ( |
if ((only == 'file' or only == 'files') or (not only and (files ~= '0' or not files))) and -- caller asked for files |
||
not Transcluder.matchAny( |
not Transcluder.matchAny(excerpt, '%[%[', fileNamespaces, ':') and -- and there are no files in Transcluder's output |
||
config.captions -- and we have the config option required to try finding files in templates |
config.captions -- and we have the config option required to try finding files in templates |
||
then |
then |
||
-- We cannot distinguish the infobox from the other templates so we search them all |
-- We cannot distinguish the infobox from the other templates so we search them all |
||
local infobox = Transcluder.getTemplates( |
local infobox = Transcluder.getTemplates(excerpt); |
||
infobox = table.concat( |
infobox = table.concat(infobox) |
||
local parameters = Transcluder.getParameters( |
local parameters = Transcluder.getParameters(infobox) |
||
local file, captions, caption |
local file, captions, caption |
||
for _, pair in pairs( |
for _, pair in pairs(config.captions) do |
||
file = pair[1] |
file = pair[1] |
||
file = parameters[file] |
file = parameters[file] |
||
if file and Transcluder.matchAny( |
if file and Transcluder.matchAny(file, '^.*%.', {'[Jj][Pp][Ee]?[Gg]','[Pp][Nn][Gg]','[Gg][Ii][Ff]','[Ss][Vv][Gg]'}, '.*') then |
||
file = mw.ustring.match( |
file = mw.ustring.match(file, '%[?%[?.-:([^{|]+)%]?%]?') or file -- [[File:Example.jpg{{!}}upright=1.5]] to Example.jpg |
||
captions = pair[2] |
captions = pair[2] |
||
for _, p in pairs( |
for _, p in pairs(captions) do |
||
if parameters[ |
if parameters[p] then caption = parameters[p] break end |
||
end |
end |
||
excerpt = '[[File:' .. file .. '|thumb|' .. ( |
excerpt = '[[File:' .. file .. '|thumb|' .. (caption or '') .. ']]' .. excerpt |
||
if ( freefiles ) then |
if ( freefiles ) then |
||
excerpt = Transcluder.removeNonFreeFiles( |
excerpt = Transcluder.removeNonFreeFiles(excerpt) |
||
end |
end |
||
break |
break |
||
第173行: | 第177行: | ||
-- because we had to search the infoboxes for files |
-- because we had to search the infoboxes for files |
||
local trash |
local trash |
||
if only and ( |
if only and (only == 'template' or only == 'templates') then |
||
trash, excerpt = Transcluder.getTemplates( |
trash, excerpt = Transcluder.getTemplates(excerpt, templates); |
||
else -- Remove blacklisted templates |
else -- Remove blacklisted templates |
||
local blacklist = config.blacklist and table.concat( |
local blacklist = config.blacklist and table.concat(config.blacklist, ',') or '' |
||
if templates then |
if templates then |
||
if string.sub( |
if string.sub(templates, 1, 1) == '-' then --Unwanted templates. Append to blacklist |
||
blacklist = templates .. ',' .. blacklist |
blacklist = templates .. ',' .. blacklist |
||
else --Wanted templates. Replaces blacklist and acts as whitelist |
else --Wanted templates. Replaces blacklist and acts as whitelist |
||
第186行: | 第190行: | ||
blacklist = '-' .. blacklist |
blacklist = '-' .. blacklist |
||
end |
end |
||
trash, excerpt = Transcluder.getTemplates( |
trash, excerpt = Transcluder.getTemplates(excerpt, blacklist); |
||
end |
end |
||
local oneparexcerpt=false |
|||
-- Remove extra line breaks but leave one before and after so the parser interprets lists, tables, etc. correctly |
-- Remove extra line breaks but leave one before and after so the parser interprets lists, tables, etc. correctly |
||
excerpt = mw.text.trim( |
excerpt = mw.text.trim(excerpt) |
||
excerpt = string.gsub( |
excerpt = string.gsub(excerpt, '\n\n\n+', '\n\n') |
||
if (string.find (excerpt, '\n\n')==nil) then |
|||
oneparexcerpt=true |
|||
⚫ | |||
excerpt = '\n' .. excerpt .. '\n' |
excerpt = '\n' .. excerpt .. '\n' |
||
-- Remove nested categories |
-- Remove nested categories |
||
excerpt = frame:preprocess( |
excerpt = frame:preprocess(excerpt) |
||
local categories, excerpt = Transcluder.getCategories( |
local categories, excerpt = Transcluder.getCategories(excerpt, options.categories) |
||
-- Add tracking categories |
-- Add tracking categories |
||
第215行: | 第224行: | ||
styles = frame:extensionTag( 'templatestyles', '', { src = config.styles } ) |
styles = frame:extensionTag( 'templatestyles', '', { src = config.styles } ) |
||
end |
end |
||
local createp=false |
|||
-- Combine and return the elements |
-- Combine and return the elements |
||
local tag1 = 'div' |
local tag1 = 'div' |
||
local tag2 = 'div' |
local tag2 = 'div' |
||
if |
if inline then |
||
tag1 = 'span' |
|||
tag2 = 'span' |
|||
elseif quote then |
|||
tag2 = 'blockquote' |
tag2 = 'blockquote' |
||
elseif oneparexcerpt then |
|||
createp=true |
|||
end |
end |
||
⚫ | |||
excerpt = mw.html.create('p'):wikitext(excerpt) |
|||
⚫ | |||
excerpt = |
excerpt = mw.html.create(tag1):addClass('excerpt'):node(excerpt) |
||
else |
|||
⚫ | |||
excerpt = mw.html.create(tag1):addClass('excerpt'):wikitext(excerpt) |
|||
if inline then |
|||
block = block:css( 'display', 'inline' ) |
|||
end |
end |
||
local block = mw.html.create(tag2):addClass('excerpt-block'):addClass(class) |
|||
return block:node(styles):node(hat):node(excerpt):node(more) |
|||
end |
end |
||
-- Entry points for backwards compatibility |
-- Entry points for backwards compatibility |
||
function p.lead( |
function p.lead(frame) return p.main(frame) end |
||
function p.excerpt( |
function p.excerpt(frame) return p.main(frame) end |
||
return p |
return p |
2022年8月17日 (三) 20:23的最新版本
模块文档[创建]
您可能想要创建本Scribunto模块的文档。 编者可以在本模板的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。 请在/doc子页面中添加分类。本模块的子页面。 |
-- Module:Excerpt implements the Excerpt template
-- Documentation https://www.mediawiki.org/wiki/Module:Excerpt
-- By User:Sophivorus, User:Certes & others
-- Version 1.2 Chinese Version
-- License CC-BY-SA-4.0
local Transcluder = require('Module:Transcluder')
local yesno = require('Module:Yesno')
local ok, config = pcall(require, 'Module:Excerpt/config')
if not ok then config = {} end
local p = {}
-- Helper function to get arguments
local args
function getArg(key, default)
value = args[key]
if value and mw.text.trim(value) ~= '' then
return value
end
return default
end
-- Helper function to handle errors
function getError(message, value)
if type(message) == 'string' then
message = Transcluder.getError(message, value)
end
if config.categories and config.categories.errors and mw.title.getCurrentTitle().isContentPage then
message:node('[[Category:' .. config.categories.errors .. ']]')
end
return message
end
-- Helper function to get localized messages
function getMessage(key)
local ok, TNT = pcall(require, 'Module:TNT')
if not ok then return key end
return TNT.format('I18n/Module:Excerpt.tab', key)
end
function p.main(frame)
args = Transcluder.parseArgs(frame)
-- Make sure the requested page exists
local page = getArg(1, getArg('article') )
if not page then return getError('no-page') end
local title = mw.title.new(page)
if not title then return getError('no-page') end
if title.isRedirect then title = title.redirectTarget end
if not title.exists then return getError('page-not-found', page) end
page = title.prefixedText
-- Set variables from the template parameters
local link=getArg('link')
local fragment = getArg('fragment')
local section = fragment or getArg(2, getArg('section',mw.ustring.match( getArg(1, getArg('article') ), '[^#]+#(.+)') ) )
local hat = yesno( getArg('hat', true) )
local edit = yesno( getArg('edit', true) )
local this = getArg('this')
local only = getArg('only')
local files = getArg('files', getArg('file', ( only == 'file' and 1 ) ) )
local lists = getArg('lists', getArg('list', ( only == 'list' and 1 ) ) )
local tables = getArg('tables', getArg('table', ( only == 'table' and 1 ) ) )
local templates = getArg('templates', getArg('template', ( only == 'template' and 1 ) ) )
local paragraphs = getArg('paragraphs', getArg('paragraph', ( only == 'paragraph' and 1 ) ) )
local references = getArg('references')
local subsections = not yesno( getArg('subsections') )
local noBold = not yesno( getArg('bold') )
local freefiles = yesno( getArg('freefiles') )
local inline = yesno( getArg('inline') )
local quote = yesno( getArg('quote') )
local more = yesno( getArg('more') )
local class = getArg('class')
-- Build the hatnote
if hat and not inline then
if this then
hat = this
elseif quote then
hat = getMessage('this')
elseif only then
hat = getMessage(only)
else
hat = getMessage('section')
end
hat = hat .. getMessage('excerpt')
if link then
hat = hat .. link
elseif section and not fragment then
hat = hat .. '[[:' .. page .. '#' .. mw.uri.anchorEncode(section) .. '|' .. page
.. ' § ' .. mw.ustring.gsub(section, '%[%[([^]|]+)|?[^]]*%]%]', '%1') .. ']]'-- remove nested links
else
hat = hat .. '[[:' .. page .. '|' .. page .. ']]'
end
if edit then
hat = hat .. '<span class="mw-editsection-like plainlinks"><span class="mw-editsection-bracket">[</span>['
hat = hat .. title:fullUrl('action=edit') .. ' ' .. mw.message.new('editsection'):plain()
hat = hat .. ']<span class="mw-editsection-bracket">]</span></span>'
end
if config.hat then
hat = config.hat .. hat .. '}}'
hat = frame:preprocess(hat)
else
hat = mw.html.create('div'):addClass('dablink excerpt-hat'):wikitext(hat)
end
else
hat = nil
end
-- Build the "Read more" link
if more and not inline then
more = "'''[[" .. page .. '#' .. (section or '') .. "|" .. getMessage('more') .. "]]'''"
more = mw.html.create('div'):addClass('noprint excerpt-more'):wikitext(more)
else
more = nil
end
-- Build the options for Module:Transcluder out of the template parameters and the desired defaults
local options = {
files = files,
lists = lists,
tables = tables,
paragraphs = paragraphs,
sections = subsections,
categories = 0,
references = references,
only = only and mw.text.trim(only, 's') .. 's',
noBold = noBold,
noSelfLinks = true,
noNonFreeFiles = freefiles,
noBehaviorSwitches = true,
fixReferences = true,
linkBold = true,
}
-- Get the excerpt itself
local title = page .. '#' .. (section or '')
local ok, excerpt = pcall(Transcluder.get, title, options)
if not ok then return getError(excerpt) end
if mw.text.trim(excerpt) == '' and not only then
if section then return getError('section-empty', section) else return getError('lead-empty') end
end
-- If no file was found, try to get one from the infobox
local fileNamespaces = Transcluder.getNamespaces('File')
if ((only == 'file' or only == 'files') or (not only and (files ~= '0' or not files))) and -- caller asked for files
not Transcluder.matchAny(excerpt, '%[%[', fileNamespaces, ':') and -- and there are no files in Transcluder's output
config.captions -- and we have the config option required to try finding files in templates
then
-- We cannot distinguish the infobox from the other templates so we search them all
local infobox = Transcluder.getTemplates(excerpt);
infobox = table.concat(infobox)
local parameters = Transcluder.getParameters(infobox)
local file, captions, caption
for _, pair in pairs(config.captions) do
file = pair[1]
file = parameters[file]
if file and Transcluder.matchAny(file, '^.*%.', {'[Jj][Pp][Ee]?[Gg]','[Pp][Nn][Gg]','[Gg][Ii][Ff]','[Ss][Vv][Gg]'}, '.*') then
file = mw.ustring.match(file, '%[?%[?.-:([^{|]+)%]?%]?') or file -- [[File:Example.jpg{{!}}upright=1.5]] to Example.jpg
captions = pair[2]
for _, p in pairs(captions) do
if parameters[p] then caption = parameters[p] break end
end
excerpt = '[[File:' .. file .. '|thumb|' .. (caption or '') .. ']]' .. excerpt
if ( freefiles ) then
excerpt = Transcluder.removeNonFreeFiles(excerpt)
end
break
end
end
end
-- Unlike other elements, templates are filtered here
-- because we had to search the infoboxes for files
local trash
if only and (only == 'template' or only == 'templates') then
trash, excerpt = Transcluder.getTemplates(excerpt, templates);
else -- Remove blacklisted templates
local blacklist = config.blacklist and table.concat(config.blacklist, ',') or ''
if templates then
if string.sub(templates, 1, 1) == '-' then --Unwanted templates. Append to blacklist
blacklist = templates .. ',' .. blacklist
else --Wanted templates. Replaces blacklist and acts as whitelist
blacklist = templates
end
else
blacklist = '-' .. blacklist
end
trash, excerpt = Transcluder.getTemplates(excerpt, blacklist);
end
local oneparexcerpt=false
-- Remove extra line breaks but leave one before and after so the parser interprets lists, tables, etc. correctly
excerpt = mw.text.trim(excerpt)
excerpt = string.gsub(excerpt, '\n\n\n+', '\n\n')
if (string.find (excerpt, '\n\n')==nil) then
oneparexcerpt=true
end
excerpt = '\n' .. excerpt .. '\n'
-- Remove nested categories
excerpt = frame:preprocess(excerpt)
local categories, excerpt = Transcluder.getCategories(excerpt, options.categories)
-- Add tracking categories
if config.categories then
local contentCategory = config.categories.content
if contentCategory and mw.title.getCurrentTitle().isContentPage then
excerpt = excerpt .. '[[Category:' .. contentCategory .. ']]'
end
local namespaceCategory = config.categories[ mw.title.getCurrentTitle().namespace ]
if namespaceCategory then
excerpt = excerpt .. '[[Category:' .. namespaceCategory .. ']]'
end
end
-- Load the styles
local styles
if config.styles then
styles = frame:extensionTag( 'templatestyles', '', { src = config.styles } )
end
local createp=false
-- Combine and return the elements
local tag1 = 'div'
local tag2 = 'div'
if inline then
tag1 = 'span'
tag2 = 'span'
elseif quote then
tag2 = 'blockquote'
elseif oneparexcerpt then
createp=true
end
if createp then
excerpt = mw.html.create('p'):wikitext(excerpt)
excerpt = mw.html.create(tag1):addClass('excerpt'):node(excerpt)
else
excerpt = mw.html.create(tag1):addClass('excerpt'):wikitext(excerpt)
end
local block = mw.html.create(tag2):addClass('excerpt-block'):addClass(class)
return block:node(styles):node(hat):node(excerpt):node(more)
end
-- Entry points for backwards compatibility
function p.lead(frame) return p.main(frame) end
function p.excerpt(frame) return p.main(frame) end
return p