Deploy Discovery Navigation into Github Page

Discovery Navigation is a Internet bookmark collection, administration and navigation project in Github. It supports to deploy to free Github page or free Vercel site. It also provides some unique features which other similar projects does not have. This post is going to show you the deployment process step by step using Github Page as an example. Other methods can be found from Github repository description.


Discovery Navigation

Related posts:

Demo: https://nav.51sec.org (Old version)

or https://link.51sec.org (New version)

Introduction

Discovery Navigation: 

  • A purely static, powerful navigation website that supports SEO and online editing,
  • Built-in collection of up to 800+ high-quality websites to help you work, study and live
  • support multiple themes: Demo sites:
  • Features:
    • 🍰 Built-in 800+utility sites.
    • 🍰 Support SEO.
    • 🍰 It is completely static and provides automatic deployment functions.
    • 🍰 The trigeminal tree has a clear structure and clear classification.
    • 🍰 Support one website to associate multiple URLs
    • 🍰 The coexistence of beauty and simplicity is no longer the era of killing Matt.
    • 🍰 Completely open source, easy to customize.
    • 🍰 Support multiple browsing modes and innovation.
    • 🍰 Support footprint memory.
    • 🍰 Support mobile browsing.
    • 🍰 Support search query.
    • 🍰 Support custom engine search.
    • 🍰 A variety of theme switching.
    • 🍰 Support dark mode.
    • 🍰 Support background management, no need to deploy.
    • 🍰 Support import from Chrome bookmarks
The newer version already support English and Chinese language and also has a new backend system portal. 

Fork the current project

Original Github Repository: https://github.com/xjh22222228/nav
My Github Repository: https://github.com/51sec/nav, which has a translation to Enligh based on an old version which was not have english at that time. It is still working fine but missing the new backend system management portal. 

Apply token

Go to https://github.com/settings/tokens apply for a token, check the corresponding permissions, if you don’t understand, select all, copy and save the token.

Add application token

https://github.com/username/nav/settings/secrets/actions/ new add application token, name fill in TOKENuppercase.

Enable Actions

Modify Configuration File

Be sure to modify the project configuration file nav.config.ts, especially the gitRepoUrl. You will have to change the default value to your own github repository url. 

Other settings can be left as default. In the latest release from https://github.com/xjh22222228/nav, most of options can be changed from backend system portal. 

import { IConfig } from './src/types'

const c: IConfig = {
// [
Mondatory], Please replace following Github url with your own Github address which you forked in.
gitRepoUrl: '
https://github.com/51sec/nav',

// Deployment branch name
branch: 'main',

// If routing is hash mode. if it deployed into github pages or using Vercel, it has to be set to true
hashMode: true,

// is it displaying the Github icon on top right corner of the web page
showGithub: true,

// what is your website address. It is good for your SEO
homeUrl: 'https://nav3.cn',

// Web Site Tiltle
title: 'Discovery Navigation - Featured and useful navigation websites',

// Web Site description
description: 'Discovery Navigation - Featured and useful navigation websites - English',

// Web Site Keyword
keywords: 'Navigation, front-end resources, community sites, designers, practical tools, learning resources, operations, network security, node.js',

// Default Theme: Light | Sim | Side | App | Shortcut
theme: 'Light',

// The content at the bottom of the website, copyright information, record number, can be HTML
footerContent: `
<div style="font-weight: bold;">Total collected /${total} websites </div>
<div>Copyright © 2018-2021 nav3.cn, Translated by 51sec.org. All Rights Reserved</div>
`,

// Alibaba icon https://www.iconfont.cn/
// IT will be used to show side theme's topic one level and second level menu icons Side 主题一级、二级菜单图标展示
iconfontUrl: '//at.alicdn.com/t/font_2522843_wl70o31sy6.js',

// Baidu statistics
// https://tongji.baidu.com/web/welcome/login
//baiduStatisticsUrl: 'https://hm.baidu.com/hm.js?4582be7af7e7c95ef75351e07c6c32ba',

// CNZZ statisitics
// https://www.cnzz.com/o_index.php
cnzzStatisticsUrl: '',

// Sim Theme Configuration
simThemeConfig: {
// Post Image
posterImageUrls: [
'https://raw.sevencdn.com/xjh22222228/nav/image/sim-wallpaper.jpg'
],
description: 'Here collected total <b>${total}</b> websites, helping your work, life and studying'
}
}

export default c

Test

After 5 minutes, open https://51sec.github.io/nav and you will see a very powerful navigation website.

Old Backend: admin
Old version will have + icon to directly get into backend admin portal. For new version, it gets rid of this +icon, you will have to modify the URL address to system, such as: https://nav.51sec.org/#/light Change to https://nav.51sec.org/#/system. Old admin portal is still working on this url:  https://nav.51sec.org/#/admin 

New BackEnd: System

Everytime, there is a change saved, it will take Github actions 5 minutes to complete all tasks. Please be patient before you save another change. 
If Github system is busy in completing previous tasks. you might got following error message:
Error: Request failed with status code 409.

CNAME Settings on Cloudflare

Option: Reverse Proxy Settings on Nginx


# nginx

server {
listen 80;
server_name nav.51sec.org;

location / {
proxy_pass https://51sec.github.io/nav/;
}
}
:


ghp_ayqmYrPEKw8eDCbXwt0MEK4PwFituma35j6wF1
ghp_QqM3D6IdNkhx9v4Yxxe7DD1HHUwbM0L4YXyl42

References

  • https://github.com/xjh22222228/nav
  • nav.51sec.org
  • https://github.com/WebStackPage/WebStackPage.github.io

版权声明:
作者:siwei
链接:https://www.techfm.club/p/36232.html
来源:TechFM
文章版权归作者所有,未经允许请勿转载。

THE END
分享
二维码
< <上一篇
下一篇>>