In Epiphany, Nautilus, and in libadwaita's various navigation views, if you right click on the back or forward buttons you get a history of pages you can pop to, as so:

In Biblioteca this is not currently implemented. It would be nice to have this, as it would allow people to quickly scrub back through their history and then jump forward. To implement this, it might be helpful to look at how Epiphany does it, since Biblioteca also uses WebKitGTK.

We might want to consider always showing the option to show/hide the sidebar. Right now it's only shown when the first breakpoint is triggered. Especially for online docs, we should automatically hide the sidebar (and maybe show it when going back or forward to offline docs again).

The sidebar can become obstructing otherwise

It should be possible to switch between GNOME 44, GNOME 45, GNOME 46, ... documentation.

Middle clicking on a webview link opens the link in a new tab but also loads it into the last selected tab as well

It sometimes only seems to happen after a delay when you go back to the tab

Thank you for this amazing software!

GTK and libadwaita often have new API that is not included in the stable releases for a long time. Please make it possible to view the latest gnome-nightly docs. Perhaps this can be solved by just including this app in gnome-nightly?

• release notes
• update VTE to 0.76
• update libshumate to 1.2
• update meson.build version to 1.3
• publish!

From discussion #52 (comment), most people might not need most of the docs that are shipped by default, therefore it makes sense to provide an option to filter docs according to user preference. It might also make up for faster load times. We can have something similar to DevHelp

It would be nice to support tabs. I think @AkshayWarrier is already on it.

It should be for current doc only, web browsing will come later.

• We should support middle+click on sidebar items.
• As well as "New Tab"
• And middle+click on doc links

Desired behavior:

I want to click GtkListBowRow and have it open in a new tab in Biblioteca.

Current behavior:

It'll open up the link in my default browser

(the documentation viewer looks great btw :)

Steps to reproduce:

• Open biblioteca
• Open the shortcuts window
• close shortcuts window
• Close biblioteca

Expected result:

biblioteca quits

Actual result

biblioteca runs in the background

When navigating through the tree view in the sidebar, the row that the keyboard is hovering over is not highlighted. To worsen this, the row cannot be expanded without a pointing device.

Version affected: 1.1, possibly 1.0

This can likely be fixed by setting the rows to focusable.

I'm really not sure if it's really possible. If not, I guess I will see this issue closed.

I think a search provider would be really useful for this app, so that you can type something like GtkButton and you can open the app directly in the class documentation.

It would save having to keep the app open all the time to search for specific documentation.

Right now the tags in the search results are created as buttons and clicking on them doesn't do anything. Maybe it's a good idea to automatically apply the tag: filter to the search results when any of the tags are clicked.

It would be pretty cool if Biblioteca had some sort of API that let other apps browse it's content and present it to the user.

This could be used by IDE/editor plugins / LSPs to jump to a specific documentation within Biblioteca.

A good option would maybe be some sort of URI scheme that Biblioteca can handle?

I come from DevHelp and I'm used to Ctrl + L giving focus to the search field on the left (it works similarly in Firefox and GNOME Files and Chrome and others). Please add this functionality.

If you start the app in dark mode, there is a bright flash between the time the webview was drawn and the documentation was lodaded.

The reason for that is that the default background color of the webview is white.

We should change the color in dark mode so there is no flash. There is code in Tangram for that IIRC

I've noticed that the shortcuts only work when the search bar is active or when items in the sidebar list were selected. Is the Webview maybe at fault here?

Also I tried implementing backward and forward mouse buttons (for mice with buttons on the side) but I need to double click when the mouse is above the webview, which does not happen in Workbench.

In the WebView widget, I think the default context menu is used. This includes 'Stop', 'Reload' and 'Inspect Element'. I suggest it would be better if they're removed, leaving just 'Back' and 'Forward'.

If you have something selected in the sidebar and if its parent row gets collapsed, the sidebar looses its selection and remains unselected even if the webview loads a different page. (Unless you select something again in the sidebar, in which case they sync up again)

This should also be kept in mind while implementing #23, the easiest thing to do would be to have the sidebar unselect the row but sync back again if the webview loads a different page. DevHelp also sort of faces this issue and shows inconsistent behaviour.

There is a lot of wasted space on the left and right sides

Very nice app! I was looking for offline doc viewer for Gtk and Adw. It would be nice to have an option to control docs font size.

And load them when the window is constructed.

https://docs.gtk.org/girepository/index.html

A marvelous new app, needs a decent app icon. Will be hard to avoid the 'big book' metaphor, but let's see.

Since we have a WebView anyway for offline content, we might as well support online content too.

UI is going to be tricky so let's wait until after

• #21
• #24

Right now, Biblioteca has some minor issues with screen size:

• The tab overview cannot be triggered with a shortcut
• If the window size is expanded, the overview is still shown
• The sidebar is not opened when F10 is pressed to activate the menu
• The sidebar cannot be toggled with a shortcut

I have a branch where I am fixing all of these things, and all but the last are fixed. I would also reccomend adding a button to open the overview in large window mode, somewhat like how GNOME Web does it with a button in the header bar that can trigger it, as the overview is useful to desktop users as well or people who have many tabs open.

It would be great if Biblioteca would provide binding specific documentation for at least Vala, GJS, PyGObject and gtk-rs.
In the simplest form it could do that by having links from all pages to the respective counterpart in these docs.

Biblioteca could also bundle offline versions of these if licensing allows.

Example for where Gtk-4.0's "GtkSwitch.set_active" would link to:

• Vala: https://valadoc.org/gtk4/Gtk.Switch.set_active.html
• GJS: https://gjs-docs.gnome.org/gtk40~4.0/gtk.switch#method-set_active
• PyGObject: https://lazka.github.io/pgi-docs/Gtk-4.0/classes/Switch.html#Gtk.Switch.set_active
• gtk-rs: https://gtk-rs.org/gtk4-rs/git/docs/gtk4/struct.Switch.html#method.set_active (this is probably the most complicated to link to, due to the different crates involved and structural differences / extension traits)

Related issues:

• #27 - would be required for properly displaying the content, especially if loaded from online sources
• #47 - such an API/URI schema could also support direcly loading the binding specific pages

AdwToolbarView was an excellent approach so that the header bar could be raised when scrolling. The problem is that it doesn't seem to be able to detect when the user scrolls within a web view, so you end up with content that is magically "cut off".

The simplest fix in my opinion would be to make the header bar always raised and that's it.

Hi, there seems to be a race condition upon startup, sometimes leading to a broken view state. It's not super easy to reproduce (I guess more likely on slower hardware?). Here are two different issues that can cause.

The first one simply an unfulfilled search. Nothing major, typing restarts the search.

The second case is worse, it leads to a completely broken view. This can only be fixed by opening a new tab and closing the old one.

I hope the descriptions help to locate the issue.

I haven't found a clear-cut way to reproduce it but sometimes, when you search for something in the search view and select it for the first time, it will initially select the correct item in the browse view (and hence correctly load it in the webview as well) but going back will select the first item in the browse view ("Adw-1").

I have a feeling this is a bug with GTK because there's possibly nothing that should cause it to do that only the first time around, but it requires further testing.

As the title says, when one shrinks the Manuals window the webview on the right eventually gets smaller and smaller and dissapears. Possibly until mobile view is implemented, a width request can be put on the webview?

There should be a way to collapse all rows in the sidebar. There's already a function that does that (collapseAllRows() ) but we need to decide how to expose it to the user.

When searching for e.g. "scrolledwindow" the GtkScrolledWindow class is not in the first page of results. While one can enter any method and go up, it might make sense to sort the results so that the classes appear first.

As suggested by @bragefuglseth, we could try changing the styling of gi-docgen generated docs (such as changing bg/fg colors and setting font to Cantarell) to match the theme of Adwaita.

This might also be something we could consider doing for future docsets as well such as devdocs.

The default size of the app is small enough that

1. The breakpoint collpases the sidebar by default
2. Even after going slightly over the breakpoint, The main view is not twice as wide as the sidebar.

On possibility would be to add around 100-200px both to the default width and height, and then make the sidebar (slightly) less wider.

Note that the breakpoint is in sp which takes into account font size, I am currently using font scaling factor = 1.25, which is the Large Text option in Settings.

We currently support gi-docgen docs, we should support other formats.

• Zim - not for dev docs
• DevHelp - deprecated?
• gtk-doc deprecated
• devdocs - there is a gtk3 app for inspiration https://github.com/hardpixel/devdocs-desktop
• docsets - there is a gtk3 app for inspiration https://zealdocs.org/

It's currently not possible to search in the selected doc.

It should be pretty easy we can use Epiphany / DevHelp for inspiration.

Currently clicking on a link inside the webview to a docset outside of the one being shown, redirects to a http uri. Instead we should load the local documentation for it if it's available and if we don't we open the documentation as a "browser" page.

The css

window,
#content-headerbar {
  background-color: #ffffff;
}

affects all windows, including the about window.