Shaarli - Theming

X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=doc%2FTheming.html;h=27c5d8634bd720935749c258615586655856ad17;hb=ca089c5bad8ee0f85df571ffa0f0beba51fa4efc;hp=a751eb98046e14990dc84e366963c71a0889218b;hpb=f8b936e7e75601b5d96525f25d5b52dbabd909b4;p=github%2Fshaarli%2FShaarli.git diff --git a/doc/Theming.html b/doc/Theming.html index a751eb98..27c5d863 100644 --- a/doc/Theming.html +++ b/doc/Theming.html @@ -4,31 +4,49 @@ - Shaarli - Theming + Shaarli â Theming - +

@@ -39,18 +57,25 @@ code > span.er { color: #ff0000; font-weight: bold; }

Download

Server requirements

Server configuration

Server security

Shaarli installation

Shaarli configuration

Plugins

Docker

Usage

How To

@@ -62,6 +87,7 @@ code > span.er { color: #ff0000; font-weight: bold; }

@@ -89,14 +115,14 @@ code > span.er { color: #ff0000; font-weight: bold; }

RainTPL template

WARNING - This feature is currently being worked on and will be improved in the next releases. Experimental.

Find the template you'd like to install (see the list of available templates|Theming#community-themes--templates)
Find the template you'd like to install (see the list of available templates|Theming#community-themes--templates)
Find it's git clone URL or download the zip archive for the template.
In your Shaarli tpl/ directory, run git clone https://url/of/my-template/ or unpack the zip archive.
- There should now be a my-template/ directory under the tpl/ dir, containing directly all the template files.

Edit data/config.php to have Shaarli use this template, e.g.

$GLOBALS['config'['RAINTPL_TPL'] = 'tpl/my-template/';]('RAINTPL_TPL']-=-'tpl/my-template/';.html)

$GLOBALS['config'['RAINTPL_TPL'] = 'tpl/my-template/';]('RAINTPL_TPL']-=-'tpl/my-template/';.html)

Community themes & templates

user sites are enabled, e.g. /home/user/public_html/somedir is served as http://localhost/~user/somedir
http is the name of the Apache user

$ cd ~/public_html
+$ cd ~/public_html
 
 # clone repositories
 $ git clone https://github.com/shaarli/Shaarli.git shaarli
@@ -126,15 +152,15 @@ $ popd
 
 # set access rights for Apache
 $ chgrp -R http shaarli
-$ chmod g+rwx shaarli shaarli/cache shaarli/data shaarli/pagecache shaarli/tmp
+$ chmod g+rwx shaarli shaarli/cache shaarli/data shaarli/pagecache shaarli/tmp

Get config written:

go to the freshly installed site
fill the install form
log in to Shaarli

Edit Shaarli's configuration|Shaarli configuration:

# the file should be owned by Apache, thus not writeable => sudo
-$ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php

Edit Shaarli's configuration|Shaarli configuration:

# the file should be owned by Apache, thus not writeable => sudo
+$ sudo sed -i s=tpl=tpl/albinomouse-template=g shaarli/data/config.php