问题标签 [vuepress]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
vuepress - Vuepress:如何根据部署目标切换 config.js?
如何根据目标切换 config.js?例如,如果部署到本地主机,我会将 config.js 中的dest:参数设置为public:
或者,作为netlify的dist
vue.js - Vue Press Github Pages .md 文件不起作用
错误报告
重现步骤嗨,我在将 Vue Press 文档部署为我的私有 Github 存储库的一部分时遇到了问题。我无法提供演示 URL,因为它可能与 Vue Press 或 Github 链接,也可能不链接。
我使用vue create
命令生成了一个 Vue JS 项目,我在顶部添加了 Vue p11n 模块,因为这是我正在制作的插件。
我已经在该docs/
文件夹下创建了我的 Vue Press 文档,并且在本地一切正常。我没有触及配置文件,因为这里的一切都在工作。
我有几个文件:
- 自述文件.md
- 安装.md
- 需求.md
- 选项.md
这些位于 下docs/
,然后.vuepress
是 docs 目录中的文件夹。
文档网址:https ://stsonline.github.io/vue-les-application/
我的 github 仓库是私有的,而且必须是私有的。
期望什么?Github 页面上的文档应该按照本地副本加载,侧边栏应该可以正常工作,并且导航链接应该可以工作。
实际发生了什么?当我将更改推送到 repo 时,我的 github 页面 url 似乎只加载 README.md 文件,而其他所有内容都不起作用,例如:无法访问这些页面。
我的回购网址示例是:https://stsonline.github.io/vue-les-application/
单击“开始”链接时,它应该链接到安装页面,但侧边栏导航也不会丢失。
但是,在本地运行,一切都很好,包括可爱的绿色主题。
我错过了什么?
我必须保留一个父docs/
文件夹,因为这是用于 Github 页面的文件夹,我不能使用父dist/
目录。话虽如此,Vue Press 似乎是在 docs 目录中构建的。
我的docs/.vuepress/config.js
文件:
我docs/.vuepress/plugin.j
的文件:
[x] 我的 VuePress 版本低于且相同
1.0.0-alpha.47
:- VuePress 版本:1.0.0-alpha.48
- 操作系统:Mac 操作系统
- Node.js 版本:不适用
- 浏览器版本:Chrome 最新版本
- 这是全局安装还是本地安装?不适用
- 您使用哪个包管理器进行安装?新PM
- 禁用所有插件时是否会出现此问题?是的
[ ] 我的 VuePress 版本高于
1.0.0-alpha.47
,以下是npx vuepress info
我的 VuePress 项目中的输出:
javascript - 远程应用服务器后面的 Vuepress 为带有 iframe 的页面提供 404
我用Vuepress 建立了一个静态网站,该网站有一个完整的iframed Tableau仪表板部分。当我通过 Internet 公开网站时,我没有任何问题,一切正常,Tableau 仪表板显示正常。
当网站作为远程应用程序在公司的防火墙后面发布时,问题就开始出现了。本质上,它前面有一个身份验证层,URL 从https://mywebsite.mycompany.com
到https://privateapps.mycompany.com/https/mywebsite.mycompany.com
第一个问题是当它登陆主页时,它会立即重定向到 Vuepress 的 404 页面,如果我点击刷新它会正确显示,并且所有页面都可以正常工作,除了带有 Tableau iframe 的页面,所有这些页面都会自动重定向到 404页。
我认为这可能是 SSR 不匹配,所以我尝试了vuepress-plugin-dehydrate选项没有改变,noSSR
但是当我应用noScript
选项时,仪表板页面上的错误消失了,但 iframe 不再起作用,因为我的理解是,此选项会删除所有js
文件,从而使 iframe 有效地无用...
发生了某种奇怪的重定向冲突,但我不知道如何解决它,我还尝试添加location
到我的 nginx 配置中,认为 nginx 的路由与站点的路由冲突,但那里也没有骰子。
在远程应用程序后面时,我也会在页面上收到此警告 - 不确定它是否相关。
无论如何,我已经尝试了我能想到的一切,但我的想法已经不多了。对此的任何帮助都会非常好。
javascript - 如何解开 Vue DOM 元素并保留其位置
我正在使用 VuePress,它将 Markdown 生成为 HTML。每个 Markdown 元素都在<p>
标签内呈现。但是,我想通过<p>
在包含图像或视频时解开标签来修改生成的 HTML 文档。
我已将代码添加到mounted()
页面(组件)的 Vue 生命周期挂钩中。
这有效:当我首先访问另一个页面时,未包装的内容出现在与其父页面相同的位置。
这不起作用:直接访问页面,内容出现在页面上其余 Markdown 内容的下方。不在原来的位置。
要求:
- 展开的内容(img、视频)应该正好出现在父内容原来的位置,而不是在所有其他内容的下方。
- 当直接访问组件并导航到时,这应该可以工作。
- 不依赖 jQuery
nested - 是否可以在 vuepress 中有子路线和路线视图?
我试图在我的主页中有一个儿童路线视图,但在 vuepress 中找不到实现这一点的方法。
这就是我通常在 Vue 中的 router.js 中完成此操作的方式
但是我不知道在哪里可以将这样的代码放在 vuepress 中。(没有router.js)
我正在尝试完成此操作,因为我试图在我的主页中拥有一组链接,并且在单击时,我希望将这些链接的页面呈现为模式而不转到新页面。但我想保留直接链接到这些模式的能力。
netlify - Netlify:如果此文件夹上的更改部署到不同的存储库(?)
这是场景:
我在 Github 上有两个 Vuepress 网站存储库,使用 NetlifyCMS 并在 Netlify 上进行部署,每个存储库用于不同的网站。
站点 1:guidesABC.blah.com -> RepositoryABC
站点 2:guidesA.blah.com -> RepositoryA
指南 A 在两个存储库中。
有没有办法可以使用 Netlify 上的函数来检查更改是否在文件夹 A 上完成,更改是否也发生在 RepositoryA 上?
我不想做的是去guideABC上的站点/管理员-对*md文件进行更改,发布并在站点guideA上执行相同的操作复制和粘贴代码。
谢谢你
vue.js - 如何以正确的方式在 Nuxt 项目中添加 Vuepress?
我有我的 Nuxt 应用程序,我正在尝试在其上添加 Vuepress。然后我确实yarn add vuepress@next -D
在其中创建了docs
文件夹和readme.md
文件。
问题:如果文件夹.vuepress
在文件夹之外,docs
项目只会显示侧边栏和导航栏;如果它在里面,它就不起作用 - 不尊重 config.js 规则。
此外,它识别来自 Nuxt 应用程序的 readme.md(也在 docs 文件夹之外),而不是 docs 文件夹中的那个。
任何人都可以帮助我吗?
另一个问题,如果上述方法有效,我是否能够通过 Nuxt 项目和文档访问localhost:3000/docs
而不是访问?localhost:3000
localhost:8080
这是我当前的文件夹结构(没有显示侧边栏 - 不尊重 .vuepress 文件夹中的 config.js):
config.js 文件:
Vuepress 版本 1.0.2
谢谢。
vuejs2 - Vuepress:让侧边栏在单个页面中工作
我使用以下文件夹树创建了一个非常简单的 vuepress 项目:
我有一些带有符号和一些文本README.md
的降价标题。#
我只想在左侧获得一个带有标题链接的侧边栏。
为此,我设置config.js
如下:
此外,在自述文件页面的开头我有一个元数据部分,内容如下:
如果我添加其他类似的主题内容,则页面显然会获得默认的主题features
样式和行为,它可以按预期工作。
但是,左侧没有带有链接的侧边栏。
我错过了什么?
vue.js - 带有 Okta 身份验证的 Vuepress - 构建期间未定义窗口
我一直在按照此处找到的教程向我的 vuepress 站点添加身份验证。在开发模式下运行时,这一切都很好,但是当我尝试构建我的应用程序时,我收到以下错误:
这使我无法部署我的网站。这个问题是在我包含 Okta vue sdk 之后开始的。
我的 enhanceApp.js 如下:
javascript - VuePress:试图找到一种基于文件夹版本命名自动更新侧边栏的方法
我正在尝试创建一个文档站点,使开发人员可以轻松地对事物进行版本控制,而不必手动更新侧边栏。例如,我有一个版本切换下拉菜单,可以让用户选择一个版本。我希望侧边栏反映路径更改,以便用户看到该版本的文档,而不是/master/
始终是最新版本的文档。
我目前正在将这种方法用于我正在处理的部分工作(版本切换和文档记录releases.json
)。
以下是我目前拥有的示例。因此,为了让开发人员创建一个新版本,他们会将整个master
目录复制到名为 like的目录v1.1.5
中,在包含的 markdown 文件中进行内容更改,然后当用户切换版本时,children
路径将反映该更改。
因此,在通过下拉菜单更改为另一个版本时,它会将一个项目更改为类似/v1.1.5/getting-started/concepts
.
有没有办法在 VuePress 中做到这一点?我在想也许 URL 的版本段可以保存在某个地方,比如在 Vuex 中,但我不确定最好的方法。即使 URL 与其版本是相对的而不是绝对的,也可能会起作用。