Update README.rst
authorKevin Hill <kevinkhill@gmail.com>
Sat, 10 Aug 2013 04:22:16 +0000 (21:22 -0700)
committerKevin Hill <kevinkhill@gmail.com>
Sat, 10 Aug 2013 04:22:16 +0000 (21:22 -0700)
README.rst

index c49c0b18cdb678cea16c9f94a02109ce5a0b44a2..335b3934006af761e157eae03ec20cfac672f104 100644 (file)
@@ -1,4 +1,3 @@
-================
 Theme for gitweb
 ================
 
@@ -11,22 +10,17 @@ Installation
 
 The installation of this stylesheet is very easy:
 
-Just clone the repository to a location of your choice, probably into the same directory where the base gitweb stylesheet is located (in Ubuntu, this is e.g. /usr/share/gitweb/). It's recommended to move away the existing files and then create symlinks to the new files. You can do this with the following few commands::
+1. Clone the repository to a location of your choice ``git clone https://github.com/kogakure/gitweb-theme.git``
+2. Run ``./setup -vi --install`` and your gitweb will be themed!
+
+ - If you are on Ubuntu, then the script will default to gitweb's installation directory "/usr/share/gitweb/".
+ - If this is not where gitweb is located, then pass the directory to the script with the --target or -t option.
 
-  cd <PUT YOUR LOCATION OF GITWEB HERE, could be /usr/share/gitweb/>
-  mv gitweb.css gitweb_original.css
-  mv gitweb.js gitweb_original.js
-  mv git-logo.png git-logo_original.png
-  mv git-favicon.png git-favicon_original.png
-  git clone git://github.com/kogakure/gitweb-theme.git
-  ln -s gitweb-theme/gitweb.css gitweb.css
-  ln -s gitweb-theme/gitweb.js gitweb.js
-  ln -s gitweb-theme/git-logo.png git-logo.png
-  ln -s gitweb-theme/git-favicon.png git-favicon.png
+3. Of course you can just copy them to the new location too.
 
-Of course you can just copy them to the new location. If you see some missing things or errors, please create a ticket or fix it and send a pull request.
+If you see some missing things or errors, please create a ticket or fix it and send a pull request.
 
-Optionally, you can enable syntax highlighting for your code. Install the highligh package with your package manager and add this line to /etc/gitweb.conf:
+Optionally, you can enable syntax highlighting for your code. Install the highlight package with your package manager and add this line to /etc/gitweb.conf:
 
   $feature{'highlight'}{'default'} = [1];
 
@@ -37,6 +31,27 @@ You can enable Gravatar support with this line:
 .. _gitweb: http://git.or.cz/gitwiki/Gitweb
 .. _kogakure.github.com/gitweb-theme: http://kogakure.github.com/gitweb-theme
 
+Setup Script
+============
+
+::
+
+  Usage: ./setup [-v|-i] [-t <TARGET>|--target <TARGET>] [--install|--remove|--repair]  
+  Or: ./setup [-V|-h|--version|--help]
+
+  This script will create symlinks to your gitweb install for themeing.
+  The default location is '/usr/share/gitweb' unless set via -t or --target. 
+
+  OPTIONS:
+  -v, --verbose       Verbose output
+  -i, --interactive   Pauses for confirmation at each step
+  -t, --target        Where to create the symlinks, gitweb installation path
+  -h, --help          Shows this usage message
+  -V, --version       Displays version information
+  --install           Adds '.bak' to original files and creates symlinks to theme files
+  --remove            Deletes themed symlinks and restores the original files.
+  --repair            Removes all theme files, then reinstalls
+
 Licence
 =======