C# Класс Bloom.Book.BookStorage

The image-replacement feature is perhaps a one-off for a project where an advisor replaced the folders with a version that lacked most of the images (perhaps because dropbox copies small files first and didn't complete the sync)

Compare the images we find in the top level of the book folder to those referenced in the dom, and remove any unreferenced on

this is a method because it wasn't clear if we will eventually generate it on the fly (book paths do change as they are renamed)

creates a relocatable copy of our main HtmlDom

this one works on the dom passed to it

Do whatever is needed to do more than just show a title and thumbnail

Return the paths, relative to the book folder, of all the images referred to in the element.

Get a temporary file pathname in the current book's folder. This is needed to ensure proper permissions are granted to the resulting file later after FileUtils.ReplaceFileWithUserInteractionIfNeeded is called. That method may call File.Replace which replaces both the file content and the file metadata (permissions). The result of that if we use the user's temp directory is described in http://issues.bloomlibrary.org/youtrack/issue/BL-3954.

if necessary, append a number to make the subfolder name unique within the given folder

if necessary, append a number to make the folder path unique

/// Creates a relative path from one file or folder to another. ///

we update these so that the file continues to look the same when you just open it in firefox