MCBBS Wiki欢迎您共同参与编辑!在参与编辑之前请先阅读Wiki方针

如果在编辑的过程中遇到了什么问题,可以去讨论板提问。

为了您能够无阻碍地参与编辑 未验证/绑定过邮箱的用户,请尽快绑定/验证

MCBBS Wiki GitHub群组已上线!

您可以在回声洞中发表吐槽!

服务器状态监控。点击进入

本站由MCBBS用户自行搭建,与MCBBS及东银河系漫游指南(北京)科技有限公司没有从属关系。点此了解 MCBBS Wiki 不是什么>>

SaltMCBBS:修订间差异

来自MCBBS Wiki
跳到导航 跳到搜索
(.)
 
(.)
第2行: 第2行:
{{软件信息
{{软件信息
|名称 = SaltMCBBS
|名称 = SaltMCBBS
|image = {{图片外链|https://attachment.mcbbs.net/forum/202102/19/191731sm8gyqszuqgrxusf.png}}
|image = {{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202102/19/191731sm8gyqszuqgrxusf.png}}
|英文名 =
|英文名 =
|别名 =
|别名 =
第26行: 第26行:
=== 安装 ===
=== 安装 ===
方法一:在greasyfork网站点击安装即可。
方法一:在greasyfork网站点击安装即可。
: 新版的SaltMCBBS(0.1.9开始)不再支持v2版本的论坛前端,因此'''还在使用v2论坛皮肤的坛友需要通过方法二来获取0.1.8的后续更新'''。


方法二:从GitHub下载最新版本,手动粘贴到脚本管理插件里。
方法二:从GitHub下载最新版本,手动粘贴到浏览器的脚本管理扩展面板里。


=== 配置 ===
=== 配置 ===
第33行: 第34行:
* 设置面板入口在左侧栏底部,同一位置还有切换夜间模式按钮和使用表情包按钮。
* 设置面板入口在左侧栏底部,同一位置还有切换夜间模式按钮和使用表情包按钮。
* 绝大多数配置的修改'''立即生效'''无需刷新,但是页面间不会自动同步,需要手动刷新。
* 绝大多数配置的修改'''立即生效'''无需刷新,但是页面间不会自动同步,需要手动刷新。

=== 控制台 ===
同时按下<code>ctrl</code>+<code>`</code>(<code>Tab</code>上面的那个反引号键)可以呼出控制台。

输入<code>help</code>后按下<code>enter</code>(回车键),可以看到当前版本SaltMCBBS可用的所有指令;使用<code>help &lt;指令名&gt;</code>可以看到某个指令的使用帮助。

控制框内若想正常换行,请同时按下<code>shift</code>和<code>enter</code>(回车键)。

常用指令列表如下:
{|
! 指令 !! 说明 !! 指令 !! 说明
|-
| <code>gid &lt;数字&gt;</code> || 前往对应gid的大区 || <code>fid &lt;数字/版块别名&gt;</code> || 前往对应fid的版块
|-
| <code>tid &lt;数字&gt;</code> || 前往对应tid的主题帖 || <code>pid &lt;数字&gt;</code> || 前往对应pid的回复帖
|-
| <code>uid &lt;数字&gt;</code> || 前往对应uid的用户主页 || <code>uname &lt;用户名&gt;</code> || 前往对应用户名的用户主页
|-
| <code>eval &lt;JS代码</code> || 执行JS代码<small><del>这个功能好鸡肋啊</del></small> || <code>cls</code> || 控制台清屏
|}


== 功能 ==
== 功能 ==
第38行: 第59行:
{{hide|标题=压缩页面顶部空间相关功能|内容=这部分主要是尽量压缩顶部内容较少的部分,在用户看第一眼的时候,尽可能多地展示主要内容。
{{hide|标题=压缩页面顶部空间相关功能|内容=这部分主要是尽量压缩顶部内容较少的部分,在用户看第一眼的时候,尽可能多地展示主要内容。


{{图片外链|https://attachment.mcbbs.net/forum/202101/16/153457jqphnwqx1poephes.jpg|512}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/153457jqphnwqx1poephes.jpg|512}}
{{图片外链|https://attachment.mcbbs.net/forum/202101/16/153412ai79fs7l4i4db75b.jpg|512}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/153412ai79fs7l4i4db75b.jpg|512}}


1. 将'''顶部栏变为左侧栏''',压缩顶部空间。
1. 将'''顶部栏变为左侧栏''',压缩顶部空间。


{{图片外链|https://attachment.mcbbs.net/forum/202101/23/141734lprssausp4awawyp.png}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/23/141734lprssausp4awawyp.png}}


2. 压缩MCBBS Logo与广告栏的'''上下边距''',同时提供屏蔽这两个元素的设置项。
2. 压缩MCBBS Logo与广告栏的'''上下边距''',同时提供屏蔽这两个元素的设置项。
第49行: 第70行:
{{hide|标题=一键切换夜间模式|内容=夜间模式一键切换,同时可以在页面间同步——这个页面切换为夜间模式了,其他页面也会变成夜间模式(反之亦然)。
{{hide|标题=一键切换夜间模式|内容=夜间模式一键切换,同时可以在页面间同步——这个页面切换为夜间模式了,其他页面也会变成夜间模式(反之亦然)。


{{图片外链|https://attachment.mcbbs.net/forum/202101/16/154041yswf7a1s77sda7dl.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/154041yswf7a1s77sda7dl.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/forum/202101/16/154300pn6998srnz4w6udu.png|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/154300pn6998srnz4w6udu.png|768}}
}}
}}
{{hide|标题=更改背景图片|内容=你可以在配置栏中填入多个URL,SaltMCBBS会随机选择一张图片显示——你也可以直接填入随机图片API。
{{hide|标题=更改背景图片|内容=你可以在配置栏中填入多个URL,SaltMCBBS会随机选择一张图片显示——你也可以直接填入随机图片API。
第56行: 第77行:
正常模式与夜间模式下的背景图片是分开控制的。
正常模式与夜间模式下的背景图片是分开控制的。


{{图片外链|https://attachment.mcbbs.net/forum/202101/16/161644qhnobbbll53qt5f4.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/161644qhnobbbll53qt5f4.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/forum/202101/16/161625cc9z3r39pflp9bfl.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/161625cc9z3r39pflp9bfl.jpg|768}}


你也可以控制鼠标尚在页面中,和鼠标离开网页后,页面主体部分的不透明度。
你也可以控制鼠标尚在页面中,和鼠标离开网页后,页面主体部分的不透明度。


{{图片外链|https://attachment.mcbbs.net/forum/202101/16/161743uo2la5rkrrvlr25l.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/161743uo2la5rkrrvlr25l.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/forum/202102/19/200459ti2vjay79uui9m25.jpg|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202102/19/200459ti2vjay79uui9m25.jpg|768}}


}}
}}
第69行: 第90行:
你写入的正则表达式会储存在indexeDB中,无需担心写得太多占用其他脚本的数据存储空间。
你写入的正则表达式会储存在indexeDB中,无需担心写得太多占用其他脚本的数据存储空间。


{{图片外链|https://attachment.mcbbs.net/forum/202101/23/141944d0nljllemtxxtbze.png|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/23/141944d0nljllemtxxtbze.png|768}}


匹配过程异步进行,一般不会导致页面出现明显卡顿;匹配到水帖后将会显示在页面右下角。
匹配过程异步进行,一般不会导致页面出现明显卡顿;匹配到水帖后将会显示在页面右下角。
第75行: 第96行:
点击气泡即可直达对应楼层。
点击气泡即可直达对应楼层。


{{图片外链|https://attachment.mcbbs.net/forum/202101/16/162236yss9tq1bwzdzweq1.png}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202101/16/162236yss9tq1bwzdzweq1.png}}
}}
}}
{{hide|标题=简易的控制台|内容=你可以使用<code>Ctrl + `</code>快捷键或设置面板顶栏的入口呼出控制台。
{{hide|标题=简易的控制台|内容=你可以使用<code>Ctrl + `</code>快捷键或设置面板顶栏的入口呼出控制台。
第81行: 第102行:
使用<code>help</code>查看所有可用指令;使用<code>help &lt;指令名></code>来查看某个指令的用法。
使用<code>help</code>查看所有可用指令;使用<code>help &lt;指令名></code>来查看某个指令的用法。


{{图片外链|https://attachment.mcbbs.net/forum/202102/14/233713xbthchem00kiivii.png|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202102/14/233713xbthchem00kiivii.png|768}}


}}
}}
第88行: 第109行:
[https://s3.ax1x.com/2021/02/10/y08y0s.gif 这里有一个比较大的GIF图,点进去看的话,请注意流量]
[https://s3.ax1x.com/2021/02/10/y08y0s.gif 这里有一个比较大的GIF图,点进去看的话,请注意流量]


{{图片外链|https://attachment.mcbbs.net/forum/202102/10/205235mwrv6wwhkjzvfd2r.gif|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202102/10/205235mwrv6wwhkjzvfd2r.gif|768}}


{{图片外链|https://attachment.mcbbs.net/forum/202102/14/234033tceaqrm2mt4tjsas.png|768}}
{{图片外链|https://attachment.mcbbs.net/data/myattachment/forum/202102/14/234033tceaqrm2mt4tjsas.png|768}}
}}
}}
=== 其他功能 ===
=== 其他功能 ===
第140行: 第161行:
# 与MCBBS Extender的冲突:
# 与MCBBS Extender的冲突:
## 展开/收起勋章栏功能失效:当两个脚本均开启勋章栏功能,且MCBBS Extender的勋章栏高度控制功能未启用(即设为-1)时触发。
## 展开/收起勋章栏功能失效:当两个脚本均开启勋章栏功能,且MCBBS Extender的勋章栏高度控制功能未启用(即设为-1)时触发。

== 更新日志 ==
== 更新日志 ==



2021年4月6日 (二) 18:46的版本

SaltMCBBS
软件信息
名称 SaltMCBBS
作者 Salt_lovely
语言 简体中文
最新版本 0.1.8.2
开源 GitHub
编写语言 TypeScript、SCSS
运行环境 油猴脚本等用户脚本管理器插件
许可证 CC BY-NC-SA 4.0
查看MCBBS上的发布帖

SaltMCBBS(中文名“加盐的MCBBS”)是一个MCBBS样式优化与功能拓展脚本。

简介

SaltMCBBS(中文名“加盐的MCBBS”)是一个完全开源的MCBBS用户脚本,主要目标是解决MCBBS日常使用时的一些小问题,优化论坛使用体验。

SaltMCBBS的耗时模块均异步启用,一般不会使页面加载产生肉眼可见延迟;设计上遵循非必要无日志原则,正常加载时控制台上只有3条信息(SaltMCBBS信息、初始化耗时、主模块耗时)——例外情况是:反探针模块与图片懒加载模块、图片代理模块可能会产生大量的日志。

SaltMCBBS卖点之一(也是写这个脚本的最初计划)是夜间模式,一键切换MCBBS进入适合夜间阅读的暗色风格;夜间模式的SCSS代码编译前就有约1300行(含注释),覆盖了大部分论坛页面。

使用说明

安装

方法一:在greasyfork网站点击安装即可。

新版的SaltMCBBS(0.1.9开始)不再支持v2版本的论坛前端,因此还在使用v2论坛皮肤的坛友需要通过方法二来获取0.1.8的后续更新

方法二:从GitHub下载最新版本,手动粘贴到浏览器的脚本管理扩展面板里。

配置

  • 默认启用左侧栏代替顶栏,可以在设置中调整。
  • 设置面板入口在左侧栏底部,同一位置还有切换夜间模式按钮和使用表情包按钮。
  • 绝大多数配置的修改立即生效无需刷新,但是页面间不会自动同步,需要手动刷新。

控制台

同时按下ctrl+`Tab上面的那个反引号键)可以呼出控制台。

输入help后按下enter(回车键),可以看到当前版本SaltMCBBS可用的所有指令;使用help <指令名>可以看到某个指令的使用帮助。

控制框内若想正常换行,请同时按下shiftenter(回车键)。

常用指令列表如下:

指令 说明 指令 说明
gid <数字> 前往对应gid的大区 fid <数字/版块别名> 前往对应fid的版块
tid <数字> 前往对应tid的主题帖 pid <数字> 前往对应pid的回复帖
uid <数字> 前往对应uid的用户主页 uname <用户名> 前往对应用户名的用户主页
eval <JS代码 执行JS代码这个功能好鸡肋啊 cls 控制台清屏

功能

主要功能

压缩页面顶部空间相关功能

这部分主要是尽量压缩顶部内容较少的部分,在用户看第一眼的时候,尽可能多地展示主要内容。

1. 将顶部栏变为左侧栏,压缩顶部空间。

2. 压缩MCBBS Logo与广告栏的上下边距,同时提供屏蔽这两个元素的设置项。

一键切换夜间模式

夜间模式一键切换,同时可以在页面间同步——这个页面切换为夜间模式了,其他页面也会变成夜间模式(反之亦然)。

更改背景图片

你可以在配置栏中填入多个URL,SaltMCBBS会随机选择一张图片显示——你也可以直接填入随机图片API。

正常模式与夜间模式下的背景图片是分开控制的。

你也可以控制鼠标尚在页面中,和鼠标离开网页后,页面主体部分的不透明度。

自定义正则表达式来检测水帖

你可以自己写正则表达式来匹配水帖。

你写入的正则表达式会储存在indexeDB中,无需担心写得太多占用其他脚本的数据存储空间。

匹配过程异步进行,一般不会导致页面出现明显卡顿;匹配到水帖后将会显示在页面右下角。

点击气泡即可直达对应楼层。

简易的控制台

你可以使用Ctrl + `快捷键或设置面板顶栏的入口呼出控制台。

使用help查看所有可用指令;使用help <指令名>来查看某个指令的用法。

表情包使用与管理系统

支持所见即所得模式,支持自定义表情图片大小(每张图都可以定一个大小)。

这里有一个比较大的GIF图,点进去看的话,请注意流量

其他功能

  1. 自定义举报与评分理由。
    1. 预览图
    2. 修改后无需刷新页面,但是需要重新打开举报/评分面板。
    3. 与其他多行配置一样,在开头添加“//”即可暂时禁用这一项。
  2. 勋章栏样式美化与交互性优化。(会被MCBBSExtender覆盖)
    1. 特别的勋章栏样式
    2. 交互性强的勋章栏高度控制功能
    3. 有一个无法解决的冲突,见#脚本冲突章节。
  3. 识别并处理防盗链图床5个与无法访问图床2个。
    1. 反防盗链:微博图床、QQ空间图床、贴吧图床、B站图床、百度图床。
    2. 自动代理:imgur图床、uploadcc图床。
    3. 你可以到这个帖子测试一下。
  4. 更加现代化的图片懒加载方式。
    1. 可能被MCBBS自带的懒加载顶掉。
  5. 帖子分类高亮。
    1. 默认情况下的高亮
    2. 你可以使用CSS来自定义帖子高亮模式、样式
  6. 反探针功能。
    1. 检测并处理的探针会显示在右下角,这个烦人的提示可以关掉。
  7. 层主信息栏跟随页面滚动。
  8. 层主信息栏部分内容可以自定义了。(将在0.1.8.3版本实装)
    1. 可以自定义显示的积分/主题等信息。(MCBBS默认显示“金粒、宝石、贡献、爱心”)
    2. 目前最多可以显示这些内容:积分,帖子,主题,精华,金粒,宝石,贡献,爱心,钻石,人气,下界之星,最后登录,注册时间。
  9. 控制签名栏高度。
    1. 更改高度的签名栏将出现滚动条
    2. 小于0禁用此功能,设为0屏蔽签名栏。
  10. 一些小小的文本框可以拉大
  11. 透明显示被警告的帖子。(默认开启,被发卡或扣分的帖子将变得半透明且不易看清、不易注意到)
  12. 代码栏样式优化。(兼容模式下覆盖MCBBS Extender)
  13. 强制使用H5播放器与阻止自动播放音乐。(仅对网易外链播放器有效)

特点

  • 大模块异步加载,几乎不产生肉眼可见的加载卡顿。
  • 部分数据储存在indexedDB中,为其他脚本节省localStorage空间。
  • 提供了localStorage与indexedDB的简单封装,可以用于二次开发。

开发文档

已知漏洞

  1. 懒加载功能可能被MCBBS自带的懒加载顶掉部分图片。没有修复计划。
  2. 于火狐浏览器上运行时,会将所见即所得编辑框视为新页面,写入内容。 于0.1.8修复
  3. 代码栏优化样式导致行号错位,同时代码栏复制功能会复制行号进去。 于0.1.8.2修复
  4. 禁止网易云外链播放器自动播放功能无效。 将于0.1.8.3修复

脚本冲突

  1. 与MCBBS Extender的冲突:
    1. 展开/收起勋章栏功能失效:当两个脚本均开启勋章栏功能,且MCBBS Extender的勋章栏高度控制功能未启用(即设为-1)时触发。

更新日志

借物表

灵感与创意来源

  • MCBBS Extender(作者:Zapic
    • 勋章样式功能,功能继承自“盐的MCBBS样式”。
    • 回到顶部按钮的动画。
    • 强制网易云外链播放器使用H5播放器,与禁止外链播放器自动播放功能。
  • 极光creeper的未开源脚本和快乐小方的表情包管理脚本。
    • 表情包功能。
  • 绵羊的未开源脚本
    • 控制台工具。

你知道吗

  • 盐酱最开始写这个脚本的时候,其实只是想写一个可以切换夜间模式、添加“查看警告记录”按钮的脚本,顺便学一下TypeScript。
  • 这个脚本有许多功能、CSS代码继承自盐酱的另一个作品盐的MCBBS样式(纯CSS)。
  • 脚本的LOGO使用U钙网(uugai.com)工具制作,有二次加工且字体为非商用字体
  • 脚本代码使用的许可证是 CC BY-NC-SA 4.0 这个一般不用于代码的许可证。