原作者暂未发布该版本
访问overlab源码的方式:
联系站长,分配用户名/密码/权限
访问网站 http://git.overlab.cn/ ,使用上述账号登录,可以修改密码
这是本站部署的私有git托管平台
使用git拉取代码库overlab_wikijs2_source
代码库内存储的是Wiki.js的源码,需要编译才能运行。
Wiki.js的开发文档 https://docs.requarks.io/
Wiki.js的原始源码 https://github.com/Requarks/wiki
原作者暂未发布该版本
取消对非Ascii字符的警告:,搜索Ascii,在“JavaScript和TypeScript”和“国际化”内,取消对非ASCII字符的警告
服务器安装Node v16.16.0(宝塔面板提供的版本),开发人员自行安装更新的Node v16.20.2,下载地址 https://nodejs.org/download/release/v16.20.2/ ,开发操作系统均为Windows,64位windows需要下载的文件为node-v16.20.2-x64.msi。由于Wiki.js项目较早,因此只基于较早版本的Node开发,所以安装过高版本的Node会导致无法安装依赖项。
可以参考Wiki.js的文档 https://docs.requarks.io/dev 进行操作,手动运行需要参考“Manually”章节。但是,原文中的运行方式很有可能无法运行,建议使用以下操作替换Wiki.js文档中的操作:
安装node包管理器yarn,以代替npm npm i -g yarn
管理员权限运行cmd,定位到本地版本库的根目录
也可在本地仓库根目录地址栏输入cmd后按回车,但可能因为无管理员权限导致安装不生效
安装依赖项yarn install
修改网站文件完成后,编译yarn build,会多出三个文件夹assets、data和.webpack-cache
如果提示“NODE_OPTIONS不支持”,则打开网站程序文件中的package.json,删除第11行(build所在行)的NODE_OPTIONS=--openssl-legacy-provider
如果报错Error: error:0308010C:digital envelope routines::unsupported,再次修改上述文件,把dev后的内容改为node --openssl-legacy-provider dev
启动网站程序yarn start
查看网站根目录的config.yml,查看文件内容获得端口号port: 8071
浏览器localhost:8071即可访问网站。此时网页内有明显文字提示该项目为开发版本。
请勿按照Wiki.js的文档安装windows-build-tools,这是为了旧版本Node准备的编译工具,现版本的Node已经集成了编译工具。并且windows-build-tools早已停止更新和维护,无法成功安装。
运行yarn dev
如果报错,打开网站程序文件中的package.json,删除dev所在行的NODE_OPTIONS=--openssl-legacy-provider
用这种方式替代build和start,可以在开发项目时实时修改代码,实时反映在网页中。
需要刷新网页才能显示更改的内容
css和js中的url必须是基于项目源码的url,不能是网站已经运行后才出现的url,否则yarn dev和yarn build会报错。基于项目源码的url的根目录参考已有css和js。即:这些css和js用url引入的文件,必须是存在于项目源码中的。
|
建议编辑器安装对 Pug 语法的支持插件,因为Wiki.js的Vue页面使用Pug语法书写
Webpack已经给css等资源添加了随机文件名,保证不会被缓存。但如果遇到了vue页面等被缓存的情况,可以在浏览器内按Crtl+Shift+R强制刷新
也可使用浏览器的无痕模式,每次退出无痕模式都会清除缓存
在Github上下载Wiki.js的发行版本(不是源码版本),放在服务器中,作为基础版本。
如有需要,在服务器上运行一次yarn install
删除服务器中的assets和server文件夹,把本地编译后的这两个文件夹上传。
注:开发者在使用源码开发网站时,运行网站后,在本地看到的网站内可能有醒目的标志提示这是开发版本。按照上述方式更新服务器时,没有把开发文件提交到服务器,因此服务器上的网站运行后不会提示为开发版本。
网站管理区的代码注入不要修改!这里有内容,但是显示不全,修改后会覆盖原有内容。
所有的css和js都写在/client/static/udf_css/和client/static/udf_js/下。并在all.css和all.js内引入。
Wiki.js内文件的作用请参考/develop/wikijs-origin/file。
feat: 新功能(feature)
fix: 修补bug
docs: 文档(documentation)
style: 格式(不影响代码运行的变动)
refactor: 重构(即不是新增功能,也不是修改bug的代码变动)
chore: 构建过程或辅助工具的变动
revert: 撤销,版本回退
perf: 性能优化
test:测试
improvement: 改进
build: 打包
ci: 持续集成
使用PostgreSQL。
ping网站网址获得IP地址,就是数据库的IP,端口号为5432。
联系站长分配账号
生命周期
文档加载完成
client\themes\default\components\page.vue 里,页面加载完成会通知 page-ready 事件,可通过 window.boot.register('page-ready', () ⇒ { // do something }) 进行监听