“模块:Arguments”与“NebulaeWiki:关于”：页面之间的差异

来自NebulaeWiki
（页面间差异）
小 （已保护“模块:Arguments”（[编辑=仅允许管理员]（无限期）[移动=仅允许管理员]（无限期）））
 
无编辑摘要
 
第1行： 第1行：
-- This module provides easy processing of arguments passed to Scribunto from
'''NebulaeWiki'''是[[星云工艺|NebulaeCraft]]为记录和公布服务器相关事件和建筑数据而创设的线上知识库，创立于正处于4周目时期的2020年7月。
-- #invoke. It is intended for use by other Lua modules, and should not be
-- called from #invoke directly.


local libraryUtil = require('libraryUtil')
==== 重要页面 ====
local checkType = libraryUtil.checkType


local arguments = {}
* [[成员守则]]
* [[编辑指南]]
* [[玩家指南]]（用于展示新玩家加入服务器和老玩家游玩服务器需要知道的基础知识）


-- Generate four different tidyVal functions, so that we don't have to check the
== 沿革 ==
-- options every time we call it.


local function tidyValDefault(key, val)
==== TubesWorld Wiki ====
if type(val) == 'string' then
起初[[NebulaeCraft]]并无创立Wiki的想法。
val = val:match('^%s*(.-)%s*$')
if val == '' then
return nil
else
return val
end
else
return val
end
end


local function tidyValTrimOnly(key, val)
2019年，TubesWorld Wiki创立。它的主要建立者是Dikkoo和Jinyuxing，当时他们与[[NebulaeCraft]]的[[用户:Sakana|Srcphy]]和[[用户:Kuina|Kuina_20]]同属于一个叫做[[Mikan]]（中文名为“蜜柑”）的组织（关于该组织的详细信息请跳转至[[Mikan|Mikan词条]]查看）。起初该Wiki网站仅为当时的[[RIA TubesWorld|RIA | TubesWorld]]（下称“RTW”）服务器服务，用于存储入服信息介绍、轨道交通信息等。值得注意的是，当时[[RIA TubesWorld|RTW]]的入服问卷中的诸多客观题都可在这个Wiki中找到答案，但即便如此仍有相当多的人没能达到及格线。
if type(val) == 'string' then
return val:match('^%s*(.-)%s*$')
else
return val
end
end


local function tidyValRemoveBlanksOnly(key, val)
==== Mikan Wiki ====
if type(val) == 'string' then
同年11月10日，有关[[NebulaeCraft]]的信息也被加入TubesWorld Wiki，因此该Wiki被更名为Mikan Wiki<small>（名称中是否包含空格有待考究）</small>，并在首页同级别为[[NebulaeCraft]]新开了一半的版面。值得注意的是，TubesWorld Wiki在一开始就使用了标注了“Mikan”的图标，这仿佛是一个巧合？
if val:find('%S') then
return val
else
return nil
end
else
return val
end
end


local function tidyValNoChange(key, val)
在随后半年的时间里，[[NebulaeCraft]]成员在Mikan Wiki中创立了许多当时4周目的相关词条。这半年里Wiki总体运行稳定，除了偶尔几次出现的例如数据丢失的小小的小意外。
return val
end


local function matchesTitle(given, title)
==== NebulaeWiki ====
local tp = type( given )
[[文件:NebulaeWiki2020.png|缩略图|451x451像素|图1 2020年初代NebulaeWiki]]
return (tp == 'string' or tp == 'number') and mw.title.new( given ).prefixedText == title
[[文件:NebulaeWiki2021.png|缩略图|400x400像素|图2 2022年新版NebulaeWiki（部分图片和图标目前已无法显示）]]
end
2020年7月，由于一些不可控原因，[[NebulaeCraft]]脱离了Mikan Wiki并自行建设了一个全新的Wiki站点，称作NebulaeWiki（这次这个肯定没有空格）。但是别搞混了！虽然网址始终未变，但这里提到的NebulaeWiki并不是如今你看到的这个，您可在右图1中看到它原本的模样。也是在这时，其他各家服务器也纷纷开启了属于他们自己的Wiki网站。


local translate_mt = { __index = function(t, k) return k end }
稳定运行一年后，在2021年6月，为了适应新生的5周目发展的需要，NebulaeWiki被以当时最新的技术重新搭建，而原专为4周目而生的Wiki被转移至https://archive.knebulae.com/（目前已不可访问）。虽说是新建的Wiki站点，但是不仅网址不变，连主页的样式也是沿袭了4周目的Wiki，由于长得太像，在两个Wiki并存的那段时间，一时甚至无法分辨新旧。


function arguments.getArgs(frame, options)
随后在2022年3月28日，[[用户:Kuina|Kuina_20]]对Wiki首页进行了一番大改，通过巧妙运用MediaWiki的表格功能搭配HTML和CSS样式代码，实现了更美观的视觉效果（如右图2）。
checkType('getArgs', 1, frame, 'table', true)
checkType('getArgs', 2, options, 'table', true)
frame = frame or {}
options = options or {}


--[[
在2023年9月，NebulaeWiki由于技术性故障，数据库无法正常备份和导出，以至于所有数据全部消失。随后[[用户:Kuina|Kuina_20]]和[[用户:CuteKims|CuteKims]]等以此为机会正好写了一个全新的Wiki主页，这才是您如今看到的最新款NebulaeWiki，它参考了星际公民Wiki的设计，并尽可能多的还原了技术故障前的大部分数据。
-- Set up argument translation.
--]]
options.translate = options.translate or {}
if getmetatable(options.translate) == nil then
setmetatable(options.translate, translate_mt)
end
if options.backtranslate == nil then
options.backtranslate = {}
for k,v in pairs(options.translate) do
options.backtranslate[v] = k
end
end
if options.backtranslate and getmetatable(options.backtranslate) == nil then
setmetatable(options.backtranslate, {
__index = function(t, k)
if options.translate[k] ~= k then
return nil
else
return k
end
end
})
end
 
--[[
-- Get the argument tables. If we were passed a valid frame object, get the
-- frame arguments (fargs) and the parent frame arguments (pargs), depending
-- on the options set and on the parent frame's availability. If we weren't
-- passed a valid frame object, we are being called from another Lua module
-- or from the debug console, so assume that we were passed a table of args
-- directly, and assign it to a new variable (luaArgs).
--]]
local fargs, pargs, luaArgs
if type(frame.args) == 'table' and type(frame.getParent) == 'function' then
if options.wrappers then
--[[
-- The wrappers option makes Module:Arguments look up arguments in
-- either the frame argument table or the parent argument table, but
-- not both. This means that users can use either the #invoke syntax
-- or a wrapper template without the loss of performance associated
-- with looking arguments up in both the frame and the parent frame.
-- Module:Arguments will look up arguments in the parent frame
-- if it finds the parent frame's title in options.wrapper;
-- otherwise it will look up arguments in the frame object passed
-- to getArgs.
--]]
local parent = frame:getParent()
if not parent then
fargs = frame.args
else
local title = parent:getTitle():gsub('/sandbox$', '')
local found = false
if matchesTitle(options.wrappers, title) then
found = true
elseif type(options.wrappers) == 'table' then
for _,v in pairs(options.wrappers) do
if matchesTitle(v, title) then
found = true
break
end
end
end
 
-- We test for false specifically here so that nil (the default) acts like true.
if found or options.frameOnly == false then
pargs = parent.args
end
if not found or options.parentOnly == false then
fargs = frame.args
end
end
else
-- options.wrapper isn't set, so check the other options.
if not options.parentOnly then
fargs = frame.args
end
if not options.frameOnly then
local parent = frame:getParent()
pargs = parent and parent.args or nil
end
end
if options.parentFirst then
fargs, pargs = pargs, fargs
end
else
luaArgs = frame
end
 
-- Set the order of precedence of the argument tables. If the variables are
-- nil, nothing will be added to the table, which is how we avoid clashes
-- between the frame/parent args and the Lua args.
local argTables = {fargs}
argTables[#argTables + 1] = pargs
argTables[#argTables + 1] = luaArgs
 
--[[
-- Generate the tidyVal function. If it has been specified by the user, we
-- use that; if not, we choose one of four functions depending on the
-- options chosen. This is so that we don't have to call the options table
-- every time the function is called.
--]]
local tidyVal = options.valueFunc
if tidyVal then
if type(tidyVal) ~= 'function' then
error(
"bad value assigned to option 'valueFunc'"
.. '(function expected, got '
.. type(tidyVal)
.. ')',
2
)
end
elseif options.trim ~= false then
if options.removeBlanks ~= false then
tidyVal = tidyValDefault
else
tidyVal = tidyValTrimOnly
end
else
if options.removeBlanks ~= false then
tidyVal = tidyValRemoveBlanksOnly
else
tidyVal = tidyValNoChange
end
end
 
--[[
-- Set up the args, metaArgs and nilArgs tables. args will be the one
-- accessed from functions, and metaArgs will hold the actual arguments. Nil
-- arguments are memoized in nilArgs, and the metatable connects all of them
-- together.
--]]
local args, metaArgs, nilArgs, metatable = {}, {}, {}, {}
setmetatable(args, metatable)
 
local function mergeArgs(tables)
--[[
-- Accepts multiple tables as input and merges their keys and values
-- into one table. If a value is already present it is not overwritten;
-- tables listed earlier have precedence. We are also memoizing nil
-- values, which can be overwritten if they are 's' (soft).
--]]
for _, t in ipairs(tables) do
for key, val in pairs(t) do
if metaArgs[key] == nil and nilArgs[key] ~= 'h' then
local tidiedVal = tidyVal(key, val)
if tidiedVal == nil then
nilArgs[key] = 's'
else
metaArgs[key] = tidiedVal
end
end
end
end
end
 
--[[
-- Define metatable behaviour. Arguments are memoized in the metaArgs table,
-- and are only fetched from the argument tables once. Fetching arguments
-- from the argument tables is the most resource-intensive step in this
-- module, so we try and avoid it where possible. For this reason, nil
-- arguments are also memoized, in the nilArgs table. Also, we keep a record
-- in the metatable of when pairs and ipairs have been called, so we do not
-- run pairs and ipairs on the argument tables more than once. We also do
-- not run ipairs on fargs and pargs if pairs has already been run, as all
-- the arguments will already have been copied over.
--]]
 
metatable.__index = function (t, key)
--[[
-- Fetches an argument when the args table is indexed. First we check
-- to see if the value is memoized, and if not we try and fetch it from
-- the argument tables. When we check memoization, we need to check
-- metaArgs before nilArgs, as both can be non-nil at the same time.
-- If the argument is not present in metaArgs, we also check whether
-- pairs has been run yet. If pairs has already been run, we return nil.
-- This is because all the arguments will have already been copied into
-- metaArgs by the mergeArgs function, meaning that any other arguments
-- must be nil.
--]]
if type(key) == 'string' then
key = options.translate[key]
end
local val = metaArgs[key]
if val ~= nil then
return val
elseif metatable.donePairs or nilArgs[key] then
return nil
end
for _, argTable in ipairs(argTables) do
local argTableVal = tidyVal(key, argTable[key])
if argTableVal ~= nil then
metaArgs[key] = argTableVal
return argTableVal
end
end
nilArgs[key] = 'h'
return nil
end
 
metatable.__newindex = function (t, key, val)
-- This function is called when a module tries to add a new value to the
-- args table, or tries to change an existing value.
if type(key) == 'string' then
key = options.translate[key]
end
if options.readOnly then
error(
'could not write to argument table key "'
.. tostring(key)
.. '"; the table is read-only',
2
)
elseif options.noOverwrite and args[key] ~= nil then
error(
'could not write to argument table key "'
.. tostring(key)
.. '"; overwriting existing arguments is not permitted',
2
)
elseif val == nil then
--[[
-- If the argument is to be overwritten with nil, we need to erase
-- the value in metaArgs, so that __index, __pairs and __ipairs do
-- not use a previous existing value, if present; and we also need
-- to memoize the nil in nilArgs, so that the value isn't looked
-- up in the argument tables if it is accessed again.
--]]
metaArgs[key] = nil
nilArgs[key] = 'h'
else
metaArgs[key] = val
end
end
 
local function translatenext(invariant)
local k, v = next(invariant.t, invariant.k)
invariant.k = k
if k == nil then
return nil
elseif type(k) ~= 'string' or not options.backtranslate then
return k, v
else
local backtranslate = options.backtranslate[k]
if backtranslate == nil then
-- Skip this one. This is a tail call, so this won't cause stack overflow
return translatenext(invariant)
else
return backtranslate, v
end
end
end
 
metatable.__pairs = function ()
-- Called when pairs is run on the args table.
if not metatable.donePairs then
mergeArgs(argTables)
metatable.donePairs = true
end
return translatenext, { t = metaArgs }
end
 
local function inext(t, i)
-- This uses our __index metamethod
local v = t[i + 1]
if v ~= nil then
return i + 1, v
end
end
 
metatable.__ipairs = function (t)
-- Called when ipairs is run on the args table.
return inext, t, 0
end
 
return args
end
 
return arguments

2023年9月26日 (二) 16:50的版本

NebulaeWiki是NebulaeCraft为记录和公布服务器相关事件和建筑数据而创设的线上知识库，创立于正处于4周目时期的2020年7月。

重要页面

沿革

TubesWorld Wiki

起初NebulaeCraft并无创立Wiki的想法。

2019年，TubesWorld Wiki创立。它的主要建立者是Dikkoo和Jinyuxing，当时他们与NebulaeCraft的Srcphy和Kuina_20同属于一个叫做Mikan（中文名为“蜜柑”）的组织（关于该组织的详细信息请跳转至Mikan词条查看）。起初该Wiki网站仅为当时的RIA | TubesWorld（下称“RTW”）服务器服务，用于存储入服信息介绍、轨道交通信息等。值得注意的是，当时RTW的入服问卷中的诸多客观题都可在这个Wiki中找到答案，但即便如此仍有相当多的人没能达到及格线。

Mikan Wiki

同年11月10日，有关NebulaeCraft的信息也被加入TubesWorld Wiki，因此该Wiki被更名为Mikan Wiki（名称中是否包含空格有待考究），并在首页同级别为NebulaeCraft新开了一半的版面。值得注意的是，TubesWorld Wiki在一开始就使用了标注了“Mikan”的图标，这仿佛是一个巧合？

在随后半年的时间里，NebulaeCraft成员在Mikan Wiki中创立了许多当时4周目的相关词条。这半年里Wiki总体运行稳定，除了偶尔几次出现的例如数据丢失的小小的小意外。

NebulaeWiki

图1 2020年初代NebulaeWiki
图2 2022年新版NebulaeWiki（部分图片和图标目前已无法显示）

2020年7月，由于一些不可控原因，NebulaeCraft脱离了Mikan Wiki并自行建设了一个全新的Wiki站点，称作NebulaeWiki（这次这个肯定没有空格）。但是别搞混了！虽然网址始终未变，但这里提到的NebulaeWiki并不是如今你看到的这个，您可在右图1中看到它原本的模样。也是在这时，其他各家服务器也纷纷开启了属于他们自己的Wiki网站。

稳定运行一年后，在2021年6月，为了适应新生的5周目发展的需要，NebulaeWiki被以当时最新的技术重新搭建，而原专为4周目而生的Wiki被转移至https://archive.knebulae.com/（目前已不可访问）。虽说是新建的Wiki站点，但是不仅网址不变，连主页的样式也是沿袭了4周目的Wiki，由于长得太像，在两个Wiki并存的那段时间，一时甚至无法分辨新旧。

随后在2022年3月28日，Kuina_20对Wiki首页进行了一番大改，通过巧妙运用MediaWiki的表格功能搭配HTML和CSS样式代码，实现了更美观的视觉效果（如右图2）。

在2023年9月，NebulaeWiki由于技术性故障，数据库无法正常备份和导出，以至于所有数据全部消失。随后Kuina_20和CuteKims等以此为机会正好写了一个全新的Wiki主页，这才是您如今看到的最新款NebulaeWiki，它参考了星际公民Wiki的设计，并尽可能多的还原了技术故障前的大部分数据。

取自“https://wiki.knebulae.com/index.php?title=模块:Arguments&oldid=1172”