ماڊيول:InfoboxImage
ڏيک
سانچو:استعمال ٿيل نظام ۾ سانچو:ماڊيول درجه بندي
| This module depends on the following other modules: |
جائزو
[سنواريو]هي ماڊيول انفوباڪس اندر استعمال ڪيو ويندو آهي ته جيئن تصوير سان لاڳاپيل پيرا ميٽرن کي پروسيس ڪري ۽ نتيجي جي ترتيب کي صاف ۽ منظم بڻائي.
پيرا ميٽر
[سنواريو]| پيرا ميٽر | وضاحت |
|---|---|
| image | لازمي. اهو بنيادي پيرا ميٽر آهي جنهن ۾ تصوير بابت معلومات ڏني ويندي آهي. |
| size | تصوير ڏيکارڻ لاءِ سائيز (پڪسلز ۾). هن جو استعمال WP:THUMBSIZE موجب گهٽ ڪرڻ جي صلاح ڏني وڃي ٿي؛ ان جي بدران |upright= استعمال ڪرڻ بهتر آهي.
|
| maxsize | تصوير ڏيکارڻ لاءِ وڌ ۾ وڌ سائيز. جيڪڏهن size يا sizedefault پيرا ميٽر نه ڏنا وڃن ته تصوير maxsize مطابق ڏيکاري ويندي. |
| sizedefault | جيڪڏهن size نه ڏنو وڃي ته تصوير لاءِ هي ڊيفالٽ سائيز استعمال ٿيندي. ڊيفالٽ طور frameless هوندي آهي. |
| alt | تصوير لاءِ متبادل متن (alt text). |
| title | تصوير لاءِ عنواني متن (ماؤس آڻڻ وقت ڏيکاريل متن). |
| border | جيڪڏهن yes هجي ته تصوير جي چوڌاري بارڊر شامل ڪيو ويندو. |
| page | گهڻ صفحن واري تصوير استعمال ٿيڻ وقت صفحي جو نمبر. |
| upright | جيڪڏهن upright=yes هجي ته تصوير ڊيفالٽ سائيز جي لڳ ڀڳ 75٪ تي ڏيکاربي (جيڪو عام طور 250px هوندو آهي جيڪڏهن Special:Preferences ۾ تبديل نه ڪيو ويو هجي). جيڪڏهن عدد ڏنو وڃي ته تصوير ان تناسب سان وڏي يا ننڍي ٿيندي. |
| center | جيڪڏهن yes هجي ته تصوير کي وچ تي ڏيکاريو ويندو. |
| thumbtime | وڊيو ڪلپس لاءِ استعمال ٿيندڙ thumbtime پيرا ميٽر. |
| suppressplaceholder | جيڪڏهن no هجي ته ڪجهه placeholder تصويرن کي لڪائڻ وارو عمل لاڳو نه ٿيندو. |
| link | تصوير تي ڪلڪ ڪرڻ سان کلي ويندڙ صفحو. |
| class | تصوير ۾ شامل ڪرڻ لاءِ HTML ڪلاسز. |
نوٽ: جيڪڏهن maxsize يا sizedefault پيرا ميٽر استعمال ڪيو وڃي ته عدد کان پوءِ px ضرور لکڻ گهرجي.
تصويري سنٽيڪس ۾ ڏيکاريل پيرا ميٽر
[سنواريو]سڀ پيرا ميٽر:
{{#invoke:InfoboxImage | InfoboxImage
| image={{{image}}}
| size={{{size}}}
| maxsize={{{maxsize}}}
| sizedefault={{{sizedefault}}}
| upright={{{upright}}}
| alt={{{alt}}}
| title={{{title}}}
| thumbtime={{{thumbtime}}}
| link={{{link}}}
| border=yes
| center=yes
| page={{{page}}}
| class={{{class}}}
}}
نمونو استعمال
[سنواريو]|image = {{#invoke:InfoboxImage|InfoboxImage
|image={{{image|}}}
|upright={{{image_upright|1}}}
|alt={{{alt|}}}
}}
پليس ھولڊر تصويرون جيڪي لڪائي سگهجن ٿيون
[سنواريو]- File:Blue - replace this image female.svg
- File:Blue - replace this image male.svg
- File:Image is needed female.svg
- File:Image is needed male.svg
- File:No portrait.svg
- File:No image available.png
- File:UploadAnImage.svg
- File:Replace this image.svg
- File:No Screenshot.svg
- File:Placeholder barnstar ribbon.png
- File:Project Trains no image.png
- File:Insert image here.svg
- File:No Photo Available.svg
- File:NO IMAGE YET.png
ٽريڪنگ زمرا
[سنواريو]- Category:Pages using infoboxes with thumbnail images (24)
- Category:Pages using infoboxes with URL in image parameter (4)
-- Inputs:
-- image - Can either be a bare filename (with or without the File:/Image: prefix) or a fully formatted image link
-- page - page to display for multipage images (DjVu)
-- size - size to display the image
-- maxsize - maximum size for image
-- sizedefault - default size to display the image if size param is blank
-- alt - alt text for image
-- title - title text for image
-- border - set to yes if border
-- center - set to yes, if the image has to be centered
-- upright - upright image param
-- suppressplaceholder - if yes then checks to see if image is a placeholder and suppresses it
-- link - page to visit when clicking on image
-- class - HTML classes to add to the image
-- Outputs:
-- Formatted image.
-- More details available at the "Module:InfoboxImage/doc" page
local i = {}
-- List of placeholder images and tracking categories stored in [[Module:InfoboxImage/data]]
-- Other constants:
-- the system-wide default thumbnail size (in px)
local defaultThumbnailSize = 250
-- If page is not a user page, return tracking category. Else return empty.
local function trackingCat(cat)
local ns = mw.title.getCurrentTitle().nsText:lower()
local categories = mw.loadData('Module:InfoboxImage/data').categories
return (ns ~= 'user' and ns ~= 'user talk' and categories[cat]) or ""
end
-- Determine whether image is a placeholder
function i.IsPlaceholder(image)
-- change underscores to spaces
image = mw.ustring.gsub(image, "_", " ");
assert(image ~= nil, 'mw.ustring.gsub(image, "_", " ") must not return nil')
-- if image starts with [[ then remove that and anything after |
if mw.ustring.sub(image,1,2) == "[[" then
image = mw.ustring.sub(image,3);
image = mw.ustring.gsub(image, "([^|]*)|.*", "%1");
assert(image ~= nil, 'mw.ustring.gsub(image, "([^|]*)|.*", "%1") must not return nil')
end
-- Trim spaces
image = mw.ustring.gsub(image, '^[ ]*(.-)[ ]*$', '%1');
assert(image ~= nil, "mw.ustring.gsub(image, '^[ ]*(.-)[ ]*$', '%1') must not return nil")
-- remove prefix if exists
local allNames = mw.site.namespaces[6].aliases
allNames[#allNames + 1] = mw.site.namespaces[6].name
allNames[#allNames + 1] = mw.site.namespaces[6].canonicalName
for i, name in ipairs(allNames) do
if mw.ustring.lower(mw.ustring.sub(image, 1, mw.ustring.len(name) + 1)) == mw.ustring.lower(name .. ":") then
image = mw.ustring.sub(image, mw.ustring.len(name) + 2);
break
end
end
-- Trim spaces
image = mw.ustring.gsub(image, '^[ ]*(.-)[ ]*$', '%1');
-- capitalise first letter
image = mw.ustring.upper(mw.ustring.sub(image,1,1)) .. mw.ustring.sub(image,2);
local placeholder_image = mw.loadData('Module:InfoboxImage/data').placeholder_image
return placeholder_image[image]
end
local function isempty(x)
return (not x) or x == ""
end
-- Main entry point
function i.InfoboxImage(frame)
local image = frame.args["image"];
if isempty(image) then
return "";
end
if image == " " then
return image;
end
if frame.args["suppressplaceholder"] ~= "no" then
if i.IsPlaceholder(image) == true then
return "";
end
end
if string.find(image, "^%[*https?:") then
-- Error category.
return trackingCat("url_image_links")
end
if mw.ustring.sub(image,1,2) == "[[" then
-- search for thumbnail images and add to tracking cat if found
local cat = "";
if mw.title.getCurrentTitle().namespace == 0 and (mw.ustring.find(image, "|%s*thumb%s*[|%]]") or mw.ustring.find(image, "|%s*thumbnail%s*[|%]]")) then
cat = trackingCat("thumbnail_images")
end
return image .. cat;
elseif mw.ustring.sub(image,1,2) == "{{" and mw.ustring.sub(image,1,3) ~= "{{{" then
return image;
elseif mw.ustring.sub(image,1,1) == "<" then
return image;
elseif mw.ustring.sub(image,1,8) == mw.ustring.char(127).."'\"`UNIQ" then
-- Found strip marker at begining, so pass don't process at all
return image;
else
local result = "";
local page = frame.args["page"];
local upright = frame.args["upright"] or ""
local size = frame.args["size"];
local maxsize = frame.args["maxsize"];
local sizedefault = frame.args["sizedefault"];
local alt = frame.args["alt"];
local link = frame.args["link"];
local title = frame.args["title"];
local border = frame.args["border"];
local thumbtime = frame.args["thumbtime"] or "";
local center = frame.args["center"];
local class = frame.args["class"];
-- remove prefix if exists
local allNames = mw.site.namespaces[6].aliases
allNames[#allNames + 1] = mw.site.namespaces[6].name
allNames[#allNames + 1] = mw.site.namespaces[6].canonicalName
for i, name in ipairs(allNames) do
if mw.ustring.lower(mw.ustring.sub(image, 1, mw.ustring.len(name) + 1)) == mw.ustring.lower(name .. ":") then
image = mw.ustring.sub(image, mw.ustring.len(name) + 2);
break
end
end
if not isempty(maxsize) then
-- if no sizedefault nor upright, then set to maxsize
if isempty(sizedefault) and isempty(upright) then
sizedefault = maxsize
end
-- check to see if size bigger than maxsize
local maxsizenumber = tonumber(mw.ustring.match(maxsize,"%d*")) or 0;
if not isempty(size) then
local sizenumber = tonumber(mw.ustring.match(size,"%d*")) or 0;
if sizenumber > maxsizenumber and maxsizenumber > 0 then
size = maxsize;
end
end
-- check to see if upright bigger than maxsize (at default preferred size)
if not isempty(upright) then
local uprightnumber = tonumber(upright) or (upright == "yes" and 0.75) or 0
if uprightnumber*defaultThumbnailSize > maxsizenumber and maxsizenumber > 0 then
upright = tostring(maxsizenumber/defaultThumbnailSize)
end
end
end
-- add px to size if just a number
if (tonumber(size) or 0) > 0 then
size = size .. "px";
end
-- add px to sizedefault if just a number
if (tonumber(sizedefault) or 0) > 0 then
sizedefault = sizedefault .. "px";
end
result = "[[File:" .. image;
if not isempty(page) then
result = result .. "|page=" .. page;
end
if not isempty(size) then
result = result .. "|" .. size;
elseif not isempty(sizedefault) and isempty(upright) then
result = result .. "|" .. sizedefault;
else
result = result .. "|frameless";
end
if center == "yes" then
result = result .. "|center"
end
if not isempty(alt) then
result = result .. "|alt=" .. alt;
end
if not isempty(link) then
result = result .. "|link=" .. link;
end
if border == "yes" then
result = result .. "|border";
end
if upright == "yes" then
result = result .. "|upright";
elseif upright ~= "" then
result = result .. "|upright=" .. upright;
end
if thumbtime ~= "" then
result = result .. "|thumbtime=" .. thumbtime;
end
if not isempty(class) then
result = result .. "|class=" .. class;
end
-- if alt value is a keyword then do not use as a description
if alt == "thumbnail" or alt == "thumb" or alt == "frameless" or alt == "left" or alt == "center" or alt == "right" or alt == "upright" or alt == "border" or mw.ustring.match(alt or "", '^[0-9]*px$', 1) ~= nil then
alt = nil;
end
if not isempty(title) then
-- does title param contain any templatestyles? If yes then set to blank.
if mw.ustring.match(frame:preprocess(title), 'UNIQ%-%-templatestyles', 1) ~= nil then
title = nil;
end
end
if not isempty(title) then
result = result .. "|" .. title;
end
result = result .. "]]";
return result;
end
end
return i;