Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Page TOC and search in the content #1750

Open
reanim8ed opened this issue Aug 6, 2019 · 8 comments
Open

Page TOC and search in the content #1750

reanim8ed opened this issue Aug 6, 2019 · 8 comments
Labels
type: feature request Request to add a new feature

Comments

@reanim8ed
Copy link

reanim8ed commented Aug 6, 2019

Feature request

I would like to migrate my wiki from Gitbook and VuePress is one of my main options, especially because of the speed. But I'm missing a couple of important features and without them usefulness of the wiki is redused greatly:

What problem does this feature solve?

TOC - currently Table Of Contents is implemented as markdown extension but it places TOC in the content itself. Then the page is really long it's not convienent to scroll all the way to the top to access it. It would be better UX to implement it like additional sticky sidebar which would be easily accessible no matter where in the page the user is.

Search - most of the times then I'm searching, the keyword is not in the heading but in the content. Current search works great but because it doesnt include results from the content it's much less useful.

What does the proposed API look like?

N/A

How should this be implemented in your opinion?

There should be a global option for single page TOC which could toggle the showing of the page TOC sidebar. [[toc]] shortcode shouldn't be neccesary anymore.

Are you willing to work on this yourself?

I'm not a Vue developer

@ulivz ulivz added the type: feature request Request to add a new feature label Aug 7, 2019
@nkhdo
Copy link

nkhdo commented Aug 8, 2019

Anyone on this? Or can I take it?

@lunaceee
Copy link

Hi @nkhdo , I had success adding a global table-of-contents on my VuePress site and I'd be happy to implement the feature. I'll come up with some descriptions to the proposed API section shortly.

@kefranabg
Copy link
Collaborator

For a full text search, you can use https://vuepress.vuejs.org/theme/default-theme-config.html#algolia-docsearch

@kefranabg
Copy link
Collaborator

Feel free to open a PR for the side bar toc feature

@ghana04
Copy link

ghana04 commented Mar 19, 2020

Any updates on this?

@josx
Copy link

josx commented Mar 26, 2020

@kefranabg i think we dont have to relay on 3er party provider/website to do search.
Would be much better to have a plugin to do it.

@eblanshey
Copy link

This would be a wonderful addition, to move table of contents to a sticky sidebar on the right, and remove the table of contents from the left page navigation. Some other documentation generators have this out of the box, such as Docusaurus, and would be nice to have it available here as well.

@rexwangcc
Copy link

rexwangcc commented Sep 25, 2020

Any updates on this, especially the right-side sticky ToC bar? I came across a custom theme which seems to be already supporting this feature. It would be really appreciated if it's provided out-of-box by default.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: feature request Request to add a new feature
Projects
None yet
Development

No branches or pull requests

9 participants