Preinstall default themes, do not install extra files for theme makers

Signed-off-by: Mavridis Philippe <mavridisf@gmail.com>
author: Mavridis Philippe <mavridisf@gmail.com> 2021-06-26 17:54:05 +0300
committer: Mavridis Philippe <mavridisf@gmail.com> 2021-06-26 17:54:05 +0300
commit: 4500bb71771d0b04bee6fed90b36bb94d1ba7e28 (patch)
tree: 3b7050a3772707c5195fc19fdf8db945b8afcca6 /extra
parent: 87ff2096d2edd4d2013b9298fedd64c7fa5aea5c (diff)
download: twin-style-dekorator-4500bb71771d0b04bee6fed90b36bb94d1ba7e28.tar.gz
twin-style-dekorator-4500bb71771d0b04bee6fed90b36bb94d1ba7e28.zip
5 files changed, 259 insertions, 0 deletions
diff --git a/extra/README b/extra/README
new file mode 100644
index 0000000..6d065bf
--- /dev/null
+++ b/extra/README
@@ -0,0 +1,17 @@
+This directory contains some extra files shipped with DeKorator 0.3
+and intended for theme creators.
+
+portDeK -- a script for porting older DeKorator themes (1.x-2.x) to
+           DeKorator 0.3
+
+deKhelp -- DOxygen theme documentation
+
+template-theme.tar.gz -- this theme is meant to be a template theme
+                         for other themes,  this theme features all
+			 possible buttons.
+
+ugly-theme.tar.gz     -- the purpose  of this theme  is to help you
+                         understand  the way  deKorator  paints the
+			 decorations.
+
+The contents of this directory are not installed.
diff --git a/extra/deKhelp.xhtml b/extra/deKhelp.xhtml
new file mode 100644
index 0000000..588a67c
--- /dev/null
+++ b/extra/deKhelp.xhtml
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
+	<head>
+		<title>deKorator guide</title>
+	</head>
+	<body>
+		<h1>Summary</h1>
+		<p>deKorator is a twin engine that takes several user-defined images and presents them as a window decoration. deKorator expects to find those in a theme. Here is a guide for building such a theme.</p>
+		<h1>In the package</h1>
+		<p>deKorator comes with:</p>
+		<ul>
+			<li><strong>default-theme</strong> - Used by default, illustrates some of deKorator's features.</li>
+			<li><strong>ugly-theme</strong> - It's purpose is to understand the way deKorator paints the decorations.</li>
+		</ul>
+		<h1>Names</h1>
+		<p>deKorator expects the same directory structure and file names as the ones in default-theme. Every theme file should end with "-theme" (as in "default-theme"), and should contain all the folders that are in default-theme (deco, buttons, masks).</p>
+		<h1>Sizes</h1>
+		<p>deKorator determines the 4 borders' sizes from:</p>
+		<table border="1" frame="border" rules="all" summary="Border sizes">
+			<thead>
+				<tr>
+					<th>Property</th>
+					<th>Source</th>
+				</tr>
+			</thead>
+			<tbody>
+				<tr><td>the left border width</td><td>midLeftFrameBg's width</td></tr>
+				<tr><td>the right border width</td><td>midRightFrameBg's width</td></tr>
+				<tr><td>the top bar height</td><td>midTitleBg's height</td></tr>
+				<tr><td>the bottom border height</td><td>midBottomFrameBg's height</td></tr>
+			</tbody>
+		</table>
+		<p>All parts that build up a specific border should be in the same width or height correspondingly. An example follows for a window decoration with a 10px high top bar, a 20px wide left border, a 30px wide right border and a 40px high bottom border.</p>
+		<p>All tiles in the top bar should be 10 pixel high:</p>
+		<ul>
+			<li>topLeftCornerBg</li>
+			<li>leftButtonsBg</li>
+			<li>leftTitleBg</li>
+			<li>midTitleBg</li>
+			<li>rightTitleBg</li>
+			<li>rightButtonsBg</li>
+			<li>topRightCornerBg</li>
+		</ul>
+		<p>All tiles in the left border should be 20 pixel wide:</p>
+		<ul>
+			<li>topLeftFrameBg</li>
+			<li>midLeftFrameBg</li>
+			<li>bottomLeftFrameBg</li>
+		</ul>
+		<p>All tiles in the right border should be 30 pixel wide:</p>
+		<ul>
+			<li>topRightFrameBg</li>
+			<li>midRightFrameBg</li>
+			<li>bottomRightFrameBg</li>
+		</ul>
+		<p>All tiles in the bottom border should be 40 pixel high:</p>
+		<ul>
+			<li>leftBottomFrameBg</li>
+			<li>midBottomFrameBg</li>
+			<li>rightBottomFrameBg</li>
+		</ul>
+		<p>The corner tiles should fit into the tile grid:</p>
+		<table summary="Corner tiles' sizes">
+			<thead>
+				<tr>
+					<th>Tile</th>
+					<th>Height</th>
+					<th>Width</th>
+				</tr>
+			</thead>
+			<tbody>
+				<tr>
+					<td>topLeftCornerBg</td>
+					<td>10</td>
+					<td>20</td>
+				</tr>
+				<tr>
+					<td>topRightCornerBg</td>
+					<td>10</td>
+					<td>30</td>
+				</tr>
+				<tr>
+					<td>leftBottomFrameBg</td>
+					<td>40</td>
+					<td>20</td>
+				</tr>
+				<tr>
+					<td>rightBottomFrameBg</td>
+					<td>40</td>
+					<td>30</td>
+				</tr>
+			</tbody>
+		</table>
+		<h1>Buttons</h1>
+		<p>The button images are separated into background and foreground ones.</p>
+		<h2>Background</h2>
+		<p>The button background uses the leftButtonsBg and the rightButtonsBg tiles. Their height should be the same as the top bar's. The background's repeated horizontally to fit the buttons in.</p>
+		<h2>Foreground</h2> 
+		<p>The width is determined by the button width. This way theme makers can put the buttons as close as they wish. To make space between buttons you can add transparent pixels to the right and left. A button with a smaller height than the top bar's gets centered vertically. To place the button in a custom height use transparent pixels, too.</p>
+		<h1>Masks</h1>
+		<p>Masks contain only black and white. Black pixels are subtracted from the decoration.</p>
+		<h1>Image format</h1>
+		<p>All images should be in PNG.</p>
+	</body>
+</html>
+\ No newline at end of file
diff --git a/extra/portDeK b/extra/portDeK
new file mode 100755
index 0000000..127d87e
--- /dev/null
+++ b/extra/portDeK
@@ -0,0 +1,136 @@
+#!/bin/bash
+
+# this simple script will try to port deKorator-0.1 themes tarball to deKorator-0.2 themes format,
+# before u start make sure that in the tarball u would like to port the names of the folders inside
+# r named: deco, buttons, masks, and exectly like that no Deco or dEcO will do, 
+# if not so, extract the tarball change the folder names and compress it again.
+# after that run the portDeK script by clicking it or by typing "sh ./portDek" in console and fallow the instructions. 
+
+
+kdialog --msgbox "choose the theme tarball u woulk like to port."
+THEME=`kdialog --getopenfilename $HOME ""`
+echo $THEME
+
+mkdir "$HOME/port"
+ark --extract-to "$HOME/port" "$THEME"
+
+#echo --------------------
+#ls $HOME/port
+
+SRCTHEMENAME=`ls "$HOME/port"`
+#echo --------
+#echo $SRCTHEMENAME
+SRCTHEMEDIR="$HOME/port/$SRCTHEMENAME"
+#echo $SRCTHEMEDIR
+
+DSTTHEMENAME="$SRCTHEMENAME-theme"
+#echo $DSTTHEMENAME
+DSTTHEMEDIR="$HOME/deKtest/$DSTTHEMENAME"
+echo $DSTTHEMEDIR
+
+mkdir "$HOME/deKtest"
+mkdir "$DSTTHEMEDIR"
+mkdir "$DSTTHEMEDIR/deco"
+mkdir "$DSTTHEMEDIR/buttons"
+mkdir "$DSTTHEMEDIR/buttons/normal"
+mkdir "$DSTTHEMEDIR/buttons/hover"
+mkdir "$DSTTHEMEDIR/buttons/press"
+mkdir "$DSTTHEMEDIR/masks"
+
+
+# if test -f "$SRCTHEMEDIR/deco/topLeftCornerBg.png" ; then
+# echo --------------
+# fi 
+
+#deco
+#top
+cp "$SRCTHEMEDIR/deco/topLeftCornerBg.png" "$DSTTHEMEDIR/deco/topLeftCornerBg.png"
+cp "$SRCTHEMEDIR/deco/leftButtonsBg.png" "$DSTTHEMEDIR/deco/leftButtonsBg.png"
+cp "$SRCTHEMEDIR/deco/leftTitleBg.png" "$DSTTHEMEDIR/deco/leftTitleBg.png"
+cp "$SRCTHEMEDIR/deco/midTitleBg.png" "$DSTTHEMEDIR/deco/midTitleBg.png"
+cp "$SRCTHEMEDIR/deco/rightTitleBg.png" "$DSTTHEMEDIR/deco/rightTitleBg.png"
+cp "$SRCTHEMEDIR/deco/rightButtonsBg.png" "$DSTTHEMEDIR/deco/rightButtonsBg.png"
+cp "$SRCTHEMEDIR/deco/topRightCornerBg.png" "$DSTTHEMEDIR/deco/topRightCornerBg.png"
+#left
+cp "$SRCTHEMEDIR/deco/leftFrameBg.png" "$DSTTHEMEDIR/deco/topLeftFrameBg.png"
+cp "$SRCTHEMEDIR/deco/leftFrameBg.png" "$DSTTHEMEDIR/deco/midLeftFrameBg.png"
+cp "$SRCTHEMEDIR/deco/leftFrameBg.png" "$DSTTHEMEDIR/deco/bottomLeftFrameBg.png"
+#right
+cp "$SRCTHEMEDIR/deco/rightFrameBg.png" "$DSTTHEMEDIR/deco/topRightFrameBg.png"
+cp "$SRCTHEMEDIR/deco/rightFrameBg.png" "$DSTTHEMEDIR/deco/midRightFrameBg.png"
+cp "$SRCTHEMEDIR/deco/rightFrameBg.png" "$DSTTHEMEDIR/deco/bottomRightFrameBg.png"
+#bottom
+cp "$SRCTHEMEDIR/deco/buttomLeftCornerBg.png" "$DSTTHEMEDIR/deco/leftBottomFrameBg.png"
+cp "$SRCTHEMEDIR/deco/buttomFrameBg.png" "$DSTTHEMEDIR/deco/midBottomFrameBg.png"
+cp "$SRCTHEMEDIR/deco/buttomRightCornerBg.png" "$DSTTHEMEDIR/deco/rightBottomFrameBg.png"
+
+
+#buttons
+#normal
+cp "$SRCTHEMEDIR/buttons/buttonAboveDown.png" "$DSTTHEMEDIR/buttons/normal/buttonAboveDown.png"
+cp "$SRCTHEMEDIR/buttons/buttonAbove.png" "$DSTTHEMEDIR/buttons/normal/buttonAbove.png"
+cp "$SRCTHEMEDIR/buttons/buttonBelowDown.png" "$DSTTHEMEDIR/buttons/normal/buttonBelowDown.png"
+cp "$SRCTHEMEDIR/buttons/buttonBelow.png" "$DSTTHEMEDIR/buttons/normal/buttonBelow.png"
+cp "$SRCTHEMEDIR/buttons/buttonClose.png" "$DSTTHEMEDIR/buttons/normal/buttonClose.png"
+cp "$SRCTHEMEDIR/buttons/buttonHelp.png" "$DSTTHEMEDIR/buttons/normal/buttonHelp.png"
+cp "$SRCTHEMEDIR/buttons/buttonMax.png" "$DSTTHEMEDIR/buttons/normal/buttonMax.png"
+cp "$SRCTHEMEDIR/buttons/buttonMax.png" "$DSTTHEMEDIR/buttons/normal/buttonRestore.png"
+cp "$SRCTHEMEDIR/buttons/buttonMin.png" "$DSTTHEMEDIR/buttons/normal/buttonMin.png"
+cp "$SRCTHEMEDIR/buttons/buttonShadeDown.png" "$DSTTHEMEDIR/buttons/normal/buttonShadeDown.png"
+cp "$SRCTHEMEDIR/buttons/buttonShade.png" "$DSTTHEMEDIR/buttons/normal/buttonShade.png"
+cp "$SRCTHEMEDIR/buttons/buttonStickyDown.png" "$DSTTHEMEDIR/buttons/normal/buttonStickyDown.png"
+cp "$SRCTHEMEDIR/buttons/buttonSticky.png" "$DSTTHEMEDIR/buttons/normal/buttonSticky.png"
+
+#hover
+cp "$SRCTHEMEDIR/buttons/buttonAboveDown.png" "$DSTTHEMEDIR/buttons/hover/buttonAboveDownHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonAbove.png" "$DSTTHEMEDIR/buttons/hover/buttonAboveHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonBelowDown.png" "$DSTTHEMEDIR/buttons/hover/buttonBelowDownHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonBelow.png" "$DSTTHEMEDIR/buttons/hover/buttonBelowHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonClose.png" "$DSTTHEMEDIR/buttons/hover/buttonCloseHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonHelp.png" "$DSTTHEMEDIR/buttons/hover/buttonHelpHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonMax.png" "$DSTTHEMEDIR/buttons/hover/buttonMaxHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonMax.png" "$DSTTHEMEDIR/buttons/hover/buttonRestoreHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonMin.png" "$DSTTHEMEDIR/buttons/hover/buttonMinHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonShadeDown.png" "$DSTTHEMEDIR/buttons/hover/buttonShadeDownHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonShade.png" "$DSTTHEMEDIR/buttons/hover/buttonShadeHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonStickyDown.png" "$DSTTHEMEDIR/buttons/hover/buttonStickyDownHover.png"
+cp "$SRCTHEMEDIR/buttons/buttonSticky.png" "$DSTTHEMEDIR/buttons/hover/buttonStickyHover.png"
+
+#press
+cp "$SRCTHEMEDIR/buttons/buttonAboveDown.png" "$DSTTHEMEDIR/buttons/press/buttonAboveDownPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonAbove.png" "$DSTTHEMEDIR/buttons/press/buttonAbovePress.png"
+cp "$SRCTHEMEDIR/buttons/buttonBelowDown.png" "$DSTTHEMEDIR/buttons/press/buttonBelowDownPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonBelow.png" "$DSTTHEMEDIR/buttons/press/buttonBelowPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonClose.png" "$DSTTHEMEDIR/buttons/press/buttonClosePress.png"
+cp "$SRCTHEMEDIR/buttons/buttonHelp.png" "$DSTTHEMEDIR/buttons/press/buttonHelpPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonMax.png" "$DSTTHEMEDIR/buttons/press/buttonMaxPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonMax.png" "$DSTTHEMEDIR/buttons/press/buttonRestorePress.png"
+cp "$SRCTHEMEDIR/buttons/buttonMin.png" "$DSTTHEMEDIR/buttons/press/buttonMinPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonShadeDown.png" "$DSTTHEMEDIR/buttons/press/buttonShadeDownPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonShade.png" "$DSTTHEMEDIR/buttons/press/buttonShadePress.png"
+cp "$SRCTHEMEDIR/buttons/buttonStickyDown.png" "$DSTTHEMEDIR/buttons/press/buttonStickyDownPress.png"
+cp "$SRCTHEMEDIR/buttons/buttonSticky.png" "$DSTTHEMEDIR/buttons/press/buttonStickyPress.png"
+
+
+#masks
+cp "$SRCTHEMEDIR/masks/topLeftCornerBitmap.png" "$DSTTHEMEDIR/masks/topLeftCornerBitmap.png"
+cp "$SRCTHEMEDIR/masks/topRightCornerBitmap.png" "$DSTTHEMEDIR/masks/topRightCornerBitmap.png"
+cp "$SRCTHEMEDIR/masks/buttomLeftCornerBitmap.png" "$DSTTHEMEDIR/masks/buttomLeftCornerBitmap.png"
+cp "$SRCTHEMEDIR/masks/buttomRightCornerBitmap.png" "$DSTTHEMEDIR/masks/buttomRightCornerBitmap.png"
+
+
+
+##mkdir "$HOME/test"
+
+#cp -fr "$DSTTHEMEDIR" "$HOME/test" 
+cd "$HOME/deKtest/"
+tar czf "$DSTTHEMENAME.tar.gz" *
+
+cp "$HOME/deKtest/$DSTTHEMENAME.tar.gz" $HOME
+
+rm -fr "$HOME/port"
+rm -fr "$HOME/deKtest/"
+
+kdialog --msgbox "done, theme is located in your home dir."
+
+exit 0 
diff --git a/extra/template-theme.tar.gz b/extra/template-theme.tar.gz
new file mode 100644
index 0000000..357b897
--- /dev/null
+++ b/extra/template-theme.tar.gz
diff --git a/extra/ugly-theme.tar.gz b/extra/ugly-theme.tar.gz
new file mode 100644
index 0000000..a129ad9
--- /dev/null
+++ b/extra/ugly-theme.tar.gz
author	Mavridis Philippe <mavridisf@gmail.com>	2021-06-26 17:54:05 +0300
committer	Mavridis Philippe <mavridisf@gmail.com>	2021-06-26 17:54:05 +0300
commit	4500bb71771d0b04bee6fed90b36bb94d1ba7e28 (patch)
tree	3b7050a3772707c5195fc19fdf8db945b8afcca6 /extra
parent	87ff2096d2edd4d2013b9298fedd64c7fa5aea5c (diff)
download	twin-style-dekorator-4500bb71771d0b04bee6fed90b36bb94d1ba7e28.tar.gz twin-style-dekorator-4500bb71771d0b04bee6fed90b36bb94d1ba7e28.zip