以下守则涉及了CSS版式,主要为那些自我包含且可能导入到其它页面的版式,但本守则的大部分同样适用于在独立页面中的嵌入式CSS。
创作
CSS版式应于沙盒网站或其他的作者可控制网站中起草。
在你觉得版式已经完工之后,你才可以将其完全移到社区中。但只有在你确认了你的版式与本守则符合要求并且明确得到技术组成员许可后,才能在维基上创建带有 版式 标签且处于theme:分类下的新页面。
有一些版式可能发布到了component:分类中,但是对于标准版式请使用theme:分类。
任何主题版式都必须符合如下列出的限制条件。
限制条件
若要被准许在网站上使用,你的版式必须遵守这几点限制条件。
许可
- 使用的授权协议要允许他人修改、复制、使用(授权组和技术组十分建议各位使用网站的默认授权协议,若不使用网站的默认协议也应当遵守本条,违反会导致版式被拒绝移到网站上使用)
你能改什么与不能改什么
你可以改变除了工作人员在本守则上规定的东西外的任何维基上的组件样式。
你不能移除、隐藏,或“破坏”任何社区上的导航元素或评分模组。
你不能破坏维基预计期望中的结构与外观。社区应该仍然是可识别且可读的。
基础功能
你的CSS版式必须能够在主流浏览器(Chromium、Firefox、Safari)上运作良好且至少能够在次要浏览器上运作。
你的CSS版式必须兼容森林(网站的默认CSS版式)并且兼容Wikidot网站的HTML元素属性(包括但不限于class属性、id属性)。
你的CSS版式必须如在桌面端(电脑端)一样 在移动端、平板端运行良好,至少要达到想象中的期望。
设置好版式页
版式页就是你的CSS版式源代码存放的地方。
你必须指导用户用Wikidot的[[include]]法把你的版式加到他们的页面里(并且相应地设定好你的版式页。这里是来自于基金会的模板。)
你不能指导用户用CSS的@import法把你的版式加到他们的页面里。
你应该尽可能不指导用户使用任何使用HTTP链接的Wikidot语法,链接必须为HTTPS。
你必须在你的版式页中提供用法介绍。注意这仅指要告诉用户输入什么才能让这个版式展现到他们的文章里。如果你的版式有什么作者应该知道如何使用的特性,那也必须要有说明。你无需引入你的版式格式实例——即使你完全可以,且绝对应该这么做!
你的版式页必须要将你的版式应用上去——也就是说,你的页面必须作为你的版式的预览。如果你用了上文的模板的话,那么这些就都已经为你做好了。
在检查你的版式时,技术组成员会期望不但能看到你的CSS源代码,还能看到你的版式页的草稿。
代码膨胀
CSS版式不能含有大量无用代码。CSS版式的源代码应该会包含有一点森林的CSS代码,如果有的话,除了这个版式从森林(网站的默认CSS版式)修改来的内容外的东西。大段的直接从网站版式处复制黏贴的行为是严格禁止的。
对CSS熟悉的人应该能够查看你的版式并明确了解你的意图。至少你应该能够说出你为什么要选择引用某一行。
此外,若非特别需要,你应当尽量避免使用!important标记,比如在增加优先级也无法满足时提供与其它CSS的兼容性。
可访问性
在编写CSS版式时,应该要考虑到可访问性的问题。举例:
- 这个版式对色盲人士来说可读吗?(比如其应用了如红+绿的糟糕色彩使得色盲用户难以浏览网站)
- 这个版式是否有妨碍到屏幕阅读器的使用?(比如其有添加“透明”“隐形”内容而使得其能够被屏幕阅读器阅读到但不会被视力正常读者看见)
- 它用的字体对所有读者来说都是易读的吗?(比如其主体字体大小过小、字体本身难以阅读)
等等。通过粗略的搜索可以很轻松地获得解决所有这些潜在问题的最佳做法与建议。
热链
热链即将文件链接至另一个网站的做法,这既是一种非常糟糕的做法,又违反了站规。强迫他人的网站负荷你的版式图片是非常不礼貌的,且还会给你的版式带来一定程度的不可靠性——那如果那个网站消失了呢?
若想防止热链行为,在CSS版式里用到的所有图片、字体与其它文件必要上传到版式页内或者附件站内而不是从互联网上的某个地方链接过来。
然而,你允许使用某些明确鼓励用热链来为用户提供文件的网站。显著例子包括谷歌字体与Lorem Picsum。若有疑问,谨慎行事并询问技术组。
此外,CSS不可由沙盒页或别的不是主网站、附件站(且在工坊外)的地方链接过来。你必须在维基用theme:页面来承载CSS版式。
HTTPS
你的CSS版式必须能完全运作于网站的HTTPS版(https://deep-forest-club.wikidot.com/)下。这意味着任何内部@import或url(……)参考都必须指向HTTPS的URL。对于Wikidot来说,这意味着链接要是https://deep-forest-club.wikidot.com/local--files/分页名/文件名的形式。
注意HTTPS的wdfiles链接甚至能在普遍不支持HTTPS的沙盒中运作。
批准
在发布之前,你的版式必须要被技术组的一名成员批准。他们会查看你的版式、提出意见并确认其是否符合该守则。
只有技术组可以批准CSS版式。技术组组长对任何批准都有最终决定权。技术组成员所制作的版式必须得到另一技术组成员的批准。
得到技术组的批准意味着你的版式至少将要在未来五日内发布且尽可能不要做出修改;如果你在得到批准过长时间后发布版式或者如果你做出了较大面积的修改,请重新寻求批准。
请确保能给予技术组一点时间(工作日的2天~3天,节假日的1天~2天)来检查你的版式。
CSS版式的删除守则
CSS版式禁止其他任何成员修改。这是因为CSS版式的[[include]],会让内容大面积的引用到其他页面,为防止破坏行为,故禁止其他任何成员修改站内的CSS版式页面。
CSS版式受到通常删除守则的影响,且一旦其跌至-2的评分就会被删除。
修正不兼容的版式
若你的版式无法在主流浏览器(Google Chrome、Microsoft Edge、Mozilla Firefox、Opera Browser、Apple Safari、移动端)上起作用且表现完全破坏了导航、功能、或可访问性,其就需要被于网站上移除(或最低限度地,从引用块中移除),然后按照这个顺序修复。我们首先要做的是兼容性,功能,然后是可访问性。




