Renegade Reader v2.0 (The Old Man Edition) Theme For Ubooquity 3+

Well folks, it's brand new "stable release" time.  And since the first edition of the Renegade Reader theme is officially dead, I decided to create a new thread dedicated to second edition (or "The Old Man Edition") releases.  

The latest stable releases can always be found here: Renegade Reader v2.0 (The Old Man Edition)

Below are the revisions made between the last v1 (First Edition) and the v2 (Old Man Edition). 

Enjoy!

G

Renegade Reader v2.0 (The Old Man Edition) stable release

Change - All documentation has been updated, not only reflect the changes made between the "first edition" and "the old man edition" of this theme but, to better explain how Ubooquity and this theme interact as well as including more detailed information and examples on how to configure Ubooquity and this theme to get the best results.

Addition - A Windows build of the theme editor is now included in the /themeeditor folder along with the Linux build.

Change - The theme editor program is now updated to reflect the additions/removals of themeScript.js settings variables.

Change - Created a loginBackground.png to reflect the name of this theme's build (The Old Man Edition). Should you desire to do so, feel free to create your own "loginBackground.png" image to suit your needs and replace the existing one for a more customized look.

Change - The login page is changed to only display the Renegade Reader (powered by Ubooquity) logo, the login prompts, and a background image for the login page named "loginBackground.png", located in the "/themes/RR2/login/" folder.

Addition - The theme now has two different home page templates to choose from.
Use: homepageSliders=false variable in themeScript.js to tell the theme to use the default home page template
Use: homepageSliders=true variable in themeScript.js to tell the theme to display the alternate home page template with sliders containing the latest content on the home page

Removal - Since neither Ubooquity nor this theme strictly enforce JPG/PNG decoding, the "imgType" variable was removed from the theme settings in the themeScript.js file because, decoding-wise, it's not necessary to distiguish between the two file extensions. To use the PNG format where the JPG format is expected, simply rename your PNG file's extension to JPG. Likewise, to use the JPG format where the PNG format is expected, simply rename your JPG file's extension to PNG. The decoding routines are the same for both formats. So, the expected "file name.ext" is more far more important to Ubooquity and this theme than the image's actual format.

Removal - The "removeFolders" variable has been removed from the themeScript.js settings because it was specifically meant to remove the story arcs and series pages you create from the cateogry libraries they reside in; as well as the json (mini-database) file that Ubooquity imports to create them. This is now done automatically when a story arc or series page is displayed.

Renegade Reader v2.0 beta released for public testing

Addition - You can now tell the theme "how many pages deep" it should continue to display content header titles (or content text headers) in each category library.
Use: maxFoldersToLookForTitles variable in themeScript.js and adjust numeric values only
Use: adjust numeric values per category under "Max Titles"

Addition - You can now tell the theme "how many pages deep" it should look for a new header.jpg in each category library until it defaults to the last existing one.
Use: maxFoldersToLookForHeaders variable in themeScript.js and adjust numeric values only
Use: adjust numeric values per category under "Max Headers"

Change - Content header titles (or content text headers) will no longer display (regardless of whether they're on or off) if content headers are turned off.

Addition - You can now tell the theme whether or not to adjust category library root pages for squared, rather than rectangular, images.
Use: rootFolderAdjustment=true or rootFolderAdjustment=false in themeScript.js OR
Use: Root Folder Adjustments: [checked] or [unchecked]

Addition - Latest (or new) content in home page sliders can now be bookmarked. However, because bookmark queues are category specific and because the home page does not fall into any specific category, access to the bookmark queues is restricted to the appropriate category library. Ie.. Materials bookmarked from the Latest Comics sliders on the home page are stored in the bookmark queue located in the "comics" library. While materials bookmarks from the Latest Books sliders on the home page are stored in the bookmark queue located in the "books" library. El etc.. And while, in theory, I HAVE a good idea on how to successfully display bookmark queues on the home page, any implementation will require some intense "experimentation" on my part to make it function and display the queues correctly on the home page. So, this still could be a possibility in future releases.

Addition - Library bookmarking is now category specific. Bookmark queues are located under the "Bookmarks" link in their respective category libraries.

Change - The audio books module has been completely re-written and the associated HTML/CSS files were moved from the /common/ to the /library/ folder.

Change - Completely re-wrote the breadcrumb navigation and content header handling routines so that switching between root pages in a category library does not break them.

Addition - The theme now "correctly" supports multiple root pages (shared folders) in all category libraries. Switching between root pages is done in category libraries where the multiple root pages (shared folders) exist.

Addition - If the Ubooquity setting "bypass single root folder" under the Advanced tab is on, the theme will now inform you on the home page that it must be turned off.

Change - The theme now informs you if your have not imported anything into Ubooquity's database. I took this out of the first editions because I thought it was redundant. However, since I am planning on sharing (distributing) this theme in advance, I feel that re-including on the home page is necessary.

Change - All theme related objects stored in your browser's session and local storage bins have been renamed with "Ubooquity_????" prefixes for better data organization as well as to prevent severe data mis-matches between the first and second versions of this theme.

Change - Completely re-wrote many of the base Javascript functions and HTML files used in v1+ of this theme in order to reduce the number of required configuration settings without losing functionality.

Note: The code for the v1 (or first edition) releases needs to be abandoned. The problem is that, when I started writing this theme, I had no intent to distribute it and the code, for all practical purposes, is a series of "successful experiments" rather than being pre-planned and well-structured. Therefore, as much as I wanted to avoid it, a re-write of this theme's base functions has become unavoidable. The v2 (or second edition) releases will be pre-planned and better structured because 1) I don't have to experiment to see what works with Ubooquity anymore. I learned those lessons writing the first edition releases. 2) Knowing that I plan to share the theme in advance will force me to avoid as much 'hard-coding' as possible - which, in turn, will make the theme more customizable for end users who have a minimal understanding of HTML/CSS/Javascript.

Renegade Reader v1.05 (The First Edition) - final v1 release