Shaarli - Theming

From 5409ade28c5f0acf99dbadd4d95e6f8efda5d395 Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Thu, 14 Apr 2016 14:20:23 +0200 Subject: Update docs from Wiki --- doc/Theming.html | 73 ++++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 50 insertions(+), 23 deletions(-) (limited to 'doc/Theming.html') diff --git a/doc/Theming.html b/doc/Theming.html index a751eb98..1eda52e4 100644 --- a/doc/Theming.html +++ b/doc/Theming.html @@ -4,31 +4,49 @@ - Shaarli - Theming + Shaarli – Theming - +

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

Download

Server requirements

Server configuration

Server security

Shaarli installation

Shaarli configuration

Plugin installation & configuration

Docker

Plugin list

Usage

How To

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

@@ -89,14 +116,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 +153,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

-- cgit v1.2.3 From 08dcd8ea58c07cd8258567ca14260aa18ba2660f Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Sat, 14 May 2016 11:37:28 +0200 Subject: Doc update Signed-off-by: ArthurHoaro --- doc/Theming.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) (limited to 'doc/Theming.html') diff --git a/doc/Theming.html b/doc/Theming.html index 1eda52e4..27c5d863 100644 --- a/doc/Theming.html +++ b/doc/Theming.html @@ -60,10 +60,9 @@ code > span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Inf

Server security

Shaarli installation

Shaarli configuration

Plugin installation & configuration

Plugins

Docker

Plugin list

Usage

Sharing button (bookmarklet)