淺談vuepress 踩坑記
vuepress是尤大大4月12日發(fā)布的一個(gè)全新的基于vue的靜態(tài)網(wǎng)站生成器,實(shí)際上就是一個(gè)vue的spa應(yīng)用,內(nèi)置webpack,可以用來寫文檔。恰好最近需要為一些組件寫文檔,就動手?jǐn)]了一波,畢竟剛發(fā)布,遇到不少坑,最終還是磕磕碰碰的運(yùn)行起來了,為了避免大家踩同樣的坑,特意將搭建的過程記錄下來,分享一波。
以下是幾個(gè)已知的問題
因?yàn)閡til.promisify是在node 8.0之后引入的,所以如果你不想像我一樣浪費(fèi)三個(gè)小時(shí)的時(shí)間,請查看并且更新node版本
建議不要使用webpack-simple的模板進(jìn)行試驗(yàn),否則會各種運(yùn)行不起來╮(╯▽╰)╭
使用cli的模板如果報(bào)錯(cuò)TypeError: Cannot read property 'vue' of undefined 是因?yàn)関uepress內(nèi)置的webpack的vueloader使用的版本和你本地的不一樣,請將本地的版本更新到穩(wěn)定最新版本
當(dāng)出現(xiàn)安裝官方文檔部署之后一直跳轉(zhuǎn)到404的情況時(shí),請使用路由的哈希模式來訪問
如遇到端口沖突等問題,在docs目錄下新建.vuepress文件夾,然后新建config配置文件對prot端口項(xiàng)進(jìn)行配置即可,具體可參照官方文檔
開始使用
使用cli新建一個(gè)webpack模板項(xiàng)目
//進(jìn)入項(xiàng)目首先安裝依賴 npm install //將vue-loader進(jìn)行版本替換,使其和vuepress內(nèi)置的webpack里的vue-loader保持一致,否則會報(bào)錯(cuò)(不過尤大大已經(jīng)在解決版本沖突的問題了,版本待發(fā)) npm update vue-loader@15.0.0-rc.2 --save-dev //接下來安裝vuepress npm install -D vuepress mkdir docs echo "# Hello VuePress!" > docs/README.md //最后一步啟動vuepress ,進(jìn)入docs目錄,使用vuepress dev命令即可 cd docs vuepress dev //使用vuepress build即可完成對項(xiàng)目的打包 //接下來就是按照官方的文檔,對你的網(wǎng)站進(jìn)行各種創(chuàng)造啦
項(xiàng)目部署的話我使用的是github,具體操作請參照官方文檔
剩下的主題配置參照官方文檔的配置詳解就OK了,這里就不在贅述
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- VuePress 中如何增加用戶登錄功能
- Vuepress 搭建帶評論功能的靜態(tài)博客的實(shí)現(xiàn)
- 如何使用VuePress搭建一個(gè)類型element ui文檔
- VuePress 快速踩坑小結(jié)
- 使用vuepress搭建靜態(tài)博客的示例代碼
- VuePress 靜態(tài)網(wǎng)站生成方法步驟
- Hexo已經(jīng)看膩了,來手把手教你使用VuePress搭建個(gè)人博客
- 基于vue-ssr的靜態(tài)網(wǎng)站生成器VuePress 初體驗(yàn)
- 基于VuePress 輕量級靜態(tài)網(wǎng)站生成器的實(shí)現(xiàn)方法
- Vue極簡生成器?Vuepress的實(shí)現(xiàn)
相關(guān)文章
elementui中的el-cascader級聯(lián)選擇器的實(shí)踐
本文主要介紹了elementui中的el-cascader級聯(lián)選擇器的實(shí)踐,文中通過示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2021-10-10基于Vue3和element-plus實(shí)現(xiàn)登錄功能(最終完整版)
這篇文章主要介紹了基于Vue3和element-plus實(shí)現(xiàn)一個(gè)完整的登錄功能,本文結(jié)合示例代碼給大家介紹的非常詳細(xì),對大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2023-03-03vue導(dǎo)入.md文件的步驟(markdown轉(zhuǎn)HTML)
這篇文章主要介紹了vue導(dǎo)入.md文件的步驟(markdown轉(zhuǎn)HTML),幫助大家更好的理解和使用vue框架,感興趣的朋友可以了解下2020-12-12Vue中的el-date-picker時(shí)間選擇器的使用實(shí)例詳解
el-date-picker是Element UI框架中提供的日期選擇器組件,它支持單個(gè)日期、日期范圍、時(shí)間、日期時(shí)間等多種選擇方式,本文給大家介紹Vue中的el-date-picker時(shí)間選擇器的使用,感興趣的朋友一起看看吧2023-10-10vue頁面離開后執(zhí)行函數(shù)的實(shí)例
下面小編就為大家分享一篇vue頁面離開后執(zhí)行函數(shù)的實(shí)例,具有很好的參考價(jià)值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-03-03vue 數(shù)據(jù)(data)賦值問題的解決方案
這篇文章主要介紹了vue 數(shù)據(jù)(data)賦值問題的解決方案,具有很好的參考價(jià)值,希望對大家有所幫助。一起跟隨小編過來看看吧2021-03-03el-table?fixed固定列導(dǎo)致錯(cuò)位的解決方法介紹
ElementUI中el-table設(shè)置指定列固定不動,不受滾動條影響,下面這篇文章主要給大家介紹了關(guān)于el-table?fixed固定列導(dǎo)致錯(cuò)位的解決方法,文中通過實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2022-11-11