# VuePress 2 Default Theme +

This extends the [default VuePress 2 theme](https://v2.vuepress.vuejs.org/reference/default-theme/config.html#basic-config) with some extra power and features such as:

* Easily distributable default config sets and shared navbar items
* Additional `containers` to help spruce up your Markdown
* Google Analytics/Tag Manager support
* HubSpot tracking code support
* Automatic metatag generation
* Features to help combining different docs sites into a single coherent docs experience
* `Docsearch` support
* Customizable `SidebarHeader` header for more larger and more complex sites
* Automatically generated and customizable _Previous Versions_ page
* Automatically generated and customizable _Contributorz_ page
* Additional `Guide` page type
* Additional global components for `YouTube` and `MailChimp`
* `robots.txt` and `sitemap.xml` generation
* [CarbonAds](https://www.carbonads.net/) support

Note that autogeneration of contributors and versioning information currently only works with GitHub. You can, however, manually populate these values for other VCS for now.

## Docs

* [Overview](https://vuepress-theme-default-plus.lando.dev/)
* [Getting Started, Installation and Usage](https://vuepress-theme-default-plus.lando.dev/getting-started.html)
* [Configuration](https://vuepress-theme-default-plus.lando.dev/config.html)
* [Guides](https://vuepress-theme-default-plus.lando.dev/guides.html)
* [Examples](https://github.com/lando/vuepress-theme-default-plus)
* [Development](https://vuepress-theme-default-plus.lando.dev/development.html)

## Issues, Questions and Support

If you have a question or would like some community support we recommend you [join us on Slack](https://launchpass.com/devwithlando). Note that this is the Slack community for [Lando](https://lando.dev) but we are more than happy to help with this module as well!

If you'd like to report a bug or submit a feature request then please [use the issue queue](https://github.com/lando/vuepress-theme-default-plus.lando.dev/issues/new/choose) in this repo.

## Changelog

We try to log all changes big and small in both [THE CHANGELOG](https://github.com/lando/vuepress-theme-default-plus/blob/main/CHANGELOG.md) and the [release notes](https://github.com/lando/vuepress-theme-default-plus/releases).

## Releasing

To deploy and publish a new version of the package to the `npm` registry you need only [create a release on GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) with a [semver](https://semver.org) tag.

Note that prereleases will get pushed to the `edge` tag on the `npm` registry.

## Contributors

<a href="https://github.com/lando/vuepress-theme-default-plus/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=lando/vuepress-theme-default-plus" />
</a>

Made with [contributors-img](https://contrib.rocks).

## Other Resources

* [Important advice](https://www.youtube.com/watch?v=WA4iX5D9Z64)