-
- -

Foreword

-

There are two ways of customizing how Shaarli looks:

-
    -
  1. by using a custom CSS to override Shaarli's CSS
    2. -
  2. by using a full theme that provides its own RainTPL templates, CSS and Javascript resources
    3. -
-

Custom CSS

-

Shaarli's appearance can be modified by adding CSS rules to: -- Shaarli < v0.9.0: inc/user.css -- Shaarli >= v0.9.0: data/user.css

-

This file allows overriding rules defined in the template CSS files (only add changed rules), or define a whole new theme.

-

Note: Do not edit tpl/default/css/shaarli.css! Your changes would be overridden when updating Shaarli.

-

See also Download CSS styles from an OPML list

-

Themes

-

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

-

Installation: -- find a theme you'd like to install -- copy or clone the theme folder under tpl/<a_sweet_theme> -- enable the theme: - - Shaarli < v0.9.0: edit data/config.json.php and set the value of raintpl_tpl to the new theme name: - "raintpl_tpl": "tpl\/my-template\/" - - Shaarli >= v0.9.0: select the theme through the Tools page

-

Community CSS & themes

-

Custom CSS

- -

Themes

- -

Shaarli forks

- -

Example installation: AlbinoMouse theme

-

With the following configuration: -- Apache 2 / PHP 5.6 -- 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
-
-# clone repositories
-$ git clone https://github.com/shaarli/Shaarli.git shaarli
-$ pushd shaarli/tpl
-$ git clone https://github.com/alexisju/albinomouse-template.git
-$ popd
-
-# set access rights for Apache
-$ chgrp -R http shaarli
-$ 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
-
- -
-