说明:
BYR-Navi是一个开源、轻量使用Fomantic UI Web框架构建的网站导航程序,样式也非常美观,而且支持从N个站点直接搜索,我们既可以部署在自己的服务器上,又可以部署在GitHub Pages,后者无需服务器,这里分享一下部署在自己服务器上的完整教程
效果图
安装
注意:本教程基于CentOS7,如果是其他系统请自行尝试
演示地址:
https://hbcit.zyf520.xyz (我搭建的)
https://byr-navi.com (官方)
Github地址:https://github.com/BYR-Navi/BYR-Navi(官方)
1、安装Ruby2.6.3
# 查看系统当前ruby版本,可知未安装ruby
ruby -v
#通过yum安装ruby 和依赖的包
yum -y install ruby ruby-devel rubygems rpm-build
#查看当前ruby版本,2.0.0版本过低, redis5.0.5 要求ruby版本要大于2.3.0
ruby -v
#安装ruby所需的其他依赖包 (其实我也不知道这些依赖包当中哪些是多余的,但是鉴于之前离线安装的时候老是提示少库,先都安装上再说)
yum install gcc-c++ patch readline readline-devel zlib zlib-devel \
libyaml-devel libffi-devel openssl-devel make \
bzip2 autoconf automake libtool bison iconv-devel sqlite-devel
#修改ruby的gem源(改为国内的镜像,国外的实在是太慢了)
gem sources --查看当前使用的源地址
gem sources -a http://mirrors.aliyun.com/rubygems/ --添加阿里云镜像地址
gem sources -r https://rubygems.org/ --删除默认的源地址
gem sources -u --更新源的缓存
#安装rvm
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB --获取密钥
curl -sSL https://get.rvm.io | bash -s stable --安装rvm
source /etc/profile.d/rvm.sh --更新配置文件
#通过rvm升级ruby到2.6.3
rvm list known --查看所有可安装版本
rvm install 2.6 --安装ruby2.6.3
rvm -v --查看当前ruby版本
#至此,ruby2.6.3安装成功。
2、安装Jekyll 和 bundler gems
gem install jekyll bundler
3、安装BYR-Navi
git clone https://github.com/BYR-Navi/BYR-Navi.git
4、切换到项目目录
cd BYR-Navi
5、安装依赖
bundle install
6、启动服务
bundle exec jekyll serve
此时就可以使用ip:4000访问程序了。(记得开启4000端口)
这里除了可以使用命令行启动,也可以直接将生成的_site文件夹丢到网站根目录访问。
如果要修改导航相关页面的信息显示的话,也可以在_site文件夹中修改。
安装Matomo网站统计程序
matomo下载地址:https://matomo.org/matomo-on-premise
1、新建一个网站及数据库,将压缩包上传到网站根目录解压即可
2、访问网站,根据网站提示配置数据库及其他相关配置进行安装
3、安装完成后将导航网站添加进去
4、配置导航网站
修改配置文件_data/analytics.yml,大致参数如下:
#url为matomo站点,domain为导航站,site_id为matomo站点统计站id,token为matomo站点的token
matomo:
url: http://matomo.moerats.com/
domains:
"http://byr.moerats.com"
site_id: 2
token: 297bd600834c2a5a70293c47a
参数获取大致路径如下:
1、site_id
在Matomo后台添加一个网站统计,就可以直接看到网站id
2、token
该参数可以在Settings里获取API Authentication Token
5、将导航网站添加到CROS白名单
安装使用Matomo有不懂的请自行百度,这里不再赘述
OK,到这里就大功告成了
每次修改完网站信息后要重新进入BYR-Navi目录,运行bundle exec jekyll serve,将会重新生成新的_site文件夹
修改网站信息在/BYR-Navi/_data文件夹和/BYR-Navi/_config.yml里修改
本文参考:
https://www.moerats.com/archives/1004/
https://github.com/BYR-Navi/BYR-Navi
https://www.cnblogs.com/lylongs/p/11302272.html
https://matomo.org/
如有侵权,请联系我