README.md 5.8 KB
Newer Older
X
xjh22222228 已提交
1 2 3 4 5 6 7

<p align="center">
  <a href="https://nav3.cn/?g">
    <img src="src/assets/logo.png" width="130" />
  </a>
  <br />
  <b>发现导航</b>
X
xjh22222228 已提交
8
  <p align="center">一个纯静态、支持SEO、在线编辑的强大导航网站,希望您会喜欢</p>
X
xjh22222228 已提交
9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
  <p align="center">内置收录多达 800+ 优质网站, 助您工作、学习和生活</p>
  <p align="center">
    <img src="https://img.shields.io/github/v/release/xjh22222228/nav" />
    <a href="https://github.com/xjh22222228/nav/stargazers"><img src="https://img.shields.io/github/stars/xjh22222228/nav" alt="Stars"/></a>
    <img alt="Angular" src="https://img.shields.io/static/v1.svg?label=&message=Angular11&style=flat-square&color=C82B38">
    <img src="https://img.shields.io/github/license/xjh22222228/nav" />
    <a href="https://hits.dwyl.com/xjh22222228/nav">
      <img src="https://hits.dwyl.com/xjh22222228/nav.svg" />
    </a>
  </p>
</p>

<br />
<br />


## 选择版本
目前有2个版本供选择, [v3](https://github.com/xjh22222228/nav/tree/v3)`v5`, 这2个版本都会长期维护:

- v5 - 也就是当前分支, 需要依赖于Github配置, 提供自动维护数据功能(微后台),但必须Fork到自己仓库里。
- v3 - 无需依赖Github, 您可以将代码部署在任意服务器, 但数据需要手工维护。

作者推荐您选择 `v5` 没有太多的心智负担。



## 预览
**主题**

X
xjh22222228 已提交
38 39
- [Sim 在线预览](https://nav3.cn/#/sim)
- [Light 在线预览](https://nav3.cn/#/light)
X
xjh22222228 已提交
40

X
xjh22222228 已提交
41 42 43 44 45
![Preview](https://raw.githubusercontent.com/xjh22222228/public/gh-pages/nav/1.png)
![Preview](https://raw.githubusercontent.com/xjh22222228/public/gh-pages/nav/2.png)
![Preview](https://raw.githubusercontent.com/xjh22222228/public/gh-pages/nav/3.png)
![Preview](https://raw.githubusercontent.com/xjh22222228/public/gh-pages/nav/4.png)
![Preview](https://raw.githubusercontent.com/xjh22222228/public/gh-pages/nav/5.png)
X
xjh22222228 已提交
46 47 48 49 50 51 52




## 拥有出色的特性
`发现导航` 的理念就是做一款无需依赖后端服务既简单又方便,没有繁杂的配置和数据库等配置概念, 做到开箱即用。

X
xjh22222228 已提交
53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
- 🍰 内置 `800+` 实用网站。
- 🍰 支持SEO, 没有可不行。
- 🍰 完全纯静态, 提供自动化部署功能。
- 🍰 三叉树分类、结构清晰、分类清晰。
- 🍰 颜值与简约并存,不再是杀马特时代。
- 🍰 支持多种浏览模式,创新。
- 🍰 支持足迹记忆。
- 🍰 支持移动端浏览。
- 🍰 支持搜索查询。
- 🍰 支持自定义引擎搜索。
- 🍰 完全开源,轻松定制化。
- 🍰 多款主题切换。
- 🍰 支持暗黑模式。
- 🍰 支持快捷键操作,一步到位。
- 🍰 支持在线新增数据, 没有传统的后台概念。
X
xjh22222228 已提交
68 69 70 71 72 73 74 75



## 部署
推荐使用 `github pages` 服务, 这样就不需要提供服务器, 并且项目里自带了自动化部署服务,像数 `321` 一样简单。

1、Fork 当前项目。

X
xjh22222228 已提交
76
2、[https://github.com/settings/tokens](https://github.com/settings/tokens) 申请 token, 勾选相应的权限, 如果不懂就全部选中,复制并保存Token。
X
xjh22222228 已提交
77

X
xjh22222228 已提交
78
3、到 https://github.com/用户名/nav/settings/secrets/new  添加刚刚申请的token, name填写 `TOKEN` 大写。
X
xjh22222228 已提交
79

X
xjh22222228 已提交
80
4、打开 https://github.com/用户名/nav/actions 点击 `绿色按钮`
X
xjh22222228 已提交
81

X
xjh22222228 已提交
82
5、务必修改项目配置文件 [nav.config.ts](nav.config.ts)
X
xjh22222228 已提交
83

X
xjh22222228 已提交
84
6、5分钟后打开 https://用户名.github.io/nav 就能看到一个非常强大的导航网站了。
X
xjh22222228 已提交
85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108


注:如果想部署到自己的域名,那么以上教程同样适合,因为它提供了自动化部署, 之后可以通过 `CNAME``反向代理` 实现:

```conf
# nginx

server {
    listen       80;
    server_name  www.nav3.cn nav3.cn;

    location / {
        proxy_pass https://xjh22222228.github.io/nav/;
    }
}
```


## 配置
所有可配置位于文件 `nav.config.ts`




X
xjh22222228 已提交
109
## 关于升级
X
xjh22222228 已提交
110
在升级之前请保存根目录下的 `data` 文件夹,最好把 `nav.config.ts` 配置文件也保存一份以防万一, 升级完后替换即可。
X
xjh22222228 已提交
111

X
xjh22222228 已提交
112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
点击右上角 `Watch` 按钮第一时间跟踪版本升级。



## 更新日志
[CHANGELOG](CHANGELOG.md)




## 快捷键
mac下是 `Command`,windows 下是 `Ctrl`

- `ctrl+e` 开启或关闭编辑模式
- `ctrl+v` 查看信息
- `ctrl+d` 开启或关闭暗黑模式

如对快捷键有特殊要求请发起 [issues](https://github.com/xjh22222228/nav/issues)
X
xjh22222228 已提交
130 131 132 133




X
xjh22222228 已提交
134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165

## 开发构建
``` bash
# 下载
git clone --depth=1 https://github.com/xjh22222228/nav.git

# 安装依赖
npm i

# 启动
npm start

# 打包
npm run build
```



## 贡献
[点击这里](https://github.com/xjh22222228/nav/tree/master/data)

Thank you for your [contribution](https://github.com/xjh22222228/nav/issues), men.

<a href="https://github.com/YutHelloWorld">
  <img src="https://avatars1.githubusercontent.com/u/20860159?s=460&v=4" width="30px" height="30px" />
</a>
<a href="https://github.com/JJJTHuang">
  <img src="https://avatars3.githubusercontent.com/u/22817432?s=460&v=4" width="30px" height="30px" />
</a>
<a href="https://github.com/Fechin">
  <img src="https://avatars1.githubusercontent.com/u/2541482?s=460&v=4" width="30px" height="30px" />
</a>
X
xjh22222228 已提交
166 167 168
<a href="https://github.com/setdiaoyong">
  <img src="https://avatars1.githubusercontent.com/u/62551864?s=460&v=4" width="30px" height="30px" />
</a>
X
xjh22222228 已提交
169 170 171



X
xjh22222228 已提交
172 173 174



X
xjh22222228 已提交
175 176 177 178 179 180
## 建议
如果有任何功能上的建议可通过 [issue](https://github.com/xjh22222228/nav/issues) 发起, Thank you.



## 支持
X
xjh22222228 已提交
181 182 183
项目成立于 2018 年到至今一直坚持维护和开源, 经过N次的迭代与优化, 如果项目能帮到您是我的荣幸。

您可以请作者喝杯咖啡,继续战斗下去(请备注Github名字)~
X
xjh22222228 已提交
184 185

<img src="https://raw.sevencdn.com/xjh22222228/public/gh-pages/img/32.png" width="600">
X
xjh22222228 已提交
186 187

感谢您的认可:
X
xjh22222228 已提交
188
| 姓名    | 支持金额              |
X
xjh22222228 已提交
189 190 191
| --------------------------------------- |----------- |
| [aiyou9](https://github.com/aiyou9)     | ¥20.00     |