X-Git-Url: https://git.m6w6.name/?p=m6w6%2Fgitweb-theme;a=blobdiff_plain;f=README.rst;h=335b3934006af761e157eae03ec20cfac672f104;hp=779b2f8b21f157031c00318812a979d832c79ea3;hb=812ebcf5bcdd1ebb8f491e41d8f5617b890ad506;hpb=9f2dfbfb40b4293b03257fbf00a942132b035fc0 diff --git a/README.rst b/README.rst index 779b2f8..335b393 100644 --- a/README.rst +++ b/README.rst @@ -1,4 +1,3 @@ -================ Theme for gitweb ================ @@ -11,30 +10,54 @@ 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. + +3. Of course you can just copy them to the new location too. + +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 highlight package with your package manager and add this line to /etc/gitweb.conf: + + $feature{'highlight'}{'default'} = [1]; - cd - 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 +You can enable Gravatar support with this line: -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. + $feature{'avatar'}{'default'} = ['gravatar']; .. _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 ] [--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 ======= (The MIT License) -Copyright (c) 2009-2012 Stefan Imhoff stefan@imhoff.name +Copyright (c) 2009-2013 Stefan Imhoff stefan@imhoff.name Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: