Floust
large picture of the cover

记录浮尘综合WIKI中遇到的问题及解决方案

浮尘综合WIKI使用的是wiki.js。虽然界面先进，动画流畅，但是维护的开发者较少，更新缓慢，因此有些功能上的残缺与错误。

本文用以记录在使用过程中遇到的问题与解决方案，以便日后查阅与参考。

本文中使用的代码大多由deepseek生成，不一定是最优解。

本文的问题序号仅作标记作用，没有时间及流程上的联系。

一 搜索引擎屏蔽问题

问题表述

在刚刚建站时忘记打开搜索引擎屏蔽，导致网站被搜索引擎收录，网站可以被直接搜到

解决方案

  1. 在wiki.js的配置界面打开常规项

  1. 在Robots Meta选项中选择"No Index,No Follow"

  1. 等待搜索引擎提供商刷新索引

二 浏览器图标修改

问题表述

wiki.js没有提供现有的浏览器icon图标设置项，因此需要使用脚本注入方法修改图标

解决方案

  1. 在wiki.js的配置界面打开主题项

  1. 在"正文HTML注入"模块添加以下代码

<script>
    //修改浏览器图标
    var links = document.querySelectorAll("link[rel*='icon']");
    for(var i=0; i<links.length; i++) {
        document.head.removeChild(links[i]);
    }
    var newLink = document.createElement('link');
    newLink.type = 'image/png';
    newLink.rel = 'icon';
    newLink.href = 'http://39.98.89.202/upload/cropped-drome_sky_line.png?' + new Date().getTime();
    document.head.appendChild(newLink);
</script>

其中newLink.href后的内容为修改后图标的地址

  1. 刷新wiki文章页面，注意到图标已改变

三 浮动图片占据评论区

问题表述

在文章末尾插入图片时选择Left/Right aligned image时会导致图片占据评论区，不清楚原理，可以通过在浮动图片旁手动添加空白换行符解决

解决方案

  1. 同问题二，打开主题项

  2. 在"CSS覆盖"模块添加以下代码

.comments-container {
  border-radius: 7px;
  clear: both
}

四 修改WIKI主题

问题表述

在官方文档中提到"It's not yet possible to change or download new themes"，因此网上很少有wiki.js的主题分享，我目前只找到了wikijs-citizen-styles一个主题，色调还算满意，因此不打算继续寻找

解决方案

  1. 打开主题项

  2. 在正文HTML模块添加以下代码


<style type="text/css">
@charset "UTF-8";:root{--cover-font-family:"Inter","MiSans Latin","Helvetica Neue","Helvetica","Roboto","BlinkMacSystemFont","MiSans","HarmonyOS Sans SC","PingFang SC","Hiragino Sans GB","Microsoft YaHei","微软雅黑",Arial,sans-serif;--color-primary-override__h:200;--color-primary-override__s:55%;--color-primary-override__l:48%;--color-primary-override:hsl(var(--color-primary-override__h),var(--color-primary-override__s),var(--color-primary-override__l));--color-surface-0__s:3%;--color-surface-0__l:99%;--color-surface-1__s:3%;--color-surface-1__l:95%;--color-surface-2__s:10%;--color-surface-2__l:93%;--color-surface-3__s:10%;--color-surface-3__l:85%;--color-surface-4__s:10%;--color-surface-4__l:74%;--color-surface-0:hsl(var(--color-primary-override__h),var(--color-surface-0__s),var(--color-surface-0__l));--color-surface-1:hsl(var(--color-primary-override__h),var(--color-surface-1__s),var(--color-surface-1__l));--color-surface-2:hsl(var(--color-primary-override__h),var(--color-surface-2__s),var(--color-surface-2__l));--color-surface-3:hsl(var(--color-primary-override__h),var(--color-surface-3__s),var(--color-surface-3__l));--color-surface-4:hsl(var(--color-primary-override__h),var(--color-surface-4__s),var(--color-surface-4__l));--color-text-override:hsl(var(--color-primary-override__h),30%,20%);--color-text-override--emphasized:hsl(var(--color-primary-override__h),85%,5%);--color-text-override--subtle:hsl(var(--color-primary-override__h),30%,35%)}::selection{background:hsla(var(--color-primary-override__h),5%,54%,22%)}html{scrollbar-color:var(--color-surface-4) transparent;scrollbar-width:thin}.v-application,.v-application .body-1,.v-application .caption,body{font-family:var(--cover-font-family)!important}#root .v-main .contents{color:var(--color-text-override)!important}#root .v-main .contents code,#root .v-main .contents pre{background-color:var(--color-surface-1)!important;color:var(--color-text-override--subtle)!important;padding:0 4px!important}#root .v-main .contents .prismjs{padding:1rem 1rem 1rem 3rem!important}#root .v-application .grey--text.text--darken-3{caret-color:var(--color-text-override--subtle)!important;color:var(--color-text-override--subtle)!important}#root .v-main__wrap{background-color:var(--color-surface-0)}#root .v-application code{padding:unset!important;text-shadow:none!important}#root .v-sheet.v-card:not(.v-sheet--outlined){box-shadow:0 0 24px var(--color-surface-2)}#root div.code-toolbar>.toolbar button{background:transparent!important;border-radius:0!important;box-shadow:none!important}#root .contents hr{background-color:var(--color-surface-2)!important}#root .contents div>p,#root .v-main .contents ol,#root .v-main .contents ul:not(.tabset-tabs){padding-top:.5rem!important}#root .v-toolbar__title{color:var(--color-text-override--emphasized);user-select:none;-webkit-user-select:none}#root .v-application .blue.darken-2,#root .v-application button.primary{background-color:var(--color-primary-override)!important;border-color:var(--color-primary-override)!important}#root .page-header-section .page-edit-shortcuts .v-btn .v-icon,#root .v-application a,#root .v-main .contents h1,#root .v-main .contents h2,#root .v-main .contents h3,#root .v-main .contents h4,#root .v-main .contents h5,#root .v-main .contents h6{color:var(--color-primary-override)!important}#root .v-main .contents h1,#root .v-main .contents h2,#root .v-main .contents h3,#root .v-main .contents h4,#root .v-main .contents h5,#root .v-main .contents h6{font-weight:600;margin-top:1.25rem}#root .v-main .contents h1:after,#root .v-main .contents h2:after,#root .v-main .contents h3:after,#root .v-main .contents h4:after,#root .v-main .contents h5:after,#root .v-main .contents h6:after{content:none!important}#root .__bar-is-vertical{background:var(--color-surface-4)!important}#root .__bar-is-vertical,#root .__rail-is-vertical{width:4px!important}#root .v-application .primary.v-navigation-drawer{border-color:var(--color-surface-3)!important;border-right:1px solid}#root .v-application .blue.darken-3,#root .v-application .deep-purple,#root .v-application .grey.darken-4-d4,#root .v-application .grey.darken-5,#root .v-application .primary{background-color:var(--color-surface-1)!important}#root .v-application .grey.darken-4-l3,#root .v-application .grey.lighten-3,#root .v-application .grey.lighten-4{background-color:var(--color-surface-2)!important}#root .v-navigation-drawer .v-list .mdi:before,#root .v-navigation-drawer .v-list--dense .v-list-item .v-list-item__title{color:var(--color-text-override)!important}#root .v-list-item--link:before{background-color:var(--color-primary-override)!important}#root .v-navigation-drawer .theme--dark.v-subheader{color:var(--color-text-override--emphasized)!important}#root .v-application .black{background-color:var(--color-surface-0)!important;border-color:var(--color-surface-3)!important;border-bottom:1px solid}#root .v-btn:before{background-color:var(--color-primary-override)!important}#root .v-application .v-footer .caption{text-align:center}#root .v-application v-footer .caption span:last-child{opacity:.5}#root .token.builtin,#root .token.constant,#root .token.keyword,#root .token.property,#root .token.selector,#root .token.symbol{color:#bca700}#root code[class*=language-] ::selection,#root code[class*=language-]::selection,#root pre[class*=language-] ::selection,#root pre[class*=language-]::selection{background:hsla(var(--color-primary-override__h),5%,54%,22%)}@media screen and (max-width:960px){#root .v-toolbar__content button.v-btn.v-btn--icon.v-size--default[aria-label=创建新页面],#root .v-toolbar__content button.v-btn.v-btn--icon.v-size--default[aria-label=创建新页面]~.theme--dark.v-divider,#root .v-toolbar__content button.v-btn.v-btn--icon.v-size--default[aria-label=页面操作],#root .v-toolbar__content button.v-btn.v-btn--icon.v-size--default[aria-label=页面操作]~.theme--dark.v-divider{display:none}#root .v-application footer.grey.lighten-3{padding:20px 10px}#root .__panel{padding-bottom:7rem!important}#root .__rail-is-vertical{display:none!important}}#root .search-results{backdrop-filter:blur(16px);-webkit-backdrop-filter:blur(16px);background-color:rgba(0,0,0,.3)}@keyframes searchResultsReveal{0%{background-color:transparent;padding-top:32px}to{background-color:rgba(0,0,0,.3)!important;padding-top:0}}#root .theme--dark.v-input,#root .theme--dark.v-input input,#root .theme--dark.v-input textarea,#root .theme--dark.v-text-field--solo>.v-input__control>.v-input__slot .v-icon:before,#root .theme--dark.v-text-field--solo>.v-input__control>.v-input__slot label{color:var(--color-text-override--subtle)!important}#root .theme--dark.v-text-field--solo>.v-input__control>.v-input__slot{background:var(--color-surface-2)!important}#root #app.theme--dark{--color-surface-0__s:20%;--color-surface-0__l:10%;--color-surface-1__s:25%;--color-surface-1__l:12%;--color-surface-2__s:25%;--color-surface-2__l:15%;--color-surface-3__s:15%;--color-surface-3__l:20%;--color-surface-4__s:15%;--color-surface-4__l:25%;--color-surface-0:hsl(var(--color-primary-override__h),var(--color-surface-0__s),var(--color-surface-0__l));--color-surface-1:hsl(var(--color-primary-override__h),var(--color-surface-1__s),var(--color-surface-1__l));--color-surface-2:hsl(var(--color-primary-override__h),var(--color-surface-2__s),var(--color-surface-2__l));--color-surface-3:hsl(var(--color-primary-override__h),var(--color-surface-3__s),var(--color-surface-3__l));--color-surface-4:hsl(var(--color-primary-override__h),var(--color-surface-4__s),var(--color-surface-4__l));--color-text-override:hsl(var(--color-primary-override__h),45%,80%);--color-text-override--emphasized:hsl(var(--color-primary-override__h),80%,95%);--color-text-override--subtle:hsl(var(--color-primary-override__h),35%,65%)}#root #app.theme--dark .v-main .contents code,#root #app.theme--dark .v-main .contents pre{background-color:var(--color-surface-2)!important}#root #app.theme--dark button.theme--dark.v-btn.v-btn--depressed.v-size--default.grey.darken-4{background-color:var(--color-primary-override)!important}#root #app.theme--dark .v-toolbar__content .theme--dark.v-icon{color:#cbcbcb!important}#root #app.theme--dark .v-main__wrap{background-color:var(--color-surface-2)}#root #app.theme--dark .v-toolbar__content .theme--dark.v-divider{border-color:transparent!important}#root #app.theme--dark .theme--dark .page-header-section .page-edit-shortcuts .v-btn{background-color:var(--color-surface-1)!important;border-bottom-color:var(--color-surface-4)!important;border-right-color:var(--color-surface-4)!important;color:var(--color-text-override)}#root #app.theme--dark .grey.darken-4-d3,#root #app.theme--dark .theme--dark.v-card,#root #app.theme--dark .theme--dark.v-list{background-color:var(--color-surface-1)!important}#root #app.theme--dark .v-sheet.v-card:not(.v-sheet--outlined){border:1px solid var(--color-surface-3);box-shadow:none}#root #app.theme--dark .v-btn:before,#root #app.theme--dark .v-list-item--link:before{background-color:#fff!important}
</style>

五 编辑器没有居中图片的功能

解决方案

  1. 打开编辑器界面

  2. 点击右上角的"页面"选项

  1. 接下来有两种方法

  • 在"样式"选项中添加代码

.v-main .contents figure.image {
  margin: auto
}

但是这种方法会将所有图片全部居中

  • 在"脚本"选项中添加代码

<script>
function centerSpecificFigures() {
    const targetTexts = ["发酵桶的模型", "设备示意图", "结构图"];
    document.querySelectorAll('figure').forEach(figure => {
        const figcaption = figure.querySelector('figcaption');
        if (figcaption && targetTexts.some(text => 
            figcaption.textContent.trim().includes(text)
        )) {
            figure.style.margin = 'auto';
        }
    });
}
if (document.readyState === 'loading') {
    document.addEventListener('DOMContentLoaded', centerSpecificFigures);
} else {
    centerSpecificFigures();
}
const observer = new MutationObserver(mutations => {
    if (mutations.some(mutation => mutation.addedNodes.length)) {
        centerSpecificFigures();
    }
});
observer.observe(document.body, {
    childList: true,
    subtree: true
});
</script>

将"发酵桶的模型", "设备示意图", "结构图"修改为特定的任意数量的关键词即可

关键词为图片下的文本

六 小图片不会自动缩放变大

问题表述

当图片缩放后大小大于本身大小时会显示原图大小，这导致小尺寸的图片无法正常显示

解决方案

没有找到好的解决方法，直接将小图片事先等比例放大后再上传可以解决

对于像素画，我写了个简单的放大后不模糊的脚本zoom.zip

七 文件夹无法删除问题

问题表述

建立文件夹后无法删除

解决方案

官网的解释为"Note that disabled actions are not yet available and are coming in a future release."因此目前没有好的解决办法

可以进入数据库的"assetFolders"表中手动删除

对于floust wiki，进入http://39.98.89.202:5050/pgadmin4/browser/ 登陆管理员账号（与WIKI的管理员账号相同），导航到图示位置

随后选择并Alt+Shift+V或者右键-查看/编辑数据-所有行，然后在右侧选择行并删除

（可能过程有长时间卡顿，耐心等待，一直不好的话就是服务器死机了，等服主重启吧）

哇哇哇哇哇哇哇哇

site logo

FLOUST

© 2026 Floust