summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorJames Moger <james.moger@gitblit.com>2011-11-11 21:20:35 -0500
committerJames Moger <james.moger@gitblit.com>2011-11-11 21:20:35 -0500
commited99536abe326110de50d4c150b7b386c6e59707 (patch)
treea08e07052aed8ec41846fd64bc1e392198c4ab23 /docs
parentc2fe08bb91494d3ce9dae60ed89f29bb0057bbf8 (diff)
downloadgitblit-ed99536abe326110de50d4c150b7b386c6e59707.tar.gz
gitblit-ed99536abe326110de50d4c150b7b386c6e59707.zip
Documentation. Updated Google+ links.
Diffstat (limited to 'docs')
-rw-r--r--docs/00_index.mkd56
-rw-r--r--docs/01_features.mkd31
-rw-r--r--docs/site_header.html11
3 files changed, 45 insertions, 53 deletions
diff --git a/docs/00_index.mkd b/docs/00_index.mkd
index bc85e8e9..9f38ebe7 100644
--- a/docs/00_index.mkd
+++ b/docs/00_index.mkd
@@ -1,30 +1,46 @@
-## Overview
+## Why use Gitblit?
<a href="screenshots.html" title="Screenshots"><img class="overview" src="thumbs/00.png" alt="Screenshots" /></a>
-Gitblit is an open-source, pure Java stack for managing, viewing, and serving [Git][git] repositories.<br/>
-Its designed primarily as a tool for small workgroups who want to host centralized repositories.
+Gitblit is an open-source, pure Java stack for managing, viewing, and serving [Git][git] repositories.
+It's designed primarily as a tool for small workgroups who want to host centralized repositories.
-Gitblit is available in two variations:
+### GO: Single-Stack Solution
-1. *Gitblit GO* - a complete & integrated pure Java stack
-
- This is what you should download if you want to go from zero to Git in less than 5 mins.
- Gitblit GO is like a mashup of Apache httpd, [Git][git], and Gitweb with simplified configuration and maintenance.
- All dependencies are downloaded on first execution.
-2. *Gitblit WAR* - a traditional WAR distribution
+*Gitblit GO* is an integrated, single-stack solution based on Jetty.
+
+You do not need Apache httpd, Perl, Git, or Gitweb. Should you want to use some or all of those, you still can; Gitblit plays nice with the other kids on the block.
+
+This is what you should download if you want to go from zero to Git in less than 5 mins.
+
+All dependencies are downloaded on first execution.
+
+### WAR: For Your Servlet Container
+*Gitblit WAR* is what you should download if you already have a servlet container available that you wish to use.
+Jetty 6/7/8 and Tomcat 6/7 are known to work. Generally, any Servlet 2.5 or Servlet 3.0 container should work.
- This is what you should download if you want to deploy Gitblit into your own servlet container (e.g. Tomcat, Jetty, etc).
- All dependencies are bundled.
+All dependencies are bundled.
-### Tools
+### You decide how to use Gitblit
-- *Gitblit API* - an RSS/JSON RPC client library for integrating Gitblit into your systems
-- *Gitblit Manager* - a Java/Swing application for remote administration of a Gitblit server which uses the Gitblit API library
-- *Gitblit Federation Client* - a command line tool to clone/pull groups of repositories and optionally users and settings
+Gitblit can be used as a dumb repository viewer with no administrative controls or user accounts.
+Gitblit can be used as a complete Git stack for cloning, pushing, and repository access control.
+Gitblit can be used without any other Git tooling (including actual Git) or it can cooperate with your established tools.
-### Java Runtime Requirement
+### Easy Web Management
-Gitblit requires a Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK).
+Administrators can create and manage all repositories & user accounts from the *Web UI*.
+Administrators can create and manage all repositories & user accounts from the *JSON RPC interface* using the [Gitblit Manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%) or your own custom tooling.
+
+### Integration and Mining
+
+- Pluggable user service mechanism for custom authentication, authorization, and user management
+- Rich RSS feeds
+- JSON-based RPC mechanism
+- [Java Client API library](http://code.google.com/p/gitblit/downloads/detail?name=%API%) for custom integration
+
+### Backup Strategy
+
+Gitblit includes a backup mechanism (*federation*) which can be used to backup repositories and, optionally, user accounts & server settings from your Gitblit instance to another Gitblit instance or to a [Gitblit Federation Client](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%). Similarly, you can use the federation mechanism to aggregate individual workspace Gitblit instances to a common, centralized server.
### Current Release
@@ -65,6 +81,10 @@ Gitblit requires a Java 6 Runtime Environment (JRE) or a Java 6 Development Kit
issues, binaries, and sources @ [Google Code][googlecode]<br/>
sources @ [Github][gitbltsrc]
+### Java Runtime Requirement
+
+Gitblit requires a Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK).
+
### License
Gitblit is distributed under the terms of the [Apache Software Foundation license, version 2.0][apachelicense]
diff --git a/docs/01_features.mkd b/docs/01_features.mkd
index 9b1c9a68..b43ea46f 100644
--- a/docs/01_features.mkd
+++ b/docs/01_features.mkd
@@ -1,34 +1,3 @@
-## Why Gitblit?
-
-### Single-Stack Solution
-
-*Gitblit GO* is an integrated, single-stack solution for serving and browsing Git repositories with a per-repository authentication and authorization mechanism.
-You do not need Apache httpd, Perl, Git, Gitweb, or Gitolite. Should you want to use some or all of those, you still can; Gitblit plays nice with the other kids on the block. It should be noted that Gitblit does not currently offer fine-grained access controls like [Gitolite](http://sitaramc.github.com/gitolite).
-
-*Gitblit WAR = Gitblit GO - integrated Jetty*
-You provide the servlet container (e.g. Tomcat, Resin, etc) and deploy the WAR like any other webapp. Gitblit WAR offers all the same capabilities as the GO integrated stack except as noted below.
-
-### You decide how to use Gitblit
-
-Gitblit can be used as a dumb repository viewer with no administrative controls or user accounts.
-Gitblit can be used as a complete Git stack for cloning, pushing, and repository access control.
-
-### Easy Web Management
-
-Administrators can create and manage all repositories & user accounts from the *web UI*.
-Administrators can create and manage all repositories & user accounts from the *JSON RPC interface* using the [Gitblit Manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%) or your own custom tooling.
-
-### Integration
-
-Gitblit has a pluggable user service mechanism which allows you to implement your own authentication, authorization, and user management.
-
-Gitblit offers RSS feeds, a JSON-based RPC mechanism, and a [Java Client API library](http://code.google.com/p/gitblit/downloads/detail?name=%API%) which allows you to integrate Gitblit into your systems.
-
-### Backup Strategy
-
-Gitblit includes a backup mechanism (*federation*) which can be used to backup repositories and, optionally, user accounts & server settings from your Gitblit instance to another Gitblit instance or to a [Gitblit Federation Client](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%). Similarly, you can use the federation mechanism to aggregate individual workspace Gitblit instances to a common, centralized server.
-
-
## Standard Features (GO/WAR)
- JGit SmartHTTP servlet
- Browser and git client authentication
diff --git a/docs/site_header.html b/docs/site_header.html
index 86aae411..c909fd80 100644
--- a/docs/site_header.html
+++ b/docs/site_header.html
@@ -30,6 +30,8 @@
<link href="prettify/prettify.css" type="text/css" rel="stylesheet" />
<!-- Place this tag in your head or just before your close body tag -->
+ <link rel="canonical" href="http://gitblit.com" />
+ <link rel="publisher" href="https://plus.google.com/114464678392593421684" />
<script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
<!-- ANALYTICS -->
@@ -41,12 +43,13 @@
<a class="brand" href="http://gitblit.com" title="gitblit homepage">
<img src="gitblt_25_white.png" width="79" height="25" alt="gitblit" class="logo"/>
</a>
-
- <!-- Google Plus One -->
- <g:plusone></g:plusone>
-
+
<ul class="nav">
{1}
+ <!-- Google Plus Badge -->
+ <li><a href="https://plus.google.com/114464678392593421684?prsrc=3" style="margin-top:3px;text-decoration: none;"><img src="https://ssl.gstatic.com/images/icons/gplus-16.png" width="16" height="16" style="border: 0;"/></a></li>
+ <!-- Google Plus One -->
+ <li><div style="margin-top:14px;"><g:plusone size="small" href="http://gitblit.com"></g:plusone></div></li>
</ul>
</div>
</div>