使用说明

OneNav使用说明

入门

后台使用

后台登录地址为:http://domain.com/index.php?c=login

或者点击首页顶部按钮。

img

添加分类

点击导航菜单 - 添加分类进行操作,下方演示添加一个“测试分类”如下截图。

img

分类名称图标设置

0.9.22及之后的版本

直接选择图标或者搜索图标添加并保存即可。

0.9.21及之前的版本

分类名称支持Font Awesome 4图标,可前往:https://fontawesome.dashgame.com/ 选择喜欢的图标(V4版本)。然后尝试将字体图标设置为:fa fa-book,并访问前台查看效果。

添加链接

点击导航菜单 - 添加链接进行操作,如下图。

img

前台说明

私有分类后面会显示一把小绿锁,并且该分类及下面的链接对访客不可见。

img

如果是私有链接,底部会有一条橙色线条,且该链接对访客不可见。

img

快速添加链接

如果您使用的默认主题,并以管理员身份登录后,右下角会出现“+”按钮,点击可快速添加链接。

img

右键菜单(快速编辑)

鼠标移动到某个链接上面,并单击鼠标右键,即可弹出右键菜单,可快速编辑、删除、显示二维码,复制原始链接等操作。(仅默认主题支持)

img

购买订阅

OneNav从0.9.22版本增加了订阅模式,订阅用户将享受更多的高级功能,具体内容包含:

购买订阅

可前往https://shop.xiaoz.top/productinfo-101.html 购买订阅,购买时请填写正确的邮箱和子域名。OneNav是单域名授权模式,因此一定要具体到子域名,比如nav.rss.ink,不需要加http://

购买完成后会将订单号发送到您的邮箱。

打开OneNav后台 - 系统设置 - 订阅 & 更新 - 填写您的订单号和邮箱即可。

保存完毕后即可享受订阅服务带来的各种高级功能。

没有域名购买订阅

部分同学使用的NAS部署,通过IP方式访问,并没有域名。我们可以通过以下2种方式来解决:

  1. 购买时随便填写一个域名,然后通过hosts访问
  2. 购买时随便填写一个域名,然后联系管理员手动修改为IP授权

比如您访问IP是:http://192.168.20.8,您购买时可以填写一个自定义域名nav.docmain.com(这个域名可以不是自己的,只要合法即可)

接下来我们修改系统的hosts文件,以Windows操作系统为例,用文本工具打开C:\Windows\System32\drivers\etc这个文件(推荐第三方编辑器),里面添加一行内容并保存:

192.168.20.8 nav.docmain.com

接下来访问http://nav.docmain.com在“OneNav后台 - 系统设置 - 订阅 & 更新”保存订阅即可。

注意:后续在使用订阅功能,也需要通过此域名访问。

查询与更改订阅

如果您购买时域名不小心填错了或者后期更换了域名,可以通过:https://www.onenav.top/msub.html 查询和修改订阅,但是注意每6个月内才能更换一次。

订阅服务对比

目前订阅分为标准版、高级版、商业版、永久版,对比和区别如下。

版本/功能 标准版 商业版 永久版
功能 所有 所有 所有
有效期 1年 永久 永久
技术支持 社区支持 社区支持 + 人工服务 社区支持 + 人工服务
可商用
价格 19.9元/年 179.9元/年 99.9元/年

其它说明

如有任何疑问,请联系客服协助处理。

更换主题

OneNav主题位于templates目录下,如果您不喜欢默认主题,可自行开发或者使用第三方主题。

注意:如果使用的Docker部署,主题位于挂载文件夹的templates目录下

更换主题方法

0.9.18及之后的版本

  1. 下载第三方主题,并解压至templates目录下
  2. 打开OneNav后台 - 系统设置 - 主题设置 - 选择要使用的主题

0.9.18之前的版本

  1. 下载第三方主题,并解压至templates目录下
  2. 0.9.16版本及以后还内置了一套第三方主题baisuTwo

您可以尝试修改data/config.php,将主题设置为baisuTwo,然后访问前台查看效果。

//主题风格
define('TEMPLATE','baisuTwo');

Docker版更换主题

0.9.18之后的版本

  1. 在您的挂载目录下创建一个templates目录,然后将主题解压至此目录
  2. 打开OneNav后台 - 系统设置 - 主题设置 - 选择要使用的主题

0.9.18之前的版本

  1. 在您的挂载目录下创建一个templates目录,然后将主题解压至此目录
  2. 修改config.php设置主题目录名

第三方主题

tushan

感谢@itushan的辛苦开发,为OneNav贡献一套新主题“tushan”,tushan是一款超简约的主题,将所有分类移动到抽屉,界面清爽简洁,适合浏览器主页。

主题下载地址:http://soft.xiaoz.org/source/onenav/themes/tushan.zip

下载后解压到OneNav下的templates目录,然后再OneNav后台 - 系统设置 - 主题设置,找到改主题并启用即可。

演示地址:https://web.png.ink/

baisu

由网友baisu制作,风格简约舒适,支持暗色主题。

界面如下截图:

img

注意:这是一套老版本主题,在新版本中不适用,0.9.16及之后可以使用内置主题baisuTwo

书签导入

0.9.11版本开始,支持将Chrome/FireFox/Edge等浏览器书签导入到OneNav,导入前建议先将数据库(data/onenav.db3)进行备份。

从Google Chrome导入

按快捷键Ctrl + Shift + O打开Chrome书签管理器(或者地址栏输入chrome://bookmarks/),点击右上方三个点的按钮。

img

将书签导出为.html 并记住导出位置,稍后导入需要使用。

img

打开OneNav后台 - 链接管理 - 书签导入 - 选择刚刚导出的.html书签。按照下图顺序进行操作。

img

导入成功后看到如下提示。

img

从Firefox导入

输入快捷键Ctrl + Shift + B打开我的足迹,选择所有书签 - 导出书签到HTML进行保存。

img

然后打开OneNav后台 - 链接管理 - 书签导入 - 选择刚刚导出的.html书签。按照下图顺序进行操作。

img

从Edge导入(chromium)

在浏览器标签页输入edge://favorites/ - 打开收藏夹 - 导出收藏夹。

img

然后打开OneNav后台 - 链接管理 - 书签导入 - 选择刚刚导出的.html书签。按照下图顺序进行操作。

img

补充说明

目前仅支持.html格式导入,Chrome/Firefox/Edge测试通过,理论上支持所有chromium内核浏览器,具体请自行测试,不保障所有浏览器书签均能导入成功,导入前请将数据库进行备份。

为什么会导入失败?

  1. 书签已经存在与数据库中
  2. 书签标题为空字符
  3. 书签链接为空字符

过渡页设置

0.9.18版本开始新增过渡页设置,开启过渡页面后点击链接会跳转到过渡页面,并根据您的设置会等待数秒再跳转到目标地址。

好处于弊端

好处:

  1. 过渡页可方便搜索引擎抓取,利于SEO优化
  2. 可以在过渡页自定义一些内容,比如投放广告

弊端:

  1. 用户使用体验不友好

过渡页设置

进入OneNav后台 - 系统设置 - 过渡页页面进行设置。

各参数含义如下:

高级功能

过渡页高级功能包括过渡页菜单/自定义footer/广告设置,支持HTML代码,需要订阅用户才能使用(非订阅用户请留空),设置参数如下。

过渡页菜单参考代码:

<li class="nav-item">
	<a class="nav-link" href="https://www.xiaoz.me/">小z博客</a>
</li>
<li class="nav-item">
	<a class="nav-link" href="https://www.imgurl.org/">ImgURL免费图床</a>
</li>

自定义footer参考代码:

&copy;2022 Powered by <a href="https://www.xiaoz.me/" title = "小z博客" rel = "nofollow" target = "_blank">xiaoz</a>

自定义广告参考代码:

<a href = "https://www.xiaoz.me" target = "_blank"><img src = "https://img.rss.ink/imgs/2022/06/01/d90d1feb9391fc06.png" /></a>

注意:广告图片宽度需要只要大于730px,效果如下图。

站点设置

0.9.18版本开始,站点信息可通过OneNav后台进行设置,不用再修改config.php配置文件来完成。

使用说明

打开OneNav后台 - 系统设置 - 站点设置 - 您可以对网站标题、关键词、描述等信息进行设置。

参数说明

自定义header详细说明

自定义header仅对用户首页和过渡页生效,部分主题可能未适配这个功能,默认主题是支持的。

比如您可以添加百度统计代码,比如:

<script>
var _hmt = _hmt || [];
(function() {
  var hm = document.createElement("script");
  hm.src = "https://hm.baidu.com/hm.js?xxx";
  var s = document.getElementsByTagName("script")[0]; 
  s.parentNode.insertBefore(hm, s);
})();
</script>

也或者自定义网站CSS:

<style type="text/css">
			/*链接描述是否显示*/
			
			.site-main .site-list .list .desc {
				/*none:不显示,block:显示*/
				display: none;
			}
		</style>

主题设置说明

default(默认主题)

0.9.20可以在“系统设置 - 主题设置 - 找到默认主题 - 参数设置”进行参数设置。

默认主题会看到如下参数:

参数含义如下:


0.9.19如果需要隐藏默认主题的描述,请在“系统设置 - 站点设置 - 自定义header”添加如下CSS内容进行隐藏:

<style type="text/css">
/*隐藏默认主题描述*/
.link-content{
display:none;
}
.link-line{
height:56px;
}
</style>

baisuTwo

0.9.20及之后的版本如果需要显示baisuTwo主题的描述,可以将link_description修改为show


0.9.19如果需要隐藏baisuTwo主题的描述,可以在“系统设置 - 站点设置 - 自定义header”添加如下CSS内容进行隐藏:

<style type="text/css">
/*链接描述是否显示*/
.site-main .site-list .list .desc {
/*none:不显示,block:显示*/
display: none;
}
</style>

5iux

sou

webstack

heimdall

此主题来源于独立导航程序Heimdall,由xiaoz适配到OneNav,该主题非常适合少量书签的NAS用户。主题参数如下:

使用Chrome浏览器扩展(插件)

OneNav还支持Chrome浏览器扩展(理论上所有Chromium内核的浏览器都支持,比如Edge/傲游浏览器/QQ浏览器/搜狗浏览器/360极速浏览器),通过Chrome浏览器扩展可以快速打开和添加书签。

安装浏览器扩展

前往:Chrome Web Store 进行安装(注意:需要自备梯子),或者商店搜索“onenav”进行安装。

设置API

首先您需要在OneNav后台 - 系统设置 - 获取API,然后点击“生成SecretKey”,再点击“计算Token”,然后将Token复制并记录下来。

打开Chrome浏览器右上角的“扩展程序”图标,将OneNav扩展进行固定。

这时右上方会出现一个蓝色的OneNav(书签)按钮,点击这个按钮,并选择API设置。

填写您的OneNav域名和刚刚得到的Token,并点保存按钮。(注意:OneNav域名前面需要带上http://或https://末尾不需要/

添加书签

您可以打开任意网址,然后鼠标右键 - 选择添加到OneNav书签,并保存即可。

或者点击右上角OneNav(书签)图标,然后选择添加链接按钮。

常见问题

设置API后书签不显示?

  1. 确保您的OneNav域名可以正常访问
  2. 设置API后可尝试点击刷新数据
  3. 检查域名或者Token是否设置错误

添加链接后没有显示书签? 为了减少网络请求,提高加载速度,数据会缓存到浏览器本地存储,如果添加后书签未能显示,可尝试点击“刷新数据按钮”

添加链接的时候所属分类是空的?

  1. 请检查API设置是否正确
  2. 尝试点击“刷新数据”试试

uTools插件

OneNav书签提供uTools插件支持,目前还处于测试阶段,暂未提交到uTools插件市场,等测试完毕后正式上线uTools插件市场,有需要尝鲜体验的同学请通过如下方法安装。

安装uTools for OneNav插件

uTools插件市场搜索“onenav”进行安装。(需uTools版本>=2.x)

img

使用

再次呼出uTools,输入其中任意关键词打开OneNav插件。关键词为:"onenav", "one","nav","bookmarks","book"

img

首次打开看到的书签是官方默认的(https://nav.rss.ink),您可以点击右下方设置按钮,设置你自己的OneNav地址:

img

设置如下截图:

img

进阶

您可以在uTools偏好设置中,设置onenav快捷键,比如我这里设置的Shift + B,下次只需要直接输入Shift + B即可打开onenav插件。

img

当onenav插件输入框获得焦点时,按Ctrl + Z可清空关键字。

img

注意

重置密码

如果您不幸忘记OneNav或者需要重新设置密码,可通过以下方法完成。

查看当前用户名、密码

找到站点目录下的data/config.php,找到如下字段就是用户名、密码。

//用户名
define('USER','xiaoz');
//密码
define('PASSWORD','xiaoz.me');

修改密码

此方法全版本通用,找到站点目录下的data/config.php,修改如下字段即可:

//用户名
define('USER','xiaoz');
//密码
define('PASSWORD','xiaoz.me');

如果您的OneNav版本大于或等于0.9.19也可以直接删除data/config.php,然后重新访问站点首页会要求重新设置账号、密码。(推荐新手使用此方法