diff options
Diffstat (limited to 'doc/css-themeing.txt')
| -rw-r--r-- | doc/css-themeing.txt | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/doc/css-themeing.txt b/doc/css-themeing.txt index 3148838..7b9137d 100644 --- a/doc/css-themeing.txt +++ b/doc/css-themeing.txt @@ -58,11 +58,11 @@ Location of the resources in the file system -------------------------------------------- All themable content must be present in the directory specified by -USRDIR. The default USRDIR is /usr/share/vdr-plugin-live. This can be -changed at compile time by setting the USRDIR variable -(i.E. USRDIR=/tmp/live make). - -That means all themes must reside in USRDIR/themes. +'GetConfigDir'. GetConfigDir returns at runtime the position in the +filesystem where the plugins configuration file is stored. The +location is build from the vdr config path appended with the plugins +name (i.E. /var/lib/vdr/plugins/live). The themes are located in the +'themes' subdirectory of the above path. Structure of a theme package @@ -89,25 +89,25 @@ Selecting a theme in live In the live setup page, the user can select the desired theme. When the settings are saved the selected themes become active. Live detects the available themes dynamicaly by scanning the 'themes' directory in -USERDIR for available themes and creates the select box from this -information. +plugins config directory for available themes and creates the select +box from this information. So the installation of a new theme is easyly done by unpacking a -theme-archive in USRDIR/themes. This assumes the theme-archive follows -the structure of a theme package as described above. +theme-archive in the themes directory. This assumes the theme-archive +follows the structure of a theme package as described above. Security provisions ------------------- Live will map every url starting with themes/<themename>/css or -themes/<themename>/img to exactly these directories under USRDIR. That -means any path components after 'img' or 'css' are discarded. Only the -basename of the url is appended to these directories. This is to -prevent possible malicous requests to other locations in the -filesystem by adding '..' to the request path. The downside of this -is, that no additional directories below 'img' and 'css' are possible -for the theme designer. +themes/<themename>/img to exactly these directories under the location +of the themes directory. That means any path components after 'img' or +'css' are discarded. Only the basename of the url is appended to these +directories. This is to prevent possible malicous requests to other +locations in the filesystem by adding '..' to the request path. The +downside of this is, that no additional directories below 'img' and +'css' are possible for the theme designer. User Contribution @@ -116,5 +116,5 @@ User Contribution If you created a nice new look, you can provide it to us. We will try to include it into the live distribution. -If you need special html support for your styling needs don't hesitate +If you need special html support for your styling needs, don't hesitate to submit a suggestion. |