پاورپوینت کامل پودمان:Documentation 120 اسلاید در PowerPoint

توجه : این فایل به صورت فایل power point (پاور پوینت) ارائه میگردد

 پاورپوینت کامل پودمان:Documentation 120 اسلاید در PowerPoint دارای ۱۲۰ اسلاید می باشد و دارای تنظیمات کامل در PowerPoint می باشد و آماده ارائه یا چاپ است

شما با استفاده ازاین پاورپوینت میتوانید یک ارائه بسیارعالی و با شکوهی داشته باشید و همه حاضرین با اشتیاق به مطالب شما گوش خواهند داد.

لطفا نگران مطالب داخل پاورپوینت نباشید، مطالب داخل اسلاید ها بسیار ساده و قابل درک برای شما می باشد، ما عالی بودن این فایل رو تضمین می کنیم.

توجه : در صورت  مشاهده  بهم ریختگی احتمالی در متون زیر ،دلیل ان کپی کردن این مطالب از داخل فایل می باشد و در فایل اصلی پاورپوینت کامل پودمان:Documentation 120 اسلاید در PowerPoint،به هیچ وجه بهم ریختگی وجود ندارد

بخشی از متن پاورپوینت کامل پودمان:Documentation 120 اسلاید در PowerPoint :

توضیحات این پودمان می‌تواند در پودمان:Documentation/توضیحات قرار گیرد.

— برای فارسی‌سازی بهتر، بعضی از قسمت‌های این پودمان تغییر کرده‌است. لطفاً هنگام به‌روزرسانی به توضیحات پودمان توجه کنید.
— This module implements {{documentation}}.

— Get required modules.
local getArgs = require('Module:Arguments').getArgs
local messageBox = require('Module:Message box')

— Get the config table.
local cfg = mw.loadData('Module:Documentation/config')

local p = {}

— Often-used functions.
local ugsub = mw.ustring.gsub

—————————————————————————-
— Helper functions
—
— These are defined as local functions, but are made available in the p
— table for testing purposes.
—————————————————————————-

local function message(cfgKey, valArray, expectType)
–[[
— Gets a message from the cfg table and formats it if appropriate.
— The function raises an error if the value from the cfg table is not
— of the type expectType. The default type for expectType is 'string'.
— If the table valArray is present, strings such as $1, $2 etc. in the
— message are substituted with values from the table keys [1], [2] etc.
— For example, if the message "foo-message" had the value 'Foo $2 bar $1.',
— message('foo-message', {'baz', 'qux'}) would return "Foo qux bar baz."
–]]
local msg = cfg[cfgKey]
expectType = expectType or 'string'
if type(msg) ~= expectType then
error('پیام: خطای نوع در متن cfg.' .. cfgKey .. ' (' .. expectType .. ' انتظار می‌رفت، ' .. type(msg) .. ' بدست آمد)', ۲)
end
if not valArray then
return msg
end

local function getMessageVal(match)
match = tonumber(match)
— برای فارسی‌سازی بهتر، ساختار خطای نمایشی خط زیر تغییر کرده‌است
return valArray[match] or error('پیام: هیچ مقداری برای کلید $' .. match .. ' در متن cfg.' .. cfgKey .. ' یافت نشد', ۴)
end

local ret = ugsub(msg, '$([1-9][0-9]*)', getMessageVal)
return ret
end

p.message = message

local function makeWikilink(page, display)
if display then
return mw.ustring.format('[[%s|%s]]', page, display)
else
return mw.ustring.format('[[%s]]', page)
end
end

p.makeWikilink = makeWikilink

local function makeCategoryLink(cat, sort)
local catns = mw.site.namespaces[14].name
return makeWikilink(catns .. ':' .. cat, sort)
end

p.makeCategoryLink = makeCategoryLink

local function makeUrlLink(url, display)
return mw.ustring.format('[%s %s]', url, display)
end

p.makeUrlLink = makeUrlLink

local function makeToolbar(…)
local ret = {}
local lim = select('#', …)
if lim < 1 then
return nil
end
for i = 1, lim do
ret[#ret + 1] = select(i, …)
end
return '<small style="font-style: normal;">(' .. table.concat(ret, ' &#124; ') .. ')</small>'
end

p.makeToolbar = makeToolbar

—————————————————————————-
— Argument processing
—————————————————————————-

local function makeInvokeFunc(funcName)
return function (frame)
local args = getArgs(frame, {
valueFunc = function (key, value)
if type(value) == 'string' then
value = value:match('^%s*(.-)%s*$') — Remove whitespace.
if key == 'heading' or value ~= '' then
return value
else
return nil
end
else
return value
end
end
})
return p[funcName](args)
end
end

—————————————————————————-
— Main function
—————————————————————————-

p.main = makeInvokeFunc('_main')

function p._main(args)
–[[
— This function defines logic flow for the module.
— @args – table of arguments passed by the user
—
— Messages:
— 'main-div-id' –> 'template-documentation'
— 'main-div-classes' –> 'template-documentation iezoomfix'
–]]
local env = p.getEnvironment(args)
local root = mw.html.create()
root
:wikitext(p.protectionTemplate(env))
:wikitext(p.sandboxNotice(args, env))
— This div tag is from {{documentation/start box}}, but moving it here
— so that we don't have to worry about unclosed tags.
:tag('div')
:attr('id', message('main-div-id'))
:addClass(message('main-div-classes'))
:newline()
:wikitext(p._startBox(args, env))
:wikitext(p._content(args, env))
:tag('div')
:css('clear', 'both') — So right or left floating items don't stick out of the doc box.
:newline()
:done()
:done()
:wikitext(p._endBox(args, env))
:wikitext(p.addTrackingCategories(env))
return tostring(root)
end

—————————————————————————-
— Environment settings
—————————————————————————-

function p.getEnvironment(args)
–[[
— Returns a table with information about the environment, including title objects and other namespace- or
— path-related data.
— @args – table of arguments passed by the user
—
— Title objects include:
— env.title – the page we are making documentation for (usually the current title)
— env.templateTitle – the template (or module, file, etc.)
— env.docTitle – the /doc subpage.
— env.sandboxTitle – the /sandbox subpage.
— env.testcasesTitle – the /testcases subpage.
— env.printTitle – the print version of the template, located at the /Print subpage.
—
— Data includes:
— env.protectionLevels – the protection levels table of the title object.
— env.subjectSpace – the number of the title's subject namespace.
— env.docSpace – the number of the namespace the title puts its documentation in.
— env.docpageBase – the text of the base page of the /doc, /sandbox and /testcases pages, with namespace.
— env.compareUrl – URL of the Special:ComparePages page comparing the sandbox with the template.
—
— All table lookups are passed through pcall so that errors are caught. If an error occurs, the value
— returned will be nil.
–]]

local env, envFuncs = {}, {}

— Set up the metatable. If triggered we call the corresponding function in the envFuncs table. The value
— returned by that function is memoized in the env table so that we don't call any of the functions
— more than once. (Nils won't be memoized.)
setmetatable(env, {
__index = function (t, key)
local envFunc = envFuncs[key]
if envFunc then
local success, val = pcall(envFunc)
if success then
env[key] = val — Memoise the value.
return val
end
end
return nil
end
})

function envFuncs.title()
— The title object for the current page, or a test page passed with args.page.
local title
local titleArg = args.page
if titleArg then
title = mw.title.new(titleArg)
else
title = mw.title.getCurrentTitle()
end
return title
end

function envFuncs.templateTitle()
–[[
— The template (or module, etc.) title object.
— Messages:
— 'sandbox-subpage' –> 'sandbox'
— 'testcases-subpage' –> 'testcases'
–]]
local subjectSpace = env.subjectSpace
local title = env.title
local subpage = title.subpageText
if subpage == message('sandbox-subpage') or subpage == message('testcases-subpage') then
return mw.title.makeTitle(subjectSpace, title.baseText)
else
return mw.title.makeTitle(subjectSpace, title.text)
end
end

function envFuncs.docTitle()
–[[
— Title object of the /doc subpage.
— Messages:
— 'doc-subpage' –> 'doc'
–]]
local title = env.title
local docname = args[1] — User-specified doc page.
local docpage
if docname then
docpage = docname
else
docpage = env.docpageBase .. '/' .. message('doc-subpage')
end
return mw.title.new(docpage)
end

function envFuncs.sandboxTitle()
–[[
— Title object for the /sandbox subpage.
— Messages:
— 'sandbox-subpage' –> 'sandbox'
–]]
return mw.title.new(env.docpageBase .. '/' .. message('sandbox-subpage'))
end

function envFuncs.testcasesTitle()
–[[
— Title object for the /testcases subpage.
— Messages:
— 'testcases-subpage' –> 'testcases'
–]]
return mw.title.new(env.docpageBase .. '/' .. message('testcases-subpage'))
end

function envFuncs.printTitle()
–[[
— Title object for the /Print subpage.
— Messages:
— 'print-subpage' –> 'Print'
–]]
return env.templateTitle:subPageTitle(message('print-subpage'))
end

function envFuncs.protectionLevels()
— The protection levels table of the title object.
return env.title.protectionLevels
end

function envFuncs.subjectSpace()
— The subject namespace number.
return mw.site.namespaces[env.title.namespace].subject.id
end

function envFuncs.docSpace()
— The documentation namespace number. For most namespaces this is the same as the
— subject namespace. However, pages in the Article, File, MediaWiki or Category
— namespaces must have their /doc, /sandbox and /testcases pages in talk space.
local subjectSpace = env.subjectSpace
if subjectSpace == 0 or subjectSpace == 6 or subjectSpace == 8 or subjectSpace == 14 then
return subjectSpace + 1
else
return subjectSpace
end
end

function envFuncs.docpageBase()
— The base page of the /doc, /sandbox, and /testcases subpages.
— For some namespaces this is the talk page, rather than the template page.
local templateTitle = env.templateTitle
local docSpace = env.docSpace
local docSpaceText = mw.site.namespaces[docSpace].name
— Assemble the link. docSpace is never the main namespace, so we can hardcode the colon.
return docSpaceText .. ':' .. templateTitle.text
end

function envFuncs.compareUrl()
— Diff link between the sandbox and the main template using [[Special:ComparePages]].
local templateTitle = env.templateTitle
local sandboxTitle = env.sandboxTitle
if templateTitle.exists and sandboxTitle.exists then
local compareUrl = mw.uri.fullUrl(
'ویژه:مقایسه صفحات',
{page1 = templateTitle.prefixedText, page2 = sandboxTitle.prefixedText}
)
return tostring(compareUrl)
else
return nil
end
end

return env
end

—————————————————————————-
— Auxiliary templates
—————————————————————————-

function p.sandboxNotice(args, env)
–[=[
— Generates a sandbox notice for display above sandbox pages.
— @args – a table of arguments passed by the user
— @env – environment table containing title objects, etc., generated with p.getEnvironment
—
— Messages:
— 'sandbox-notice-image' –> '[[Image:Sandbox.svg|50px|alt=|link=]]'
— 'sandbox-notice-blurb' –> 'This is the $1 for $2.'
— 'sandbox-notice-diff-blurb' –> 'This is the $1 for $2 ($3).'
— 'sandbox-notice-pagetype-template' –> '[[Wikipedia:Template test cases|template sandbox]] page'
— 'sandbox-notice-pagetype-module' –> '[[Wikipedia:Template test cases|module sandbox]] page'
— 'sandbox-notice-pagetype-other' –> 'sandbox page'
— 'sandbox-notice-compare-link-display' –> 'diff'
— 'sandbox-notice-testcases-blurb' –> 'See also the companion subpage for $1.'
— 'sandbox-notice-testcases-link-display' –> 'test cases'
— 'sandbox-category' –> 'Template sandboxes'
–]=]
local title = env.title
local sandboxTitle = env.sandboxTitle
local templateTitle = env.templateTitle
local subjectSpace = env.subjectSpace
if not (subjectSpace and title and sandboxTitle and templateTitle and mw.title.equals(title, sandboxTitle)) then
return nil
end
— Build the table of arguments to pass to {{ombox}}. We need just two fields, "image" and "text".
local omargs = {}
omargs.image = message('sandbox-notice-image')
— Get the text. We start with the opening blurb, which is something like
— "This is the template sandbox for [[Template:Foo]] (diff)."
local text = ''
local pagetype
if subjectSpace == 10 then
pagetype = message('sandbox-notice-pagetype-template')
elseif subjectSpace == 828 then
pagetype = message('sandbox-notice-pagetype-module')
else
pagetype = message('sandbox-notice-pagetype-other')
end
local templateLink = makeWikilink(templateTitle.prefixedText)
local compareUrl = env.compareUrl
if compareUrl then
local compareDisplay = message('sandbox-notice-compare-link-display')
local compareLink = makeUrlLink(compareUrl, compareDisplay)
text = text .. message('sandbox-notice-diff-blurb', {pagetype, templateLink, compareLink})
else
text = text .. message('sandbox-notice-blurb', {pagetype, templateLink})
end
— Get the test cases page blurb if the page exists. This is something like
— "See also the companion subpage for [[Template:Foo/testcases|test cases]]."
local testcasesTitle = env.testcasesTitle
if testcasesTitle and testcasesTitle.exists then
if testcasesTitle.namespace == mw.site.namespaces.Module.id then
local testcasesLinkDisplay = message('sandbox-notice-testcases-link-display')
local testcasesRunLinkDisplay = message('sandbox-notice-testcases-run-link-display')
local testcasesLink = makeWikilink(testcasesTitle.prefixedText, testcasesLinkDisplay)
local testcasesRunLink = makeWikilink(testcasesTitle.talkPageTitle.prefixedText, testcasesRunLinkDisplay)
text = text .. '<br />' .. message('sandbox-notice-testcases-run-blurb', {testcasesLink, testcasesRunLink})
else
local testcasesLinkDisplay = message('sandbox-notice-testcases-link-display')
local testcasesLink = makeWikilink(testcasesTitle.prefixedText, testcasesLinkDisplay)
text = text .. '<br />' .. message('sandbox-notice-testcases-blurb', {testcasesLink})
end
end
— Add the sandbox to the sandbox category.
text = text .. makeCategoryLink(message('sandbox-category'))
omargs.text = text
local ret = '<div style="clear: both;"></div>'
ret = ret .. messageBox.main('ombox', omargs)
return ret
end

function p.protectionTemplate(env)
— Generates the padlock icon in the top right.
— @env – environment table containing title objects, etc., generated with p.getEnvironment
— Messages:
— 'protection-template' –> 'pp-template'
— 'protection-template-args' –> {docusage = 'yes'}
local protectionLevels, mProtectionBanner
local title = env.title
protectionLevels = env.protectionLevels
if not protectionLevels then
return nil
end
local editProt = protectionLevels.edit and protectionLevels.edit[1]
local moveProt = protectionLevels.move and protectionLevels.move[1]
if editProt then
— The page is edit-protected.
mProtectionBanner = require('Module:Protection banner')
local reason = message('protection-reason-edit')
return mProtectionBanner._main{reason, small = true}
elseif moveProt and moveProt ~= 'autoconfirmed' then
— The page is move-protected but not edit-protected. Exclude move
— protection with the level "autoconfirmed", as this is equivalent to
— no move protection at all.
mProtectionBanner = require('Module:Protection banner')
return mProtectionBanner._main{action = 'move', small = true}
else
return nil
end
end

—————————————————————————-
— Start box
—————————————————————————-

p.startBox = makeInvokeFunc('_startBox')

function p._startBox(args, env)
–[[
— This function generates the start box.
— @args – a table of arguments passed by the user
— @env – environment table containing title objects, etc., generated with p.getEnvironment
—
— The actual work is done by p.makeStartBoxLinksData and p.renderStartBoxLinks which make
— the [view] [edit] [history] [purge] links, and by p.makeStartBoxData and p.renderStartBox
— which generate the box HTML.
–]]
env = env or p.getEnvironment(args)
local links
local content = args.content
if not content then
— No need to include the links if the documentation is on the template page itself.
local linksData = p.makeStartBoxLinksData(args, env)
if linksData then
links = p.renderStartBoxLinks(linksData)
end
end
— Generate the start box html.
local data = p.makeStartBoxData(args, env, links)
if data then
return p.renderStartBox(data)
else
— User specified no heading.
return nil
end
end

function p.makeStartBoxLinksData(args, env)
–[[
— Does initial processing of data to make the [view] [edit] [history] [purge] links.
— @args – a table of arguments passed by the user
— @env – environment table containing title objects, etc., generated with p.getEnvironment
—
— Messages:
— 'view-link-display' –> 'view'
— 'edit-link-display' –> 'edit'
— 'history-link-display' –> 'history'
— 'purge-link-display' –> 'purge'
— 'file-docpage-preload' –> 'Template:Documentation/preload-filespace'
— 'module-preload' –> 'Template:Documentation/preload-module-doc'
— 'docpage-preload' –> 'Template:Documentation/preload'
— 'create-link-display' –> 'create'
–]]
local subjectSpace = env.subjectSpace
local title = env.title
local docTitle = env.docTitle
if not title or not docTitle then
return nil
end

local data = {}
data.title = title
data.docTitle = docTitle
— View, display, edit, and purge links if /doc exists.
data.viewLinkDisplay = message('view-link-display')
data.editLinkDisplay = message('edit-link-display')
data.historyLinkDisplay = message('history-link-display')
data.purgeLinkDisplay = message('purge-link-display')
— Create link if /doc doesn't exist.
local preload = args.preload
if not preload then
if subjectSpace == 6 then — File namespace
preload = message('file-docpage-preload')
elseif subjectSpace == 828 then — Module namespace
preload = message('module-preload')
else
preload = message('docpage-preload')
end
end
data.preload = preload
data.createLinkDisplay = message('create-link-display')
return data
end

function p.renderStartBoxLinks(data)
–[[
— Generates the [view][edit][history][purge] or [create] links from the data table.
— @data – a table of data generated by p.makeStartBoxLinksData
–]]

local function escapeBrackets(s)
— Escapes square brackets with HTML entities.
s = s:gsub('%[', '&#91;') — Replace square brackets with HTML entities.
s = s:gsub('%]', '&#93;')
return s
end

local ret
local docTitle = data.docTitle
local title = data.title
if docTitle.exists then
local viewLink = makeWikilink(docTitle.prefixedText, data.viewLinkDisplay)
local editLink = makeUrlLink(docTitle:fullUrl{action = 'edit'}, data.editLinkDisplay)
local historyLink = makeUrlLink(docTitle:fullUrl{action = 'history'}, data.historyLinkDisplay)
local purgeLink = makeUrlLink(title:fullUrl{action = 'purge'}, data.purgeLinkDisplay)
ret = '[%s] [%s] [%s] [%s]'
ret = escapeBrackets(ret)
ret = mw.ustring.format(ret, viewLink, editLink, historyLink, purgeLink)
else
local createLink = makeUrlLink(docTitle:fullUrl{action = 'edi