/Blog-Index

一个通用的个人网站的引导页、导航页模板

Primary LanguageVue

EsunR-Blog 通用网站导航

本项目是学习过程中的产物,没想到会有这么多人的喜欢与支持,由于代码老旧,不会再考虑后期的更新了。

但是,本项目仍有 Vue3 + Typescript 版本的开发计划,我会对其进行重构并优化代码结构,同时会在未来会加入 SSR 或预渲染的实现方案,完成后会将新的项目链接更新至本项目,敬请期待。

—— 2021.11.17 挖坑

About | 关于

这是一个基于 Vue 的通用网站导航页面,你可以将其放在个人网站的首页作为您博客的引导页面或者是您其他项目的引导页。兼容了多平台的显示效果(基于Flex布局),方便游客浏览您的个人网站,背景图来自于Bing每日图片。

页面分为两部分,一个是全屏的展示页,一个是导航抽屉页,阅读下面的“使用方法”来为您的网站配置基本信息与导航信息,点击查看网站示例(租不起服务器了,网站暂时在想办法迁移)

How to use | 使用方法

安装依赖:

npm install # 如果安装出错请使用cnpm安装

开发模式:

npm run serve

本项目中,提供了两种使用方法:

一种是只需要将网站的相关信息按要求填入配置文件,之后再编译整个项目就可以生成一个适用于你的网站的静态导航页面;

另一种则是为页面添加后台数据支持,详情请参阅下文的第2步。

1. 配置信息

/src/config.js 存放了项目的基本配置信息,配置示例如下:

const SERVE = true; // 是否使用线上服务器

const HOST = "https://esunr.xyz:8080/api/esunrIndex"; // 线上服务器地址,如果不使用请留空

const BLOG_NAME = "EsunR-Blog"; // 个人网站名字

const BLOG_URL = "https://www.esunr.xyz/blog/"; // 个人网站链接(请填写完整链接)

const GITHUB = "https://github.com/EsunR"; // 右上角 Github 图标链接,留空不显示

const BACKGROUND_IMG_URL = ""; // 背景图片url,留空默认为必应每日图片

const SORT_DATA = [
  { sortId: 1, title: "示例分类1" },
  { sortId: 2, title: "示例分类2" }
]; // 网站分类列表,请按照API.md中'/getSort'接口中返回的data格式填写

const RECORD_NUMBER = ""; // 网站备案号,留空不显示

const PAGES_DATA = [
  {
    pageId: 1,
    sortId: 1,
    title: "主标题",
    subtitle: "副标题",
    url: "http://www.YourWebPage.com/",
    icon: ""
  },
  {
    pageId: 2,
    sortId: 2,
    title: "主标题",
    subtitle: "副标题",
    url: "http://www.YourWebPage.xyz/",
    icon: ""
  }
]; // 网站分类列表,请按照API.md中'/getPages'接口中返回的data格式填写

const SLOGAN = [
  "欢迎拜访",
  "歡迎拜訪",
  "Welcome, my friend!",
  "訪問へようこそ",
  "嗨,别来无恙",
  "不忘初心,一生浪漫",
  "最近还好吗?",
  "流星,落花,萤火",
  "马车越空,晃荡越响"
]; // 在Logo下方显示的标题

const FOOTER_INFO = true; // 是否显示抽屉右下角的文字信息

另外在编译前,你需要将 /src/assets/logo.svg 替换为你的网站LOGO,注意格式必须为 svg 文件,同时将 /oublic/favicon.ico 替换为你网站的 favicon。

2. 添加服务器支持(可选)

如果想要使用后台服务器来加加载和管理数据,请将 SERVE 设置为 true 并将 HOST 填写为你的服务器接口地址,这样前台页面就会使用Ajax来向你添加的服务器地址来请求数据。同时你需要按照 API.md 规范来编写后台API接口,以及按照 DataBase.md 规范来创建数据库。

连接后台后则无需填写 config.js 中的 PAGES_DATASORT_DATA 数据。

3. 编译

确保已安装 npm 以及安装好了项目依赖之后运行:

$ npm run build

生成的文件将存放在 /dist 目录下,Enjoy!

Log | 更新日志

2020.06.20:

  • 修复:移除 Store 层的残余代码

2020.03.29:

  • 优化:移除了 yarn 安装方式
  • 优化:移除了 Vuex
  • 修复:替换了获取必应每日图片的 api
  • 新增:支持添加个人网站备案号
  • 新增:集成 Better-Scroll,使抽屉页面可以上下滑动
  • 变更:抽屉打开后,取消了下滑关闭抽屉的操作手势(因为会与抽屉的滑动操作产生冲突)