992af0b9d7
Closes #291 Fixes #227 Modifications - HTML content: match the new Wiki structure - Makefile - generate a custom HTML sidebar - include the sidebar on all pages - infer and prepend page titles - handle relative links - add title metadata, e.g. Shaarli - <Page Name> Signed-off-by: VirtualTam <virtualtam@flibidi.net>
3.3 KiB
3.3 KiB
#Theming
User CSS
- Shaarli's apparence can be modified by editing CSS rules in
inc/user.css
. This file allows to override rules defined in the maininc/shaarli.css
(only add changed rules), or define a whole new theme. - Do not edit
inc/shaarli.css
! Your changes would be overriden when updating Shaarli. - Some themes are available at https://github.com/shaarli/shaarli-themes.
See also:
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 it's git clone URL or download the zip archive for the template.
- In your Shaarli
tpl/
directory, rungit clone https://url/of/my-template/
or unpack the zip archive.- There should now be a
my-template/
directory under thetpl/
dir, containing directly all the template files.
- There should now be a
- 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)
Community themes & templates
- AkibaTech/Shaarli Superhero Theme - A template/theme for Shaarli
- alexisju/albinomouse-template - A full template for Shaarli
- dhoko/ShaarliTemplate - A template/theme for Shaarli
- kalvn/shaarli-blocks - A template/theme for Shaarli
- kalvn/Shaarli-Material - A theme (template) based on Google's Material Design for Shaarli, the superfast delicious clone.
- misterair/Limonade - A fork of (legacy) Shaarli with a new template
- Vinm/Blue-theme-for Shaarli - A template/theme for Shaarli (unmaintained, compatibility unknown)
- vivienhaese/shaarlitheme - A Shaarli fork meant to be run in an openshift instance
Example installation: AlbinoMouse template
With the following configuration:
- Apache 2 / PHP 5.6
- user sites are enabled, e.g.
/home/user/public_html/somedir
is served ashttp://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