Update upload-config.md

[website] / content / docs / user / getting-around.md

+++
title = "Getting Around and Finding Content"
date = "2022-12-12"
type = "user-doc"
slug = "getting-around"
+++

There are many ways to get around and find content within your BookStack instance
outside of following the core hierarchy. Below is an overview of some common options.

{{<toc>}}

### Book Sidebar

The book sidebar is visible when within a book, and it reflects the full ordered hierarchy 
of the book you are within. If you are within a chapter, that chapter will be expanded by
default otherwise they will be collapsed, and expandable with a click.

![View of the book sidebar showing child chapters and pages](/images/docs/user/getting_around_book_navigation.png)

### Next & Previous Links

When viewing a page or chapter, you'll find links below the main content that allow you to
navigate between the next & previous content within the current book.
These links will reflect sibling content, or the next item within the parent level if no adjacent content exists.

![View of the next & previous actions when viewing a page](/images/docs/user/getting_around_next_prev_links.png)

### Breadcrumbs

As you dive into your BookStack content you'll see breadcrumbs above 
the main content area to reflect the parent path of the current item.
These will begin with the "Books" page unless
you've traveled through the "Shelves" view in which case this would begin with
the "Shelves" view and parent shelf. 

![View of BookStack items, in a hierarchy, with arrows in between](/images/docs/user/getting_around_breadcrumb_nav.png)

You can click on breadcrumb items to navigate directly to those. You can also click the 
arrows between items to search and jump to orthogonal content within 
the structure hierarchy.

![Breadcrumb view with an arrow clicked, showing a popover element listing BookStack pages and chapters](/images/docs/user/getting_around_breadcrumb_dropdown.png)

### Search

A major way to find and jump to content is by using search.
There's the global search input in the header, where you can search across all content in your instance:

![View of the header search bar with a search started and relevant items listed](/images/docs/user/getting_around_search_preview.png)

When you start a global search, you'll get live feedback showing a preview of search results.
You can press enter or "View All" to view all relevant results on the search page.
Within the book and chapter views, you'll also find search inputs allowing you to search just within that book or chapter.

Find more information on our ["Searching Content"](/docs/user/searching/) page.

### Activity Lists

Many views, like that for a book or on the homepage, will show a list of
"Recent Activity", reflecting recent actions that have been made relevant to the
current context.
On these, you can click the name of the item within the listed activity to jump to that item.

![A list of user activity showing linked items names](/images/docs/user/getting_around_recent_activity.png)

### Recently Updated List

On the homepage you can find a "Recently Updated" list, showing the latest pages
to have been created or updated.
You can press "View All" to view a larger paginated list.

![A card section with title "Recently Updates Pages" with a list of pages below](/images/docs/user/getting_around_recently_updated.png)

### Favourites

One way to easily recall content is by adding it to your favourites.
You can choose to favourite any shelf, book, chapter or page to add it 
to your personal favourite collection. 
You can then easily find your favourites either as a list on the homepage
or via the "My Favourites" link in the header profile dropdown.

![A view of the "My Favourites" page, with the header profile dropdown menu showing containing a link to "My Favourites"](/images/docs/user/getting_around_favourites.png)