NavBar missing with Custom Layout

• I confirm that this is an issue rather than a question.

Bug report

I created my own custom component and placed it in the appropriate folder. I then called said component in my markdown file frontmatter using the syntax below:

---
title: Marketing Dashboards
layout: DashboardGallery
---

The component displays just fine but the navbar is gone which is contrary to what is indicated in the documentation (https://v1.vuepress.vuejs.org/theme/default-theme-config.html#custom-layout-for-specific-pages)

Am I missing something?

Version

vuepress@1.0.0-alpha.44 is the version I am on

Steps to reproduce

What is expected?

I should be seeing the navbar

What is actually happening?

It’s no visible with the custom layout

Other relevant information

• Your OS: MacOS Mojave 10.4
• Node.js version: npm: ‘6.4.1’
• Browser version: Chrome Version 72.0.3626.121 (Official Build) (64-bit)
• Is this a global or local install? global
• Which package manager did you use for the install? yarn
• Does this issue occur when all plugins are disabled? no idea

[kaceo]

I second better documentation and definitely more examples. At this moment I am still not entirely sure what is the layout: frontmatter actually doing, where that vue file should be placed, and how to chain it to the inherited components. Please explain differently for (1) someone writing a complete theme for export as an NPM and (2) someone wanting just to override a few special pages with local override templates, e.g. a carousel or a custom 404 page, and (3) someone who wants to write part of the site in vue single page format and how to define the frontmatter in vue instead of md. Browsing tutorials around the web is totally confusing particularly because of the 0.x to 1.x changes.

[shigma]

1. If you are using the default theme, you should provide navbar in your custom layout.

For example:

https://github.com/vuejs/vuepress/blob/dc524128647a5f8f576bbf4bdbfcb4cc291fec4a/packages/%40vuepress/theme-default/layouts/Layout.vue#L8-L11

1. Or you can create your own theme and use navbar in your GlobalLayout so that every layout will have a navbar.