vuepress打包之后页面样式丢失问题的两种解决方式

 更新时间:2024年07月01日 11:05:46   作者:YOGiii  
这篇文章主要介绍了vuepress打包之后页面样式丢失问题的两种解决方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

问题描述

最近打算使用vuepress为公司项目集成一下前端开发文档,在打包的时候遇到了样式丢失的问题,在网络上参考了一些解决方案,记录一下自己遇到的问题

1.集成打包之后,打开入口文件展示页面如下:

样式丢失问题

样式丢失问题

2.在本地直接运行的页面是没有问题的,

如图,只是打包之后样式丢失:

本地运行项目

3.关于打包的dist文件目录结构如下:

dist
    │  404.html
    │  index.html // 入口文件
    │
    ├─assets
    │  ├─css
    │  │      0.styles.3294b3f2.css
    │  │
    │  ├─img
    │  │      search.83621669.svg
    │  │
    │  └─js
    │          2.733019b2.js
    │          3.b92b6444.js
    │          4.fc333d27.js
    │          5.d58e9858.js
    │          6.2d0a63f8.js
    │          7.9c9172a7.js
    │          8.9e1014e2.js
    │          app.972414f3.js
    │
    └─guide
            index.html

解决方案

解决方案有两种,可以自行选择,vuepress我安装的版本如下,vuepress的路由模式写的是history模式,所以解决方案主要是面向两种不同模式(hash / history)

"vuepress": "^1.9.9"  // 我安装的时候最新版本是1.9.9,^符号表示每次install都升级到最新版本

方案一 hash模式

1.修改依赖文件更改路由模式:在依赖文件夹node_modules下找到@vuepress,打开如图所示的app.js文件夹,将文件夹中的mode:history注掉,使用默认的hash模式

修改文件

注释代码

2.修改vuepress的config.js文件,主要更改的是base的这个配置项,base配置项在官网已经说得很明白了,可以去看一下,由于配置的默认base是’/‘即根目录,从根目录直接读取样式文件自然是找不到的,所以在这里改成相对路径’./’

config.js文件

module.exports = {
  title: '开发文档',
  description: '开发文档',
  base: './', // 使用相对路径,读取相对路径下的静态文件
};

打包,本地访问入口文件,样式没有丢失的问题,发布到服务器上样式也正常,问题解决。

方案二 history模式

考虑到在实际开发中,多人维护文档,每个人都去改vuepress的路由模式有点麻烦,所以只需要修改config.js文件的base配置项即可

module.exports = {
  title: '开发文档',
  description: '开发文档',
  base: '/project-docs/', // project-docs可以随意更改,主要看自己的文件放在服务器上的文件路径 
};

比如nginx配置的location如下, 那么我们通过服务端口去访问的时候,找的是根目录html下的project-docs文件夹读取对应的静态文件

location /project-docs {
            root html;
            index index.html index.htm;
        }

修改完成后直接进行打包,在本地访问index.html还是会样式丢失的,但是问题不大,放上服务器后就可以正常访问了。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Vue预览图片和视频的几种实现方式

    Vue预览图片和视频的几种实现方式

    本文主要介绍了Vue预览图片和视频的几种实现方式,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • Vue CLI中模式与环境变量的深入详解

    Vue CLI中模式与环境变量的深入详解

    模式是 Vue CLI 项目中一个重要的概念,下面这篇文章主要给大家介绍了关于Vue CLI中模式与环境变量的相关资料,需要的朋友可以参考下
    2021-05-05
  • vue计算属性想要传入参数如何解决

    vue计算属性想要传入参数如何解决

    这篇文章主要介绍了vue计算属性想要传入参数如何解决问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-01-01
  • vue中使用protobuf的过程记录

    vue中使用protobuf的过程记录

    由于目前公司采用了ProtoBuf做前后端数据交互,进公司以来一直用的是公司大神写好的基础库,完全不了解底层是如何解析的。下面小编给大家分享vue中使用protobuf的过程记录,需要的朋友参考下吧
    2018-10-10
  • Vue自定义指令实现对数字进行千分位分隔

    Vue自定义指令实现对数字进行千分位分隔

    对数字进行千分位分隔后展示应该是大部分同学都做过的功能了吧,常规的做法通常是编写一个工具函数来对数据进行转换,那么我们可不可以通过vue指令来实现这一功能呢,下面我们就来探索一下呢
    2024-02-02
  • 通过图带你深入了解vue的响应式原理

    通过图带你深入了解vue的响应式原理

    这篇文章主要介绍了通过图带你深入了解vue的响应式原理,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,
    2019-06-06
  • vue3.0透传属性和事件的使用方式举例

    vue3.0透传属性和事件的使用方式举例

    这篇文章主要给大家介绍了关于vue3.0透传属性和事件使用的相关资料,透传attribute指的是传递给一个组件,却没有被该组件声明为props或emits的attribute或者v-on事件监听器,需要的朋友可以参考下
    2024-01-01
  • 聊聊vue生命周期钩子函数有哪些,分别什么时候触发

    聊聊vue生命周期钩子函数有哪些,分别什么时候触发

    这篇文章主要介绍了聊聊vue生命周期钩子函数有哪些,分别什么时候触发?具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • 如何启动node.js文件的3个方法

    如何启动node.js文件的3个方法

    这篇文章主要给大家介绍了关于如何启动node.js文件的3个方法,文中通过图文以及实例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2023-07-07
  • Vue路由跳转方式区别汇总(push,replace,go)

    Vue路由跳转方式区别汇总(push,replace,go)

    vue项目中点击router-link标签链接都属于声明式导航。vue项目中编程式导航有this.$router.push(),this.$router.replace(),this.$router.go()​​​​​​​。这篇文章主要介绍了Vue路由跳转方式区别汇总(push,replace,go)
    2022-12-12

最新评论