Project

General

Profile

unexist.dev

/

subtle

Assorted tidbits and projects

Install » History » Version 37

« Previous - Version 37/65 (diff) - Next » - Current version
Anonymous, 10/16/2010 09:40 PM


Install\015\012\015\012{{>toc}}\015\012\015\012h2. Dependencies\015\012\015\012subtle has the following dependencies:\015\012\015\012# Ruby (>=1.9)\015\012# Rake (>=0.8)\015\012# X11 (>=6.8.2)\015\012\015\012And following optional gems for sur:\015\012\015\012# curb (>=0.5.1.0) (sur only)\015\012# archive-tar-minitar (>=0.5.2)\015\012# datamapper (>=0.9.11) (surserver only)\015\012# sinatra (>=0.9.4) (surserver only)\015\012\015\012h2. Versions\015\012\015\012Stable releases can be found here. If you like you can clone the Mercurial repository and install the developer version as followed:\015\012\015\012# hg clone http://hg.subforge.org/subtle\015\012# cd subtle\015\012# rake [options]\015\012# rake install\015\012\015\012The installer will copy the files to following XDG default path: (see: rake help)\015\012\015\012| Binaries | /usr/bin |\015\012| Config | /etc/xdg/subtle |\015\012| Extension | (Ruby Dir)/subtle |\015\012| Scripts | /usr/share//subtle |\015\012\015\012\015\012The paths can be easily changed (see: rake help) and are printed after configuring is done. subtle will create cache files to keep track of the settings, whenever you need to change a path later you need to delete the old caches with rake clobber.\015\012\015\012h2. Config\015\012\015\012On start subtle will check if a config file is available in the typical XDG paths and use it. A local config is preferred over a system wide. (see: $XDG_CONFIG_HOME) Then it will have a look for sublets in the XDG paths too and load them accordingly. (see $XDG_DATA_HOME)\015\012\015\012* To create a user config just create $XDG_CONFIG_HOME/subtle and copy the latest config from the dist folder into it.\015\012* To enable sublets create $XDG_DATA_HOME/subtle/sublets and create symlinks to the sublets. (Load order is alphabetically)\015\012\015\012_Always compare your existing config with the one of the repository/tarball to get the latest options and check the latest news._\015\012\015\012h2. Distributions\015\012\015\012h3. Ubuntu\015\012\015\012Since a package for ubuntu does not yet exist, you need to compile subtle to get it up and running.\015\012\015\012_Note that these instructions are tested on Mavrick (10.10)_\015\012\015\012# Download the latest stable package from\015\012\015\012 http://subforge.org/projects/subtle/files\015\012\015\012 or use mercurial for the latest version:\015\012\015\012
sudo apt-get install mercurial
\015\012\015\012 And then issue:\015\012\015\012
hg clone http://hg.subforge.org/subtle
\015\012# Using apt-get (as root) instal: libx11-dev, ruby1.9.1, ruby-dev1.9.1, libruby1.9.1 and rake\015\012\015\012
sudo apt-get install libx11-dev rake ruby1.9.1 ruby-dev1.9.1 libruby1.9.1
\015\012# Change dir into the subtle folder (stable or latest) and issue rake: (rake1.9.1 for the latest version):\015\012\015\012
rake1.9.1
\015\012\015\012 This should configure and get you ready for install\015\012# Issue the following command to install it:\015\012\015\012
sudo rake1.9.1 install
\015\012# Add a subtle session to your xsessions:\015\012\015\012
sudo nano /usr/share/xsessions/subtle.desktop
\015\012\015\012 And add this:\015\012\015\012
[Desktop Entry]\015\012Encoding=UTF-8\015\012Name=subtle\015\012Comment=subtle tiling window manager\015\012Exec=subtle\015\012Type=XSession\015\012  
\015\012# Reboot and your good to go..enjoy subtle :)