VuePress 側邊欄的具體使用
前言
官網(wǎng)寫的側邊欄教程真的是讓人很糟心,經(jīng)過一番摸索,總算大致弄清楚了,下面詳細說一下用法:
目錄結構:
docs根目錄下有一個README.md、chinese文件夾、english文件夾
最簡側邊欄:
sidebar: { '/language/chinese/': [ '', //該目錄下的README.md文件 'a', //該目錄下的a.md文件 'b' //該目錄下的a.md文件 ], '/language/english/': [ '', ], },
chinese文件夾下的側邊欄:
english文件夾下的側邊欄:
可以看到,側邊欄效果出來了,但是我們看官網(wǎng)上的效果:
側邊欄上邊有分組,圖上的側邊欄分成了兩組,這里就是側邊欄分組了
側邊欄分組
我們把chinese文件夾下的README.md分到Group1,a.md、b.md分到Group2:
sidebar: { '/language/chinese/': [ { title: 'Group1', //組名 children: [''], //該分組下要顯示的文件的目錄 }, { title: 'Group2', children: ['a','b'], }, ], '/language/english/': [ '', ], },
可以看到分組成功,可以發(fā)現(xiàn),每個md直接顯示了它的一二級標題,如果我們想除了顯示文件中的一二級標題,還顯示這篇md文件的文件名(或指定的其他名字),比如下面這種效果:
該怎么做呢?官方給了這樣一個例子,用一個數(shù)組來指定路徑和名字:
我們嘗試一下:
sidebar: { '/language/chinese/': [ { title: 'Group1', //組名 children: [ ['', 'chinese'] ] }, { title: 'Group2', children: [ ['a', 'A'], ['b', 'B'], ], } ] }
結果卻是:
可以看到它只是改了一級標題的名字,并沒有額外增加一個名字,還有其他方法嗎方法肯定是有的。
顯示文件名(或其他指定名字)
方法1
最簡單的做法就是md文件中,把一級標題的名字改為我們指定的名字,這樣做的壞處就是一級標題只能在這個md文件中使用一次,(推薦使用該方法)
可以看到再一個一級標題沒有出現(xiàn)在側邊欄中
方法2
給這個文件添加分組,添加一個分組名,即一個md文件就是一個分組,然后再用大分組,把這些小分組括起來。
小分組
我們給README.md添加名為chinese的分組:
{ title: 'chinese', children: [‘'], },
給a.md添加名為A的分組
{ title: 'A', children: [‘a(chǎn)'], },
給b.md添加名為B的分組
{ title: 'B', children: [‘b'], },
大分組:
把chinese假入大組Group1:
{ title: 'Group1', children: [ { title: 'chinese', children: [''], }, ], },
把A、B加入大組Group2:
{ title: 'Group2', children: [ //小組A { title: 'A', children: ['a'], }, //小組B { title: 'B', children: ['b'], }, ], },
完全代碼:
sidebar: { '/language/chinese/': [ //Group1 { title: 'Group1', children: [ { title: 'chinese', // 必要的 children: [''] } ] }, //Group2 { title: 'Group2', children: [ //小組A { title: 'A', children: ['a'], }, //小組B { title: 'B', children: ['b'], }, ], }, ], },
顯然,這樣寫起來眼花繚亂,因此推薦方法一。
到此這篇關于VuePress 側邊欄的具體使用的文章就介紹到這了,更多相關VuePress 側邊欄內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
vue 動態(tài)給每個頁面添加title、關鍵詞和描述的方法
這篇文章主要介紹了vue 動態(tài)給每個頁面添加title、關鍵詞和描述的方法,本文通過實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-08-08