The header.jpg goes in your library folders

ie...

comics <- header.jpg
comics/marvel <- header.jpg
comics/marvel/avengers <- header.jpg

and so forth.  

The numeric values in maxFoldersToLookForHeaders setting in themescript (or Max Headers field in themeeditor) are to tell the script how many pages deep it should continue to look for header.jpg before it simply uses the last one it found.

ie.. comics: 2

comics <- look for header.jpg
comics/marvel <- look for header.jpg

comics/marvel/avengers <- do not look for header.jpg.  Use last one instead.

Hopefully that helps.

G

hhenne,

I did not include the images I use for my libraries because, quite honestly, there are way too many to duplicate.  My comic library, alone, has over 70 publisher folders and hundreds of sub-folders under those.  

However, after considering your request, I put together a small package with examples of directory structures along with the appropriate folder.jpg/header.jpg for the comics, books. magazine, and audio books folders to help you out.

Libraries example: Libraries.zip

Hope that helps.

Check your browser's console logs (control+shift+i).  It should, at least, give you a hint as to why you're not getting breadcrumbs.  Without more information, I can't tell you what you missed. :)

Thanks.  Yep.  You'll need to create header.jpg images and put them in the comic base folders you want them displayed in.


Wait until you see what I'm working on next. :)

Apparently, I'm a bit bored in my retirement.  I finished updating the docs and theme editors today.

So, once again, it's "stable new release" time. 

The latest version of the Renegade Reader v2.0 (the Old Man Edition) is available at the top of this thread. :)

The version number of the theme is actually: v2.0R1 (see the included docs).

If you're running an older version of this theme (especially a 1.0 version), I highly encourage updating to this version.  Much of the base code has been completely rewritten to function better with Ubooquity.  Additionally, earlier versions of the audio book player included with the theme have extremely limited playback capabilities and they don't have the ability to create playlists 
for audio books in single containers - something that's been addressed with this release.

Enjoy!
G

I'm very excited to announce that major improvements to the audio book module are close to being completed.

The audio book player now reads JSON files so that it can:
- generate a clickable playlist - complete with track/chapter numbers, names, time stamps, and durations for, both, single MP3/M4A/M4B audio book containers as well as MP3/M4A/M4A audio book containers that are split into tracks/chapters.
- navigate forward and backward through the playlist using the previous and next buttons for, both, single MP3/M4A/M4B audio book containers as well as MP3/M4A/M4B audio book containers that are split into tracks/chapters.
- bookmark the track/chapter and time for, both, single MP3/M4A/M4B audio book containers as well as MP3/M4A/M4B containers split into track/chapters.
- display timestamps and durations in the playlist for MP3/M4A/M4B containers split into tracks/chapters (optional and purely cosmetic).  Which was something I had already implemented when I added JSON support for single MP3/M4A/M4B containers.  

And while resorting to relying on "homemade" JSON files to get the track/chapter information that the player needs to become fully functional when dealing with single MP3/M4A/M4B containers wasn't my first (or even second) choice, I've found that I can do things like customize the time stamps, the track/chapter names, and even calculate track/chapter durations based on the time stamps I provide.  Truly, I found that the benefits of using this method far outweighed the hassle of using MediaInfo to obtain the information I needed and the time it took to create a JSON file for my M4B files with it.  And the best part is that I should never have to touch the JSON files again. :)

Also, with regard to the "homemade" JSON files, I tried to make this as easy as possible for other people to use.  So, the player doesn't require any specific file names for your JSON files.  It only requires that the file name's extension ends with ".json", that it resides in the same folder as the audio book container it's referencing, and that it's structured correctly for single or multiple files so the player can read it.  

The following are examples of the two different JSON file structures I've developed that you can use:

This is an example JSON formatted file for use with single MP3/M4A/M4B audio book containers
{
"Tracks":{"00:00:00.000":{"Prologue":"0"},
"00:20:18.115":{"Sendaria":"1"},
"00:57:02.615":{"Sendaria":"2"},
"01:16:54.530":{"Sendaria":"3"},
"01:44:51.096":{"Sendaria":"4"},
"02:20:12.917":{"Sendaria":"5"},
"02:54:11.173":{"Sendaria":"6"},
"03:14:16.802":{"Sendaria":"7"},
"03:48:58.814":{"Sendaria":"8"},
"04:20:05.889":{"Sendaria":"9"},
"04:44:37.263":{"Sendaria":"10"},
"05:27:12.169":{"Sendaria":"11"},
"06:15:18.542":{"Cherek":"12"},
"06:38:23.867":{"Cherek":"13"},
"07:03:16.296":{"Cherek":"14"},
"07:31:51.156":{"Cherek":"15"},
"07:59:36.435":{"Cherek":"16"},
"08:18:12.544":{"Cherek":"17"},
"08:46:14.908":{"Cherek":"18"},
"09:08:24.515":{"Cherek":"19"},
"09:31:29.031":{"Cherek":"20"},
"09:46:09.644":{"Cherek":"21"}
}
}
In the above JSON example, the player only uses the time stamps at the beginning for functionality.  The track/chapter name and number are purely cosmetic.

This is an example JSON formatted file for use with multiple MP3/M4A/M4B audio book containers (split into chapters)
{
"Chapter 01":"3786.343",
"Chapter 02":"3803.846",
"Chapter 03":"3807.452",
"Chapter 04":"3821.321",
"Chapter 05":"3805.728",
"Chapter 06":"3803.244",
"Chapter 07":"3802.513",
"Chapter 08":"3823.646",
"Chapter 09":"3754.632",
"Chapter 10":"3820.668",
"Chapter 11":"3716.964"
}
In the above JSON example, the player inspects the internal "title" tag for each MP3/M4A/M4B chapter to use the correct duration to calculate time stamps and durations for multiple MP3/M4A/M4B containers.  Again, these are purely cosmetic and do NOT affect the functionality of the player.
-----

On a related note, I would also like to share that I finally figured out a way to make the correct number of audio books (regardless of whether they're stored in single containers or split into chapters) appear under links to subpages so that the audio books library looks exactly like the comic, book, magazine, and document libraries.  That's the good news.  The bad news is that there are no quick "client-side only" methods to recurse subpages.  So, on parent pages (where there are still a lot of subpages to search for audio books), the method I used causes a slight delay before loading subpage links.

So, in cases where the delay becomes bothersome or excessive, I've added a "true/false" constant in the settings part of the themeScript.js file to toggle the {{itemChildrenCount}} mustache tag on/off in the audio books module.
------

As for when you can expect a new release with all these nifty new features... the code is already written and I've been repeatedly testing it under different scenarios for the past few hours.  All seems good - which means I can start working on updating the documentation and theme editor programs as early as tomorrow evening... If all goes well, I should be able to package and distribute a new release as early as next week.
 
TTYL,

G

While fixing some styling issues that were bugging me, I noticed that my story arcs and series pages were showing up in the libraries (which was something that I thought I had fixed when I removed the "removeFolders" variable from the settings in the themeScript.js file). It was a simple fix.  But, needless to say, hiding those folders and the json file in them is important part of completing a story arcs/series page.  

So, if you downloaded and installed the new version of the theme prior to 10-14-2025, you'll probably want to re-download and re-install it.  I apologize for that in advance.

However, the good news is that this release includes fixes for styling issues that have been bugging me for a long time.

Renegade Reader v2.0 (Old Man Edition) stable release to fix the "stable release". 

Fixed - Story arc and series folders were not being removed because they were still checking label names rather than URL IDS. (SMH! It figures I would find this AFTER the "stable release")

Fixed - The folder.svg and its styling needed slight adjustments for proper display.

Fixed - The bookmark.svg now has a completely transparent background and behaves like the rest of the svg images when color schemes are changed.

Fixed - The page loaders displayed while the latest content is being loaded in the sliders on the home page are now styled correctly and say "Loading..." underneath the circular progress bar(s).

Fixed - Home page sliders are now pre-adjusted when the page loads based on the width of the screen rather than waiting for content to load and then adjusting them based on the width of the content. Looks much better and the layout shift is nearly 0.

Brand new stable release.  Bread new thread: Introducing Renegade Reader v2.0 (The Old Man Edition)

Quick wish list for future releases:

1. I could really use some mustache tags implemented in the RAW files module.  Specifically, I would like something that returns the number of files in subfolders (like the {{#items}} {{itemChildrenCount}}) {{/items}} non-empty list does on library pages.  Reason: It's currently impossible to get total number of audio files in each folder using client-side only.

2. This probably isn't going to happen, but I'll ask anyway.  I would like to see a mustache tag implemented in the RAW files module that will return audio file durations (file size in bits / bitrate).  Reason: The only option I have to add audio file durations "client-side" requires that the browser download each file to do the math. (VERY SLOW and eventually dies in folders with 100+ audio files - like the Bible when split into chapters).

These two additions, especially the first one, would help tremendously with completing the audio books module of my theme. The second request would be a nice addition but it's not "necessary".

Thanks for the consideration,
G

The latest beta rewrite is now available here: Renegade Reader v2.0 Beta
Note: This is NOT a finished release.  Rather, it's a pre-release of what I'm currently working on.

Some other notes for people who want to try this:

1. Root library folders no longer require URL ids to be predefined in themescript.js.  They are now scraped from page-library-category-root-dirs.html (which is something I should have done in the first place to avoid having to predefine them in themescript).

2. You still have to predefine numeric URL Ids for your comic/book/magazine/document series' as well as the folder name you're using for your audiobooks (if applicable) as Ubooquity does not internally support audiobooks or series'.

3. Multiple shared folders under a single category are now supported along with a way to switch folders in the corresponding library instead of displaying them when passing through the page-library-category-root-dirs.html.  To switch folders, go to your comics/books/magazine/document library and look for the folder image next to the settings image.

4. Used brand new objects for local and session storage to avoid overwriting old objects stored in session and local storage (which would bread the current theme).

5. The theme checks Ubooquity's "bypass single root folder" setting and will not allow you to use it unless you've turned it off.

6. Added the ability toggle the CSS adjustments on/off on the root folders.  If rootFolderAdjustment = true, then the root folders are adjusted to support squared images.  If rootFolderAdjustment = false, then the root folders are displayed exactly like the library folders (rectangular images).  

7. There is no top bar navigation on the home page and there are no sliders with the latest materials. Rather, it pretty much looks like the default theme's home page (which is necessary for navigation).  The navigation bar and sliders with the latest materials will be added once I get verification that the other areas seem stable. 

Peace,
G