Módulo:Random slideshow – Wikipédia, a enciclopédia livre

Documentação do módulo[ver] [editar] [histórico] [purgar]

Este módulo está classificado como alfa. Ele está pronto para aceitar dados de terceiros, e pode ser utilizado em algumas páginas para ver se aparecem problemas, mas deve ser vigiado. Sugestões para novas funções ou alterações dos seus mecanismos de dados de entrada e saída são bem-vindas.

Este módulo depende dos seguintes outros módulos:

Esse módulo utiliza TemplateStyles^EN:

Módulo:Random slideshow/styles.css

Uso

{{#invoke:Random slideshow|main}}: Ver {{Random slideshow}} para detalhes.
{{#invoke:Random slideshow|transclui}}: Ver {{Transclude files as random slideshow}} para detalhes.

Este módulo também é utilizado pelo Módulo:Excerpt slideshow.

Ver também

A documentação acima é transcluída de Módulo:Random slideshow/doc.
Editores podem experimentar nas páginas de teste e de exemplos para testes deste módulo.
Subpáginas deste módulo.

-- Creates a slideshow gallery where the order is randomised. Intended for use on portal pages. local p = {} local excerptModule =  require('Module:Excerto/portais') local randomModule = require('Module:Random') local redirectModule = require('Module:Redirect')  function cleanupArgs(argsTable)     local cleanArgs = {}     for key, val in pairs(argsTable) do         if type(val) == 'string' then             val = val:match('^%s*(.-)%s*$')             if val ~= '' then                 cleanArgs[key] = val             end         else             cleanArgs[key] = val         end     end     return cleanArgs end  function normaliseCssMeasurement(input)     local suffix = string.reverse(string.sub(string.reverse(input), 1, 2))     if ( suffix == 'px' ) or ( suffix == 'em' ) or ( string.sub(suffix, 2, 2) == '%' ) then         return input     else         return input .. 'px'     end end  function isDeclined(val)     if not val then return false end     local declinedWords = " decline declined exclude excluded false none not no n off omit omitted remove removed não removido nenhum excluído falso"     return string.find(declinedWords , ' '..val..' ', 1, true ) and true or false end  function makeOutput(galleryLines, maxWidth, containerClassName, nonRandom)     local randomiseArgs = {    ['t'] = galleryLines }     local sortedLines = nonRandom and galleryLines or randomModule.main('array', randomiseArgs)     for i = 1, #sortedLines do         -- insert a switcher-label span just after the first pipe (which has already been escaped as {{!}} instead the | character)         sortedLines[i] = sortedLines[i]:gsub(             "%{%{%!%}%}",             '{{!}}<span class="switcher-label" style="display:none"><span class="randomSlideshow-sr-only">Image ' .. tostring(i) .. '</span></span>',             1)     end     local galleryContent = table.concat(sortedLines, '\n')     local output = '<div class="' .. containerClassName .. '" style="max-width:' .. normaliseCssMeasurement(maxWidth) .. '; margin:-4em auto;"><div class="nomobile"><!--intentionally empty on desktop, and is not present on mobile website (outside template namesapce)--></div>{{#tag:gallery|' .. galleryContent  .. '|mode=slideshow|class=switcher-container}}</div>'     return output end  function makeGalleryLine(file, caption, credit)     local title = mw.title.new(file, "File" )     if not title     then         return "File:Blank.png{{!}}{{Erro|File [[:File:" .. file .. "]] does not exist.}}"     end     local creditLine = ( credit and '<p><span style="font-size:88%">' .. credit .. '</span></p>' or '' )     return title.prefixedText .. '{{!}}' .. ( caption or '' ) .. creditLine end  function makeGalleryLinesTable(args)     local galleryLinesTable = {}     local i = 1     while args[i] do         table.insert(galleryLinesTable, makeGalleryLine(args[i], args[i+1], args['credit' .. (i+1)/2]))         i = i + 2     end     return galleryLinesTable end  function hasCaption(line)     local caption = mw.ustring.match(line, ".-{{!}}(.*)")     -- require caption to exist with more than 5 characters (avoids sizes etc being mistaken for captions)     return caption and #caption>5 and true or false end  function extractGalleryFiles(wikitext)     local gallery = mw.ustring.match(wikitext, '<gallery.->%s*(.-)%s*</gallery>')     if not gallery then         return false     end     gallery = mw.ustring.gsub(gallery, '|', '{{!}}')     return mw.text.split(gallery, '%c') end  function extractRegularFiles(wikitext)     local files = {}     local frame = mw.getCurrentFrame()     local expand = function(template)         return frame:preprocess(template)     end     for file in mw.ustring.gmatch(wikitext, '%b[]' ) do         -- remove keywords that don't work in galleries         file = mw.ustring.gsub(file, '|%s*thumb%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*thumbnail%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*border%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*left%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*right%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*center%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*centre%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*baseline%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*sub%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*super%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*top%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*text%-top%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*bottom%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*text%-bottom%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*framed?%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*frameless%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*upright%s*[0-9%.]*%s*([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*upright%s*=.-([|%]])', '%1')         file = mw.ustring.gsub(file, '|%s*link%s*=.-([|%]])', '%1')         -- remove spaces prior to captions (which cause pre-formatted text)         file = mw.ustring.gsub(file, '|%s*', '|')         -- remove sizes, which sometimes get mistaken for captions         file = mw.ustring.gsub(file, '|%s*%d*x?%d+%s*px%s*([|%]])', '%1')         -- expand templates         file = mw.ustring.gsub(file, '{%b{}}', expand)         -- remove loose closing braces which don't have matching opening braces         file = mw.ustring.gsub(file, '}}', '')         -- remove loose opening braces which don't have matching closing braces (and the subsequent content, which is probably just a template name)         file = mw.ustring.gsub(file, '{{.-([|%]])', '$1')         -- replace pipes and equals (which would otherwise break the {{#tag:}} syntax)         file = mw.ustring.gsub(file, '|%s*alt%s*=', '{{! }}alt=')         file = mw.ustring.gsub(file, '|', '{{!}}')         file = mw.ustring.gsub(file, '=', '{{=}}')         -- remove linebreaks         file = mw.ustring.gsub(file, '\n\n', '<br>')         file = mw.ustring.gsub(file, '\n', '')         -- remove surrounding square brackets         file = mw.ustring.gsub(file, '^%[%[', '')         file = mw.ustring.gsub(file, '%]%]$', '')         table.insert(files, file)     end     return files end  function makeTranscludedGalleryLinesTables(args)     local namespaceNumber = function(pagetitle)         local titleObject = mw.title.new(pagetitle)         return titleObject and titleObject.namespace     end     local lines = {}     local i = 1     while args[i] do         if namespaceNumber(args[i]) == 6 then -- file namespace             -- args[i] is either just the filename, or uses syntax File:Name.jpg##Caption##Credit             local parts = mw.text.split(args[i], '##%s*')             local filename = parts[1]             local caption = args['caption'..i] or parts[2] or false             local credit = args['credit'..i] or parts[3] or false             local line = makeGalleryLine(filename, caption, credit)             table.insert(lines, line)         else             local content, pagename = excerptModule.getContent(args[i])             if not pagename then                 return error('Cannot read a valid page for "' .. args[i] .. '"', 0)             elseif not content then                 return error('No content found on page "' .. args[i] .. '"', 0)             end             if args['section'..i] then                 content = excerptModule.getSection(content, args['section'..i]) or ''             end             content = excerptModule.cleanupText(content, {keepSubsections=true}) -- true means keep subsections                 local galleryFiles = extractGalleryFiles(content)             if galleryFiles then                 for _, f in pairs(galleryFiles) do                     if hasCaption(f) then                         local filename = string.gsub(f, '{{!}}.*', '')                         local isOkay = excerptModule.checkImage(filename)                         if isOkay then                             table.insert(lines, f.." (from '''[["..pagename.."]]''')")                         end                     end                 end             end                 local otherFiles = excerptModule.parse(content, {fileflags="1-100", filesOnly=true})             if otherFiles then                 for _, f in pairs(extractRegularFiles(otherFiles)) do                     if f and f ~= '' and mw.ustring.sub(f, 1, 5) == 'File:' and hasCaption(f) then                         table.insert(lines, f.." (from '''[["..pagename.."]]''')")                     end                 end             end                 end         i = i + 1     end     return ( #lines > 0 ) and lines or error('No images found') end  p._main = function(args, transclude, extraClassName)     if not args[1] then         return error(linked and 'No page specified' or 'No page specified', 0)     end     local lines = transclude and makeTranscludedGalleryLinesTables(args) or makeGalleryLinesTable(args)     local classNames = 'randomSlideshow-container'     if extraClassName then classNames = classNames .. ' ' .. extraClassName end     return makeOutput(lines, args.width or '100%', classNames, isDeclined(args.random)) end  p.main = function(frame)     local parent = frame.getParent(frame)     local parentArgs = parent.args     local args = cleanupArgs(parentArgs)     local output = p._main(args, false)     return frame:extensionTag{ name='templatestyles', args = { src='Module:Random slideshow/styles.css'} }         .. frame:preprocess(output) end  p.transclude = function(frame)     local parent = frame.getParent(frame)     local parentArgs = parent.args     local args = cleanupArgs(parentArgs)     local output = p._main(args, true)     return frame:extensionTag{ name='templatestyles', args = { src='Module:Random slideshow/styles.css'} }         .. frame:preprocess(output) end  return p

v d e Predefinições de Portal
Esquema e formatação	{{Box-header_portal}} versões de palete de cor plain round square watch {{Box-header colour}}¹ {{Box-footer portal}} {{Colunas flex}} {{Plain navboxes}} {{Marco 3D}} {{Base de portal}}
Transclusão de conteúdo	{{Transclude lead excerpt}}² {{Transclude random excerpt}}² {{Transclude selected excerpt}}² {{Transclude linked excerpt}}² {{Transclude list item excerpt}}² {{Transclude selected current events}}³ {{Transclude selected recent additions}}⁴ {{Transclude DYK}}⁹ {{Excerto}}
Slideshows de conteúdo	{{Random slideshow}}⁵ {{Transclude files as random slideshow}}⁵ {{Transclude excerpts as random slideshow}}⁶ {{Transclude linked excerpts as random slideshow}}⁶ {{Transclude list item excerpts as random slideshow}}⁶
Randomização de conteúdo	{{Random quotation}} {{Random portal component}}⁷ {{Random subpágina}}
Geral	{{Portais1}} {{Portals browsebar}} {{Portal description}} {{WikimediaForPortals}} {{Portal navbar no header2}} {{Portal information sidebar}} Portal:Esqueleto de caixa de portal modelo
Predefinições de ligacões	{{Portal}} {{Portal-inline}}¹¹ {{Barra de portal}} {{Portal3}}
Páginas de discussão / Manutenção	{{Discussão portal}}
Imagens	{{Portal dynamic image}} {{Portal image banner}}¹⁰ {{Portal pictures}} {{Portal POTD}}
Módulos	¹Módulo:Box-header ²Módulo:Excerpt ³Módulo:Selected current events ⁴Módulo:Selected recent additions ⁵Módulo:Random slideshow ⁶Módulo:Excerpt slideshow ⁷Módulo:Random portal component ⁸Módulo:Portal maintenance status ⁹Módulo:Transclude DYK ¹⁰Módulo:Portal image banner ¹¹Módulo:Portal-inline ¹² Módulo:Portal pictures
Uso	Wikipédia:Portal
Para mais informações veja: Wikipédia:Projetos/Portais · Ver também: `Categoria:!Predefinições de configurações de portais` e `Categoria:!Predefinições de portais`