说明: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/

如有侵权,请联系我