document some workarounds for working with a recent ruby (2.3.p112 on

[booh] / THEMES

diff --git a/THEMES b/THEMES
index 27114b71f4aff9e1a4476cd21c773c6a35d35b12..c7917b569905e93c5dd31a4eb5cfb33f4c064d13 100644 (file)
--- a/THEMES
+++ b/THEMES
@@ -11,7 +11,12 @@ Each theme is made of:
 - one image.html skeleton, used for fullscreen images
 
 - any number of resource files these html pages depend on
 - one image.html skeleton, used for fullscreen images
 
 - any number of resource files these html pages depend on

-  (images, css..)
+  (images, css..), normally they should all go in the 'root'
+  subdirectory, so that they are only copied in the root
+  directory of the final webalbum and avoid wasting too much
+  hosting space; they can be referred from the skeleton by
+  prepending ~~pathtobase~~, which will be the relative path
+  to the root directory of the final webalbum

 
 - a metadata/parameters.rb file holding information about images
   sizes that will fit the best the html pages layout
 
 - a metadata/parameters.rb file holding information about images
   sizes that will fit the best the html pages layout


@@ -19,6 +24,16 @@ Each theme is made of:
 - three metadata/screenshot-?.png files used to select theme in
   the GUI
 
 - three metadata/screenshot-?.png files used to select theme in
   the GUI
 

+If you want to create a new theme, or make local modifications to a
+theme, just have them in your ~/.booh-themes directory. For example,
+to hack off "dark":
+
+# mkdir ~/.booh-themes
+# cp -a /usr/share/booh/themes/dark ~/.booh-themes/mine
+
+Use a different name than original theme names (here I picked the
+dummy name "mine", choose a better one).
+

 
                   [[ Skeleton files ]]
 
 
                   [[ Skeleton files ]]
 


@@ -79,4 +94,3 @@ of width (thus 124 of height).
 It would be best if the screenshots would show the same contents,
 so just send me your theme if you create a new one and I'll do
 the screenshots.
 It would be best if the screenshots would show the same contents,
 so just send me your theme if you create a new one and I'll do
 the screenshots.

-