The menus in Aurora theme can be highly customized in the theme
# Default Menus
Aurora is packed with three styled pages, about page, tags page and archives page.
Home page and About page are enabled by default, where tags page and archives page can be configured in the
menu section of the theme config file.
menu: About: false Tags: true Archives: true
You can also set any of the above to
false to disable certain page you don't want.
# Custom Menus
Other than the default pages packed with Aurora, we can also add in any pages or external links to our main menus.
# External Link
For example, if we want to add a external link to your github project, you can do that by configuring your menu like this:
menu: Tags: true Archives: true # External link for a github repo Aurora: name: 'Aurora' path: 'https://github.com/Aurora/hexo-theme-Aurora'
v1.4.3, external link also supports
mailto links. Which will bring your user to their email page for sending out an email.
menu: Tags: true Archives: true # External link for a github repo Email: name: 'Mail Me' path: 'mailto:email@example.com'
# Nested Links
Sometime you would want to group a set of links into a sub-menu. The good news is Aurora also support nested links. To create a nested link, all we have to do is add in a
children property to the menu.
For example we want to have a projects menu, which include all the projects links as sub-menu links. This is how you would configure it:
menu: Tags: true Archives: true # Nested projects menu projects: name: 'Projects' children: obsidian: name: 'Obsidian Theme' path: 'https://github.com/tridiamond/hexo-theme-obsidian' Aurora: name: 'Aurora Theme' path: 'https://github.com/Aurora/hexo-theme-Aurora'
The parent link of a nested link won't need a
path property, because if it's clicked it will not activate a page jump.
Even if you set a
path for the parent link, the path link will be ignored.
# Internal Link
Internal links can be added with a custom page. Please refer to the Page section of the document for usage details.
# I18n Menu
Since the theme has I18n multi-language support, therefore the menu name also support multi-language setup. So far the theme support English and Chinese translations for the menu. (Will support more in the near future.)
To setup multi-language for the menu, all we have to do is configure the
This property has 2 options:
cn- for Chinese
en- for English
For example you want to add a menu call
contact, this is how to want to configure it.
menu: Tags: true Archives: true # Multi-language Contact menu contact: name: 'Contact' i18n: cn: '联系我' en: 'Contact' path: 'http://domain.com/contact'