cygnoir
cygnoir

@Moondeer Apologies if this is somewhere in the readme and I didn't see it, but how do I add a "Bookshelf" link to my top navigation? I can get to the page so I know the plugin is working. Cheers!

|
Embed
Progress spinner
sod
sod

@cygnoir Here's how to add the bookshelf page to the main menu.

  1. Go to Design → Edit Custom Themes.
  2. Click Moondeer's Bookshelves followed by content/bookshelf.md.
  3. Add a new line with menu = "main" right below the line type = "bookshelf".
  4. Click Update Template and wait for your site to rebuild.
  5. Celebrate! 🎉
|
Embed
Progress spinner
cygnoir
cygnoir

@sod Thanks again. 😊

|
Embed
Progress spinner
artkavanagh
artkavanagh

@sod @cygnoir Thanks, this is useful to know. I “hardwired” a link to /bookshelf on a new line just under the navigation in the “header” partial. I’m quite pleased with the way it looks.

|
Embed
Progress spinner
Moondeer
Moondeer

@artkavanagh @sod @cygnoir Thanks for tackling this one.

It's funny. I was double checking the instructions I just left for someone in the help center and I couldn't get it to work (though apparently they did so I think my custom theme gets in the way). There are basically two approaches.

Theoretically, you can use the official Micro.blog page interface to create a new page and drop the [SCHEME]://[HOSTNAME]/bookshelf/ URL in as the content (i.e. https://moondeer.blog/bookshelf/). This allows for using the page interface's reordering mechanism.

My custom theme bypasses this interface and creates its menu via config/_default/menu.toml. Before this I controlled the contents of my main menu precisely the way @sod described. At one point I included the menu entry in the front matter so it would just pop up. The latest versions oughta have a contents/bookshelf.md file that uses the TOML format for its front matter, wherein I've included the menu entry but commented it out. If you find that you can just remove the hashtags.

Side note: I am still planning on touching up the Bookshelves plugin. I've gotten caught up with all the cool stuff I've got going with the cards plugin, for which I'm nearly 10K words deep into a walkthrough (I'd be done but I keep refining my plugin parameters and adding new features >.< … oh, yeah, and it was so long I figured it needed a table of contents so I wrote a table of contents plugin currently in need of a README).

|
Embed
Progress spinner