Module:Excerpt: Difference between revisions

Revision as of 18:48, 6 May 2018

Latest revision as of 01:57, 28 January 2025

(161 intermediate revisions by 10 users not shown)

Line 1:

-- Module:Excerpt implements the Excerpt template

-- Documentation and master version: https://en.wikipedia.org/wiki/Module:Excerpt

-- Authors: User:Sophivorus, User:Certes, User:Aidan9382 & others

-- 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 = {}

local mRedirect = require('Module:Redirect')

local errors

-- Helper function to get arguments

-- Entry point for Lua callers

local args

-- Returns a string value: text of the lead of a page

local function p._leadgetArg(pagenames key, optionsdefault )

local value = args[ key ]

errors = options.errors

if value and mw.text.trim( value ) ~= '' then

return value

end

return default

end

-- Helper function to handle errors

if not pagenames or #pagenames < 1 then return p.err("No page names given") end

local 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

local pagename

local function getMessage( key )

local text

local pagecountok, TNT = #pagenamespcall( require, 'Module:TNT' )

if not ok then return key end

local firstpage = pagenames[1] or "(nil)" -- save for error message, as it the name will be deleted

return TNT.format( 'I18n/Module:Excerpt.tab', key )

end

-- Main entry point for templates

-- read the page, or a random one if multiple pages were provided

function p.main( frame )

if pagecount > 1 then math.randomseed(os.time()) end

args = Transcluder.parseArgs( frame )

while not text and pagecount > 0 do

local pagenum = 1

if pagecount > 1 then pagenum = math.random(pagecount) end -- pick a random title

pagename = pagenames[pagenum]

if pagename and pagename ~= "" then

pagename = mw.ustring.match(pagename, "%[%[%s*(.-)[]|#]") or pagename -- "[[Foo|Bar]]" → "Foo"

pagename = mw.ustring.match(pagename, "%S.*%S") -- strip leading and trailing white space

-- Make sure the requested page exists

if pagename and pagename ~= "" then

local page = getArg( 1 )

local title = mw.title.new(pagename) -- Find the lead section of the named page

if not titlepage thenor returnpage p.err("No== title'{{{1}}}' forthen pagereturn namegetError( " ..'no-page' pagename) end

local redirtitle = mRedirectmw.getTarget(title.new(page)

if redirnot title then titlereturn =getError( mw.'invalid-title.new(redir', 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

text = title:getContent()

local section = getArg( 2, mw.ustring.match( getArg( 1 ), '[^#]+#(.+)' ) )

end

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 noLinks = not yesno( getArg( 'links', true ) )

local noBold = not yesno( getArg( 'bold' ) )

local onlyFreeFiles = yesno( getArg( 'onlyfreefiles', true ) )

local briefDates = yesno( getArg( 'briefdates', false ) )

local inline = yesno( getArg( 'inline' ) )

local quote = yesno( getArg( 'quote' ) )

local more = yesno( getArg( 'more' ) )

local class = getArg( 'class' )

local displaytitle = getArg( 'displaytitle' ) or page

-- 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 section then

hat = hat .. '[[:' .. page .. '#' .. mw.uri.anchorEncode( section ) .. '|' .. displaytitle

.. ' § ' .. mw.ustring.gsub( section, '%[%[([^]|]+)|?[^]]*%]%]', '%1' ) .. ']].' -- remove nested links

else

hat = hat .. '[[:' .. page .. '|' .. displaytitle .. ']].'

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

if not text then table.remove(pagenames, pagenum) end -- this one didn't work; try another

hat = nil

pagecount = pagecount - 1 -- ensure that we exit the loop eventually

end

if not text then return p.err("Cannot read a valid page: first name is " .. firstpage) end

-- Build the "Read more" link

text = mw.ustring.gsub(text, "%c%s*==.*","") -- remove first heading and everything after it

if more and not inline then

text = mw.ustring.gsub(text, "<noinclude>.-</noinclude>", "") -- remove noinclude bits

more = "'''[[" .. page .. '#' .. ( section or '' ) .. "|" .. getMessage( 'more' ) .. "]]'''"

text = mw.ustring.gsub(text, "<%s*ref[^>]-/%s*>", "") -- remove refs cited elsewhere

more = mw.html.create( 'div' ):addClass( 'noprint excerpt-more' ):wikitext( more )

text = mw.ustring.gsub(text, "<%s*ref.->.-<%s*/%s*ref%s*>", "") -- remove refs

else

for _, t in pairs {"[Ee]fn", "[Ee]fn-la", "[Ee]l[mn]", "[Rr]p?", "[Ss]fn[bp]", "[Ss]f[bn]", "NoteTag", "#[Tt]ag:%s*[Rr]ef"} do

more = nil

text = mw.ustring.gsub(text, "{{%s*" .. t .. "%s*|.-}}", "") -- remove ref and footnote templates

end

text = mw.ustring.gsub(text, "\n%s*{{%s*[Tt][Oo][Cc].-}}", "\n") -- remove most common tables of contents

-- Build the options for Module:Transcluder out of the template parameters and the desired defaults

local allparas = true -- keep all paragraphs?

iflocal options.paraflags then= {

files = files,

for _, v in pairs(options.paraflags) do

lists = lists,

if v then allparas = false end -- if any para specifically requested, don't keep all

tables = tables,

paragraphs = paragraphs,

sections = subsections,

categories = 0,

references = references,

only = only and mw.text.trim( only, 's' ) .. 's',

noLinks = noLinks,

noBold = noBold,

noSelfLinks = true,

noNonFreeFiles = onlyFreeFiles,

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

-- Fix birth and death dates, but only in the first paragraph

if briefDates then

local startpos = 1 -- skip initial templates

local s

local e = 0

repeat

startpos = e + 1

s, e = mw.ustring.find( excerpt, "%s*%b{}%s*", startpos )

until not s or s > startpos

s, e = mw.ustring.find( excerpt, "%b()", startpos ) -- get (...), which may be (year–year)

if s and s < startpos + 100 then -- look only near the start

local year1, conjunction, year2 = mw.ustring.match( mw.ustring.sub( excerpt, s, e ), '(%d%d%d+)(.-)(%d%d%d+)' )

if year1 and year2 and (mw.ustring.match( conjunction, '[%-–—]' ) or mw.ustring.match( conjunction, '{{%s*[sS]nd%s*}}' )) then

local y1 = tonumber(year1)

local y2 = tonumber(year2)

if y2 > y1 and y2 < y1 + 125 and y1 <= tonumber( os.date( "%Y" )) then

excerpt = mw.ustring.sub( excerpt, 1, s ) .. year1 .. "–" .. year2 .. mw.ustring.sub( excerpt, e )

end

end

end

end

-- aIf basicno parserfile was found, try to trimget one downfrom the leadinfobox

local fileNamespaces = Transcluder.getNamespaces( 'File' )

local inlead = false -- have we found some text yet?

if ( ( only == 'file' or only == 'files' ) or ( not only and ( files ~= '0' or not files ) ) ) and -- caller asked for files

local t = "" -- the stripped down output text

not Transcluder.matchAny( excerpt, '%[%[', fileNamespaces, ':' ) and -- and there are no files in Transcluder's output

local files = 0 -- how many [[Image: or [[File: so far

config.captions -- and we have the config option required to try finding files in templates

local paras = 0 -- how many paragraphs so far

then

-- We cannot distinguish the infobox from the other templates so we search them all

text = mw.ustring.gsub(text,"^%s*","") -- remove initial white space

local infobox = Transcluder.getTemplates( excerpt );

repeat -- loop around parsing a comment, template, image or paragraph

infobox = table.concat( infobox )

local token = mw.ustring.match(text, "^%s*<!%-%-.-%-%->%s*") -- <!--HTML comment-->

local parameters = Transcluder.getParameters( infobox )

or mw.ustring.match(text, "^%b{}%s*") or false -- or {{Template}}

local file, captions, caption, cssclasses, cssclass

if token then

for _, pair in pairs( config.captions ) do

if inlead then t = t .. token end -- keep comments and templates only within text body

file = pair[1]

else

file = parameters[file]

token = mw.ustring.match(text, "^%[%[%s*[Ff]ile%s*:") -- [[File: ...

if file and Transcluder.matchAny( file, '^.*%.', { '[Jj][Pp][Ee]?[Gg]', '[Pp][Nn][Gg]', '[Gg][Ii][Ff]', '[Ss][Vv][Gg]' }, '.*' ) then

or mw.ustring.match(text, "^%[%[%s*[Ii]mage%s*:") -- or [[Image: ...

file = mw.ustring.match( file, '%[?%[?.-:([^{|]+)%]?%]?' ) or file -- [[File:Example.jpg{{!}}upright=1.5]] to Example.jpg

if token then

captions = pair[2]

token = mw.ustring.match(text, "^%b[]%s*") -- match [[...]] to handle nesting

for _, p in pairs( captions ) do

files = files + 1

if options.fileflagsparameters[ andp options.fileflags[files] then tcaption = tparameters[ ..p ] tokenbreak end

else -- got a paragraph, which ends at a file, image, blank line or end of text

local afterend = mw.ustring.len(text) + 1

local blankpos = mw.ustring.find(text, "\n%s*\n") or afterend

local endpos = math.min(

mw.ustring.find(text, "%[%[%s*[Ff]ile%s*:") or afterend,

mw.ustring.find(text, "%[%[%s*[Ff]ile%s*:") or afterend,

blankpos)

token = mw.ustring.sub(text, 1, endpos-1)

if blankpos < afterend and blankpos == endpos then -- paragraph ends with a blank line

token = token .. mw.ustring.match(text, "\n%s*\n", blankpos)

end

inlead = true

paras-- =Check parasfor +CSS 1classes

-- We opt to use skin-invert-image instead of skin-invert

if allparas or (options.paraflags and options.paraflags[paras]) then t = t .. token end

-- in all other cases, the CSS provided in the infobox is used

if pair[3] then

cssclasses = pair[3]

for _, p in pairs(cssclasses) do

if parameters[p] then

cssclass = ((parameters[p] == 'skin-invert') and 'skin-invert-image' or parameters[p])

break

end

end

end

excerpt = '[[File:' .. file ..

(cssclass and ('|class=' .. cssclass) or '') ..

'|thumb|' .. (caption or '') .. ']]' .. excerpt

if ( onlyFreeFiles ) then

excerpt = Transcluder.removeNonFreeFiles( excerpt )

end

break

end

end

end

-- Unlike other elements, templates are filtered here

if token then text = mw.ustring.sub(text, mw.ustring.len(token)+1) end

-- because we had to search the infoboxes for files

until not text or text == "" or not token or token == ""

local trash

if only and ( only == 'template' or only == 'templates' ) then

text = mw.ustring.gsub(t, "\n+$", "") -- remove trailing line feeds, so "{{Transclude text excerpt|Foo}} more" flows on one line

trash, excerpt = Transcluder.getTemplates( excerpt, templates );

else -- Remove blacklisted templates

if options.more then text = text .. " '''[[" .. pagename .. "|" .. options.more .. "]]'''" end

local blacklist = config.blacklist and table.concat( config.blacklist, ',' ) or ''

return text

if templates then

end

if string.sub( templates, 1, 1 ) == '-' then --Unwanted templates. Append to blacklist

blacklist = templates .. ',' .. blacklist

-- Return blank text, or an error message if requested

else --Wanted templates. Replaces blacklist and acts as whitelist

function p.err(text, options)

blacklist = templates

if errors then error(text, 2) end

end

return ""

else

end

blacklist = '-' .. blacklist

-- Convert a comma-separated list of numbers or min-max ranges into a list of booleans, e.g. "1,3-5" → {1=true,2=false,3=true,4=true,5=true}

function p.numberflags(str)

local ranges = mw.text.split(str, ",") -- parse ranges, e.g. "1,3-5" → {"1","3-5"}

local flags = {}

for _, r in pairs(ranges) do

local min, max = mw.ustring.match(r, "^%s*(%d+)%s*%-%s*(%d+)%s*$") -- "3-5" → min=3 max=5

if not max then min, max = mw.ustring.match(r, "^%s*((%d+))%s*$") end -- "1" → min=1 max=1

if max then

for p = min, max do flags[p] = true end

end

trash, excerpt = Transcluder.getTemplates( excerpt, blacklist );

end

return flags

end

-- Remove extra line breaks but leave one before and after so the parser interprets lists, tables, etc. correctly

-- Shared template invocation code for lead and random functions

excerpt = mw.text.trim( excerpt )

function p.leadrandom(frame, israndom)

excerpt = string.gsub( excerpt, '\n\n\n+', '\n\n' )

-- args = { 1,2,... = page names, paragraphs = list e.g. "1,3-5", files = list, more = text}

excerpt = '\n' .. excerpt .. '\n'

local args = frame.args -- from calling module

local pargs = frame:getParent().args -- from template

-- Remove nested categories

excerpt = frame:preprocess( excerpt )

local categories, excerpt = Transcluder.getCategories( excerpt, options.categories )

-- Add tracking categories

local pagenames = { args[1] or pargs[1] } -- For lead, ignore all but the first unnamed argument

if israndomconfig.categories then

local contentCategory = config.categories.content

-- For random, accept any number of page names. If more than one, we'll pick one randomly

if contentCategory and mw.title.getCurrentTitle().isContentPage then

for i, p in pairs(args) do

excerpt = excerpt .. '[[Category:' .. contentCategory .. ']]'

if p and type(i) == 'number' and i > 1 then table.insert(pagenames, p) end

end

local namespaceCategory = config.categories[ mw.title.getCurrentTitle().namespace ]

for i, p in pairs(pargs) do

if namespaceCategory then

if p and type(i) == 'number' and i > 1 and not args[i] then table.insert(pagenames, p) end

excerpt = excerpt .. '[[Category:' .. namespaceCategory .. ']]'

end

end

-- Load the styles

local options = {}

local styles

options.paraflags = p.numberflags(args["paragraphs"] or pargs["paragraphs"] or "") -- parse paragraphs, e.g. "1,3-5" → {"1","3-5"}

if config.styles then

options.fileflags = p.numberflags(args["files"] or pargs["files"] or "") -- parse file numbers

styles = frame:extensionTag( 'templatestyles', '', { src = config.styles } )

options.more = args["more"] or pargs["more"]

end

if options.more and options.more == "" then options.more = "Read more..." end -- more= is short for this default text

options.errors = args["errors"] or pargs["errors"]

-- Combine and return the elements

local text = p._lead(pagenames, options)

if inline then

return frame:preprocess(text)

return mw.text.trim( excerpt )

end

local tag = 'div'

if quote then

tag = 'blockquote'

end

excerpt = mw.html.create( 'div' ):addClass( 'excerpt' ):wikitext( excerpt )

local block = mw.html.create( tag ):addClass( 'excerpt-block' ):addClass( class )

return block:node( styles ):node( hat ):node( excerpt ):node( more )

end

-- Entry points for templatebackwards callers using #invoke:compatibility

function p.lead( frame ) return p.leadrandommain( frame, false) end

function p.randomexcerpt( frame ) return p.leadrandommain( frame, true) end

return p