Sidebar

NexT User Docs – Theme Settings – Sidebar

By default sidebar only shows in posts (have a table of content), and is placed in left side. You can change it by editing values under sidebar setting in theme config file.

Sidebar has several options, but for now we will consider position, width, display, offset, onmobile and dimmer options.

Set up sidebar position by changing the value of sidebar.position, which can be one of following:

  • left → Place at the left of the screen.
  • right → Place at the right of the screen.

next/_config.yml
1
2
3
sidebar:
  position: left
  #position: right


For now only Pisces / Gemini Schemes supports position setting under 6.0.x version or highter.


You can change sidebar width by specify sidebar.width setting in pixels, for example:

next/_config.yml
1
2
sidebar:
  width: 300

This option commented out by default and values are:

  • For Muse | Mist schemes: 320
  • For Pisces | Gemini schemes: 240


From version 6.0.4 to 6.3.0 option was called sidebar_width and was available for Gemini Scheme only.
From 6.4.0 version or highter, option renamed to sidebar.width and available for all schemes.


Set up conditions under which sidebar will show by editing sidebar.display value, which can be one of following:

  • post → Show sidebar only in posts which have index.
  • always → Show sidebar in all pages.
  • hide → Hide it in all pages (but can be opened by user manually).
  • remove → Remove sidebar totally.
next/_config.yml
1
2
3
4
5
sidebar:
  display: post
  #display: always
  #display: hide
  #display: remove

Set up sidebar offset from top menubar in pixels by changing the value of sidebar.offset, which can be one of following:

next/_config.yml
1
2
sidebar:
  offset: 12

For now only Pisces / Gemini Schemes supports offset setting under 6.0.x version or highter.


Set the value sidebar.onmobile to true to enable sidebar on narrow view for mobile device as following:

next/_config.yml
1
2
sidebar:
  onmobile: true

For now only Muse / Mist Schemes supports onmobile setting under 6.0.x version or highter.


Set the value sidebar.dimmer to true to enable the feature: click any blank part of the page to close sidebar.

next/_config.yml
1
2
sidebar:
  dimmer: true

For now only Muse / Mist Schemes supports dimmer setting under 7.0.x version or highter.


By default NexT shows the categories and counts of Posts / Categories / Tags in sidebar. You can configure it by editing values in site_state section in theme config file.

next/_config.yml
1
site_state: true

Social Links have similar fucture as Menu Items, only target link there is difference: specified link must have full url path (permalink).

Edit the social section in theme config file as following:

next/_config.yml
1
2
3
4
5
6
7
8
9
10
11
social:
  GitHub: https://github.com/yourname || github
  E-Mail: mailto:yourname@gmail.com || envelope
  Google: https://plus.google.com/yourname || google
  Twitter: https://twitter.com/yourname || twitter
  FB Page: https://www.facebook.com/yourname || facebook
  VK Group: https://vk.com/yourname || vk
  StackOverflow: https://stackoverflow.com/yourname || stack-overflow
  YouTube: https://youtube.com/yourname || youtube
  Instagram: https://instagram.com/yourname || instagram
  Skype: skype:yourname?call|chat || skype

By default NexT shows the icons of social links in sidebar.

You can configure it by editing values in social_icons.enable section in theme config file.

next/_config.yml
1
2
social_icons:
  enable: true

Set the value icons_only to true to display social icons without description in social_icons section in theme config file as following:

next/_config.yml
1
2
social_icons:
  icons_only: false

Set the value transition to true to display social icons with transition effects in social_icons section in theme config file as following:

next/_config.yml
1
2
social_icons:
  transition: false

You can add blog rolls within sidebar in NexT.

Edit the links section in theme config file and add your favorite links:

next/_config.yml
1
2
3
links:
  Title1: http://example1.com/
  Title2: http://example2.com/

By default NexT shows the link icon before links_title. The name of icon can be found in Font Awesome site. You can configure it by editing values in links_icon section in theme config file.

next/_config.yml
1
links_icon: link

By default NexT uses Links as the name of blogroll. You can configure it by editing values in links_title section in theme config file.

next/_config.yml
1
links_title: Links

By default all blogrolls are displayed in block. You can configure it to inline by editing values in links_layout section in theme config file.

next/_config.yml
1
2
links_layout: block
#links_layout: inline

By default NexT shows Table Of Contents (TOC) in the Sidebar. You can disable it by setting toc.enable to false in theme config file.

next/_config.yml
1
2
toc:
  enable: true

By default NexT adds list number to TOC automatically. You can disable it by setting toc.number to false in theme config file.

next/_config.yml
1
2
toc:
  number: true

If the post header width longer than sidebar width, you can wrap the header words in next lines by setting toc.wrap to true in theme config file.

next/_config.yml
1
2
toc:
  wrap: false

If you want all level of TOC in a post to be displayed, rather than the activated part of it, you can set toc.expand_all to true in theme config file.

next/_config.yml
1
2
toc:
  expand_all: false

By default maximum heading depth of generated toc is 6. You can set it by setting toc.max_depth to another number in theme config file.

next/_config.yml
1
2
toc:
  max_depth: 3

Back To Top

next/_config.yml
1
2
back2top:
  enable: true

Set the value back2top.enable to true to display Back to top button.

next/_config.yml
1
2
3
back2top:
  # Back to top in sidebar.
  sidebar: true

Set the value back2top.sidebar to true to put the button in sidebar.

next/_config.yml
1
2
3
back2top:
  # Scroll percent label in b2t button.
  scrollpercent: true

Set the value back2top.scrollpercent to true to display scroll percent label in Back to top button.