Manual:Parameters to index.php/zh

本页面是，即MediaWiki软件自身提供的主要脚本，所接受的部分参数的列表. 大多数参数在URL中一般给定为GET参数，不过也可以传作POST数据. 部分情况下POST请求是必需的，比如刷新操作. 一些扩展可以提供额外的参数.



页面修订或版本
index.php的参数通常适用，并且具有与它们所应用的页面相关的含义. 可以通过键入以下一个或多个参数来指定页面（或其版本）： https:// en.wikipedia.org/w/index.php? title =Ferengi& curid =177126& diff =304901009& oldid =304764764

某些操作（如查看和编辑）也适用于页面的特定修订. 这样的修订由以下两个参数标识，允许省略页面的标题和id.

操作
以下是 参数值的列表.

其中一些操作可以通过在 中使用专用配置设置来启用/禁用. 在可用的情况下，会列出这些本地设置.



用户首选项覆盖
以下参数将覆盖用户的某些首选项. 其他章节中解释的其他参数包括“diffonly”、“internaledit”和“externaledit”. 以下参数会影响除“render”和“raw”之外的所有操作.



查看和渲染
查看是默认操作. 如果没有向URL添加其他操作，则使用. 此操作显示页面、修订或同一页面或两个不同页面的两个修订之间的差异. 以下是（部分）列表.


 * diff
 * 该参数的值标识修订；则返回另一个修订与此修订之间的差异：


 * 如果 未通过，则显示本次修订与同一文章上一次修订之间的差异；
 * 否则，将显示 给出的修订与此修订之间的差异；此参数的值可以是修订id，值 或 用于标识相对于 给出的修订的修订，值 则用于标识页面的最新修订；
 * 请注意， 和 不需要是同一篇文章的两个修订版，可以比较两个不同页面的两个版本


 * redirect
 * 如果此参数的值为“no”，并且页面是重定向，则显示页面本身，而不是重定向的目标；此参数仅对 和 有效，并且仅在未给定 或 的情况下有效，因为这是唯一显示目标文章而不是重定向的情况；


 * rdfrom
 * 当页面是从外部wiki进行重定向的结果时，此参数“告知”是哪个wiki，以便可以显示“从…重定向”行


 * diffonly
 * 重写用户在请求diff时是否呈现页面的偏好，例如


 * search
 * 如果非空（并且启用了搜索），则覆盖所有其他参数并执行搜索

以下参数仅适用于类别.


 * from
 * 如果页面是一个分类，则仅列出排序键等于或跟随该参数值的条目；
 * 示例： https://en.wikipedia.org/w/index.php?title=Special:Log&type=upload & from =20070814233520&until=20070814233625
 * 链接到2007年8月14日23:35:20至23:36:25上传的所有图像的日志


 * until
 * 如果页面是一个分类，则仅列出排序键位于该参数值之前的条目；仅在未传递 时使用；

以下参数仅适用于图像.


 * page
 * 多页介质中的页码；它目前只适用于DjVu和PDF文件；第一页编号为1；

历史

 * limit
 * 要列出的页面编辑数，最大为5000次编辑.
 * 示例： https://en.wikipedia.org/w/index.php?title=Special:Contributions &limit=13 &contribs=user&target=Atlgirl052005 - 每页列出13次编辑.


 * dir
 * 编辑历史页面的相对顺序.
 * 页面编辑按递减时间戳排序.


 * offset
 * 使用时间戳来指定显示历史的哪一部分；
 * 返回在时间戳“之前”发生的编辑；
 * 示例： https://en.wikipedia.org/w/index.php?title=Special:Contributions &offset=20090815195334 &contribs=user&target=Atlgirl052005
 * 显示在时间戳20090815195334“之前紧接”发生的编辑（未显示20090815195364）.
 * 参数格式为yyyymmdhhmmss. 因此，20090815195334创建于2009年8月15日【20090815】19:53（UTC）34秒【195334】.
 * 参见Wikipedia:Complete diff and link guide.
 * if  is added, it works the other way around, listing all edits after the timestamp
 * 示例： https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334 &dir=prev &contribs=user&target=Atlgirl052005
 * 显示在时间戳20090815195334后立即发生的编辑（未显示20090815195364）.
 * 仅显示页面上第一次编辑的示例： https://en.wikipedia.org/w/index.php?title=Wikipedia:Village_pump_(technical)&action=history& dir=prev &limit=1


 * feed
 * 则返回用于历史中的改变的馈送；允许的值是 和 . 可以使用禁用.


 * go
 * （反对-应该避免，因为它已经被取代） 显示历史的第一页（最早）

纯文本
传递 将返回页面或修订版的源代码. 出于缓存和安全原因，这通常只能通过script路径使用，即. While "short urls" like  are only meant for action=view, they unofficially tend to work for other actions as well. This is expressly discouraged for action=raw as it leads to less effective caching and bypasses automatic purging after edits.


 * templates
 * 如果传递值 ，则页面中的模板将被展开；


 * ctype
 * 返回原始内容时要在HTTP标头中使用的内容类型值，而不是默认的 ；这只能是允许的类型之一，当前为 、 和


 * oldid
 * 要返回的特定修订的id


 * direction
 * 、 或 ；而不是oldid指定的修订，返回其后面的修订、前面的修订或当前（最后）修订；


 * section
 * 将输出限制为文档的特定部分或子部分. 节是用非负整数指定的：节0是任何命名节之前的节，节1是第一个命名节或小节，依此类推. 编号方案将节和小节视为相同. 部分和子部分的列表可以通过带有api.php?action=parse&text={{:My_page}}&#95;&#95;TOC&#95;&#95;&prop=sections的neneneba api获得.


 * 範例



編輯和送出
编辑和提交操作执行的操作几乎相同. 默认情况下，它们为页面返回一个“编辑页面”表单. 通过传递其他参数可以获得不同的结果；某些结果（例如保存页面的新版本）只能使用POST获得. 此操作采用用于指定页面或页面修订的标准参数.



影响编辑表单的选项
以下选项会对编辑表单产生影响. （注意：“section”也会影响页面的保存方式. 此外，“preload”和“preloadparams”仅适用于wikitext内容模型）


 * section
 * 指定文档中要预加载和编辑的节的索引；节从0开始按顺序编号；第0节是文章第一节标题之前的部分；值 用于将新的节追加到文档中；


 * preload
 * 指定一个页面，如果要编辑的页面或节不存在，则使用该页面的wikitext作为编辑表单中文本区域的初始值；如果存在，则忽略预加载命令；另见；
 * 示例：https://en.wikipedia.org/wiki/Talk:Main_Page?action=edit&section=new&preload=Project:Sandbox


 * preloadparams[]（或preloadparams%5B%5D） 替换预加载文本中的 样式参数. 例如，https://mediawiki.org/wiki/Project:Sandbox?action=edit&section=new&preload=Manual:Creating_pages_with_preloaded_text/param_demo&preloadparams%5b%5d=first%20value&preloadparams%5b%5d=second%20value会导致Manual:Createing pages with_proaded text/param demo被预加载到编辑表单中，但 被“第一个值”取代， 被“第二个值”替代.
 * editintro
 * 在编辑表单上方呈现的现有文章或模板的标题；


 * preloadtitle
 * 如果第=new节，则提供“主题/标题”框的初始内容；保存前可以进行编辑；
 * 示例： https://en.wikipedia.org/w/index.php?title=User_talk:5dsddddd&action=edit&section=new&preloadtitle=The+%5B%5BWP%3AARS%7CArticle+Rescue+Squadron%5D%5D
 * 具有预加载标题和预加载的示例： https://en.wikipedia.org/wiki/User_Talk:Ikip?action=edit&section=new&preload=Template:Article_Rescue_Squadron_ invite&preloadtitle=Invitation


 * nosummary
 * 當section=new時，不顯示「主旨」框.


 * summary
 * 它的值被用作编辑摘要，而不是默认值.


 * preview
 * 如果设置为 或 ，则覆盖用户首选项“”（）；


 * internaledit/externaledit : 覆盖外部编辑器上的用户首选项；
 * mode
 * 如果使用值 传递并使用外部编辑器，则此参数会影响结果页；


 * undo, undoafter
 * 尝试撤消一系列编辑，从 修订版到 版本；从技术上讲，这是通过尝试将这些编辑的反向与所有后续编辑的序列合并来实现的；这些参数的值是页面的旧修订的id；如果无法合并，则返回该修订版的常规编辑表单



该怎么办
以下选项告诉软件在提交时要做什么：保存、显示预览或显示与当前版本的差异.


 * wpSave
 * 此参数是在保存服务器返回的编辑表单的内容时生成的，但在提交时并没有实际使用，也不是必需的（有关要保存的必需参数，请参阅下文）；


 * wpPreview
 * 在POST请求中设置为请求页面或节的预览，就好像保存了wpTextbox1的值一样；


 * 默认情况下，返回一个带有wpTextbox1值预览的编辑表单；
 * 如果传递了额外的 参数，则只显示值wpTextbox1的呈现，而不显示表单和其他GUI元素；这类似于节省然后用 观看的结果；查看了解更多信息；
 * 参数 与wpPreview相同；因此，如果 未通过，则返回常规预览·
 * wpDiff
 * 在POST请求中设置为请求一个表，该表显示页面或部分的当前版本与wpTextbox1的值被保存的版本之间的变化；



需要保存的参数
用户保存页面时需要以下参数. 如果配置了编辑摘要字段，则也可能需要编辑摘要字段（见下文）.


 * wpTextbox1
 * 新的页面/部分内容；


 * wpStarttime
 * 用户何时开始编辑页面的时间戳；用于检查从该时刻到提交时间之间页面是否已被删除（在这种情况下，要求用户确认保存）；


 * wpRecreate
 * 如果该页面在wpStarttime之后被删除，则该字段确认该页面将被保存；


 * wpEdittime
 * 对于新页面，它等于wpStarttime；否则，它是页面最后一次修订的时间戳；用于检查编辑冲突；


 * wpEditToken
 * 一个编辑令牌；这是为了避免用户被诱骗通过跟随链接或按下外部网站中的按钮来保存页面. 对于未登录的用户，wpEditToken是必需的，因为rSVN18112；它目前只包含字符 ，而不是随机字符串（请参见编辑令牌后缀）.

对于要保存的页面，POST请求中需要 、 、 和 ，并且既不传递 也不传递. 如果页面是在 之后删除的，则还需要布尔选项.



可选的附加数据
如果配置了“警告空白摘要”，则编辑摘要或“忽略空白”参数可能是必需的.


 * wpSummary
 * 编辑摘要；


 * wpMinoredit
 * 如果在保存请求中设置，则编辑标记为次要；对于预览和差异，它是编辑表单中“这是一个小编辑”复选框的初始值；


 * wpWatchthis
 * 如果在保存请求中传递，则该页面将添加到用户的观察列表中；如果未在保存请求中传递，则该页面将从用户的监视列表中删除；对于预览或差异，这是编辑表单的“查看此页面”复选框的初始值；


 * wpSection
 * 指定要提交给的文档中某一节的索引；节从0开始按顺序编号；第0节是文章第一节标题之前的部分；值 用于将新的节追加到文档中；


 * wpChangeTags
 * 要添加到编辑中的tags的可选逗号分隔列表. 如果提供的任何标签未激活以供手动使用，则编辑将被拒绝.


 * wpAutoSummary
 * contains the MD5-hashing of the edit summary field as initially presented to the user in the edit form; this field is used to check if the user has modified that field before submitting: if the MD5 hashing of the value of  is the same as this field, the edit summary has not been modified;


 * wpIgnoreBlankSummary
 * 保存页面，即使用户没有修改编辑摘要，而他们应该修改；


 * wpTextbox2
 * 在编辑冲突的情况下，它包含生成冲突的保存请求的wpTextbox1的值；


 * wpScrolltop
 * 用于在加载预览时保留编辑文本框中的滚动条位置.


 * redlink
 * 如果用户没有编辑页面的权限，则重定向到空的文章页面（例如，“维基百科没有这个确切名称的文章”），而不是显示权限错误通知；此参数用于红色链接.


 * wpExtraQueryRedirect
 * 保存URL后要修改的隐藏输入，实际编辑表单不使用. 适用于小工具等.



特殊页面
大多数特殊页面都有额外的参数，特定于它们执行的功能. 例如，Special:Export的参数在中列出

以下URL参数为一些输入字段提供了初始值；可以在提交表单之前对其进行编辑.

Special:MovePage

 * wpReason
 * 原因的文字欄位.


 * wpNewTitle
 * 新標題的文字欄位.


 * wpLeaveRedirect
 * 是否勾選「留下重新導向頁面」複選框.

Special:BlockIP

 * wpDisableEmail
 * 是否要勾選「」複選框.


 * wpDisableUTEdit
 * 是否要勾選「」複選框.


 * wpReason
 * 預設選擇下拉式選單的項目，值應與MediaWiki:Ipbreason-dropdown中的其中一行相符.


 * wpReason-other
 * 自訂原因的文字欄位；需要


 * wpAutoBlock
 * 是否要勾選「」複選框.


 * wpWatch
 * 是否要勾選「」複選框.

Special:UserRights

 * user-reason
 * 原因的文字欄位.



最大滞后参数
只有当软件在已复制的数据库群集上运行时，才会使用“”.

maxlag参数使其在服务器流量高的情况下不提供请求. maxlag参数适用于所有操作. maxlag参数值是一个数字；该值越低，导致请求不被服务的流量就越低. 不允许为零.

註釋


参见

 * m:Help:URL
 * 函数列表
 * Snippets/Load JS and CSS by URL (添加客户端处理的withJS和withCSS参数)
 * 函数列表
 * Snippets/Load JS and CSS by URL (添加客户端处理的withJS和withCSS参数)