Installing GitList for Local Repos

While GitHub is an excellent solution for code collaboration and repository management, some individuals and companies prefer to maintain code in the intranet for security reasons. It is easy to provide warehouse access on the local intranet, but it is not that simple to have a friendly interface to interact with these warehouses and simplify team collaboration. Git comes with a web interface gitweb, but it is not elegant and modern enough, it is difficult to view changes, authors and time, and browsing workspaces is also quite cumbersome. Some other solutions are difficult to install or the interface is not friendly enough. Recently I discovered GitList, a free and open source Git repository viewer. Its interface is very similar to GitHub, but it focuses more on conciseness and clarity. This article will guide you to set up your own Git repository viewer. Don't worry, it's simple, faster than installing WordPress!

Environmental preparation

This guide assumes that you are using a Debian-based Linux distribution, but GitList can run on any system. You need:

• Apache Server (enable mod_rewrite) or Nginx
• Git
• PHP 5.3 or later

If it is not installed yet, please run it in the terminal:

<code class="language-bash">sudo apt-get update
sudo apt-get install php5 apache2 git</code>

I also assume that your environment is as follows:

• Git repository path: /home/bob/code
• Apache document root directory: /var/www
• Git executable file path: /usr/bin/git
• Apache root URL: http://localhost

Apache users will access your Git repository, so you need to set the correct access permissions:

<code class="language-bash">sudo chmod -R 744 /home/bob/code</code>

Installing and configuring GitList

First, download GitList. You can choose the latest stable version or major version, but be aware that there may be bugs in the main version because the developers are still actively developing. After selecting the package, unzip it into the gitlist folder in the root directory of the Apache document.

Next to configure GitList! Rename the config.ini-example file to config.ini, open it with a text editor and make sure its content is as follows:

<code class="language-ini">[git]
client = '/usr/bin/git' ; Git可执行文件路径
repositories = '/home/bob/code/' ; 仓库路径

; 可以隐藏GitList中的仓库，为每个要隐藏的仓库复制此行
; hidden[] = '/home/bob/code/SecretProject'

[app]
baseurl = 'http://localhost/gitlist' ; 应用的基准URL

; 如果需要为特定扩展名指定自定义文件类型，请在此处进行设置
[filetypes]
; extension = type
; dist = xml</code>

The last step: Create a folder named /var/www/gitlist in the cache directory and give it the correct permissions:

<code class="language-bash">cd /var/www/gitlist
mkdir cache
chmod 777 cache</code>

Now visit http://localhost/gitlist to check.

Help! Page not found!

GitList uses Apache's mod_rewrite module to create a friendly URL. If the page is not found, make sure Apache is enabled: mod_rewrite:

<code class="language-bash">sudo a2enmod rewrite</code>

Also make sure Apache can read the .htaccess files in the GitList directory. .htaccess Files are used to overwrite and add new rules for Apache directories. Open your default Apache website profile (usually located at /etc/apache2/sites-enabled/000-default) and look for the following:

<code class="language-xml"><directory></directory>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride None
    Order allow,deny
    allow from all</code>

Change the AllowOverride option from None to All. Save changes and restart Apache:

<code class="language-bash">sudo apt-get update
sudo apt-get install php5 apache2 git</code>

Custom

GitList interface is built using Twitter Bootstrap and LESS. The LESS file is located in the web/less directory. A Makefile is provided, so you can generate the final CSS file by simply customizing the LESS file to your preferences and running web in the make directory. Of course, you need to install lessc, which can be done easily by running npm install less. GitList is powered by the Twig template engine, and all templates are located in the views directory. To better understand how it works, it is recommended that you read the related Twig tutorial. After modifying the .twig file, be sure to clear the contents of the cache folder!

(Picture from Fotolia)

(The following is the FAQ part, which has been adjusted and streamlined according to the original content to avoid duplication)

FAQ (FAQ)

• What are the prerequisites for installing GitList? Requires PHP 5.3.3 or later, Git and Composer.

• How to clone a GitList repository? Run git clone https://github.com/klaussilveira/gitlist.git.

• How to configure GitList? Edit config.ini files, configure repository paths, Git clients, etc.

• How to install dependencies using Composer? Run composer install.

• How to set the .htaccess file? Make sure Apache is enabled and set mod_rewrite to AllowOverride. All

• How to access GitList after installation? Access the URL of your GitList directory, such as . http://localhost/gitlist

• Apart from Apache, can GitList be used with other servers? Yes, for example, Nginx or IIS, but the configuration may be different.

• How to update GitList? Run and git pull. composer install

• Can you customize the appearance of GitList? You can modify the CSS file in the directory, but it may be overwritten when updating GitList. public

• What should I do if I encounter problems during the installation process? Check for error messages, refer to GitList issues on GitHub or seek help.

The above is the detailed content of Installing GitList for Local Repos. For more information, please follow other related articles on the PHP Chinese website!