Shaarli - Theming

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

@@ -36,21 +54,30 @@ code > span.er { color: #ff0000; font-weight: bold; }

Home

Installation

Docker

Usage

How To

Troubleshooting

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

@@ -87,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
@@ -124,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