帮助:可配置的站点功能
本页对机长可在机长室配置的站点功能进行解释
Tailwind CSS
一个广受好评的CSS框架,可以在不编辑CSS文件的情况下,实现灵活的样式调整。
灰机目前使用的版本为v3.2.4的CDN版
关于该框架的使用方法,请参考以下文档
配置
由于Tailwind CSS的默认样式与灰机皮肤中使用的Bootstrap样式冲突,所以会默认加载了以下Tailwind CSS配置
tailwind.config = { corePlugins: { preflight: false, container: false }, theme: { screens: { sm: '576px', md: '768px', lg: '992px', xl: '1200px', '2xl': '1366px', '3xl': '1600px', }, }, };
如需自定义配置,请在自己站点的Common.js
中,添加以下代码
window.tailwindconfig = { ... }
注意:这里添加的是tailwindconfig
,而不是tailwind.config
。这是由于脚本加载顺序的缘故,当Common.js加载到页面时,Tailwind CSS还没有加载,导致tailwind对象不存在,无法使用tailwind.config
进行配置。当加载Tailwind CSS完成后,会检查是否存在tailwindconfig
,如果存在则使用tailwind.config
作为配置(此时不会加载默认配置,如需包含请复制一份),否则使用默认配置。
除此之外还有其他样式会发生冲突,发生冲突时,可以使用tailwind
的important语法(在class名之前加!
),例如!text-black
Visual Editor
Visual Editor(可视化编辑器),是由MediaWiki官方插件Visual Editor提供的一种高级编辑器。
该编辑器对于大部分内容由MediaWiki预设功能编写的站点比较好用。
灰机wiki于2023年2月10日开始,默认关闭此功能,原因如下
- 灰机wiki的大部分成熟站点都使用了大量自制模板和模块,甚至是零件,导致可视化编辑器难以正确的加载和编辑
- 这些站点的老用户均使用源代码编辑器,对可视化编辑器的正确运行与否并未过多关注,导致使用可视化编辑器可能很难编辑
- 在加载了可视化编辑器插件的站点中,“编辑”按钮默认为使用该编辑器,对刚加入站点的新人很容易误导
如有需要请机长自行打开该功能。
另外该功能依赖于REST API,该服务会每日定期重新加载新建的站点,新建站点需要等待到次日才可使用
Semantic MediaWiki
基于某些技术问题,目前Semantic MediaWiki在全站开启,仅用于Data命名空间(3500)
机长室可开启主命名空间(0)的Semantic MediaWiki功能,其他命名空间如需开启该功能请联系灰机管理员。
关于Semantic MediaWiki的使用方法请参考以下链接
ExternalData
允许使用{{#external}}
系列解析器函数
该选项为解决历史遗留问题添加,如你并不清楚是什么,不建议开启该选项
具体说明请参考官方文档
TabberNeue
允许使用<tabber>
标签
该选项为解决历史遗留问题添加,如你并不清楚是什么,不建议开启该选项
具体说明请参考官方文档
LabeledSectionTransclusion
允许使用{{#lst}}
系列解析器函数
该选项为解决历史遗留问题添加,如你并不清楚是什么,不建议开启该选项
具体说明请参考官方文档
灰机2.0兼容模式
允许使用灰机2.0时代的一部分功能,不建议任何新站点启用该功能
Variables
允许使用{{#var}}
系列解析器函数
该解析器函数不符合MediaWiki未来的发展方向,会在未来的MediaWiki版本中被移除,不建议新站开启该功能,同时老站也建议尽量移除该功能涉及的页面
具体说明请参考官方文档
Arrays
允许使用{{#array}}
系列解析器函数(但不包括{{#arraymap}}
)
该解析器函数不符合MediaWiki未来的发展方向,会在未来的MediaWiki版本中被移除,不建议新站开启该功能,同时老站也建议尽量移除该功能涉及的页面
具体说明请参考官方文档