P3X GitList

dd6b4dea

[//]: #@corifeus-header

df43c987

251a4729

a2094c1d

[![Donate for Corifeus / P3X](https://img.shields.io/badge/Donate-Corifeus-003087.svg)](https://paypal.me/patrikx3) [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Corifeus @ Facebook](https://img.shields.io/badge/Facebook-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software) [![Build Status](https://api.travis-ci.com/patrikx3/gitlist.svg?branch=master)](https://travis-ci.com/patrikx3/gitlist)

92eef369

[![Uptime Robot ratio (30 days)](https://img.shields.io/uptimerobot/ratio/m780749701-41bcade28c1ea8154eda7cca.svg)](https://uptimerobot.patrikx3.com/)

dd6b4dea

fa3a0c36

# 🤖 P3X Gitlist - A decorated enhanced elegant, feature rich and modern private git ui repository viewer v2019.4.115

92eef369

8ad7c417

🙏 This is an open-source project. Star this repository, if you like it, or even donate to maintain the servers and the development. Thank you so much!

92eef369

e196b9a8

Possible, this server, rarely, is down, please, hang on for 15-30 minutes and the server will be back up.

92eef369

fb40cda5

All my domains ([patrikx3.com](https://patrikx3.com) and [corifeus.com](https://corifeus.com)) could have minor errors, since I am developing in my free time. However, it is usually stable.

92eef369

48df23f9

**Note about versioning:** Versions are cut in Major.Minor.Patch schema. Major is always the current year. Minor is either 4 (January - June) or 10 (July - December). Patch is incremental by every build. If there is a breaking change, it should be noted in the readme.

92eef369

**Bugs are evident™ - MATRIX️** # Description

dd6b4dea

[//]: #@corifeus-header:end

df43c987

ca8c00c9

P3X Enhanced GitList is a fork of the klaussilveira Gitlist. What is different about is, that it requires/uses the latest PHP version, works with sub-modules. Updates all dependencies with monthly release. With big git repos/commits, it works with 64Mb memory (some Twig templates are removed and moved to the client and web workers - eg. huge diffs). You will love it to work it on OpenWrt. Provides multiple themes with dark mode - 11 light and 5 dark. Code editor with syntax highlighting, editable files. All changes in the original fork are synced with the enhanced version. 100% responsive with Bootstrap 3. Latest Fontawesome for icons. The markdown engine uses Emojis with Twitter's Emojis. Besides, the commits and logs are parsed as Markdown and Emojis.

276228d5

f2bf6263

## Beware

34d1136b

If you use other, than UTF-8 encoded files, you could get incorrect results, as it does not do converting, it only works with UTF-8.

f2bf6263

276228d5

# Live demo

d76b3d12

[http://gitlist.patrikx3.com/](http://gitlist.patrikx3.com/)

276228d5

3675883a

[Screenshots](artifacts/screenshots.md)

13ea9016

c00193b2

# Releases

d76b3d12

[https://github.com/patrikx3/gitlist/releases](https://github.com/patrikx3/gitlist/releases)

13ea9016

fea0c78f

[Ubuntu prior Bionic PHP 7 version installation](artifacts/php-7.2-ubuntu.md)

cff7f336

3675883a

438b568d

### NGINX gitlist.patrikx3.com configs

9bb5d286

This is a complete config that uses NGINX, LETSENCRYPT (using https://acme.sh) and the **git-http-backend**.

1049e643

This parse only the `public/index.php` file, no other PHP files, so that they are editable in `Decorated P3X GitList` as in the live demo.

438b568d

[gitlist.patrikx3.com.conf](artifacts/gitlist.patrikx3.com.conf)

2d093dec

## FYI [Change log](changelog.md) [TODO](todo.md) [Change breaking code](change-break.md)

83e531fe

d01fa13c

# Development

58914c83

7ed89e2f

To make it easier to develop Gitter and GitList, we unified the two code into one.

f1e4d5b9

## Requirements

ef75eb0b

790c616a

By now `composer` is not enough. We are using `webpack`, `less`, `grunt` ...

ef75eb0b

790c616a

For the build on your workstation (less, Bootstrap themes, and webpack):

ef75eb0b

ae7ac082

* ```NodeJs``` >= 10

d01fa13c

* https://nodejs.org/en/download/package-manager/

ef75eb0b

* ```Grunt``` (npm install -g npm grunt-cli) * `Composer`

09abf4bb

f1e4d5b9

In order to run GitList on your server, you'll need:

58914c83

f1e4d5b9

* ```git```

8d8f9646

* ```Apache``` with ```mod_rewrite``` enabled or ```nginx``` - preferred

9ab69cc0

* ```PHP``` >= 7.1

1ac876a9

2d093dec

## So, by hand

ef75eb0b

If you have Composer in your path, things get easier. But you know the drill. If want to get the project dependencies, and build everything:

946c2732

801d3352

```bash

d01fa13c

# ubuntu # https://github.com/nodesource/distributions/blob/master/README.md#debinstall curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash - sudo apt-get install -y nodejs

f1e4d5b9

git clone https://github.com/patrikx3/gitlist.git

946c2732

curl -s http://getcomposer.org/installer | php php composer.phar install

ef75eb0b

b1400c4a

# i use Node latest usually and NPM

ae7ac082

sudo npm install -g npm grunt-cli

76f2f24e

npm install

946c2732

327b496b

# create some simple GIT repos

a0368764

# create a test config.ini

79e4674c

./scripts/init.sh

ef75eb0b

# if you do not want to create a release

b62ad5ec

# just work on it # now the js and css is built on the fly # in the ./public folder npm run watch

ef75eb0b

16aea074

# you might need the zip program # to create release sudo apt install -y zip

ef75eb0b

# if you have bash and want to create a full release # and strip all unneeded files, # optimize the packagist vendor folder # you might need zip from linux

3f64bd76

# and the zip is in the ./build/p3x-gitlist-a.b.c.zip file

b62ad5ec

./scripts/release.sh

ef75eb0b

```

93b32c51

# Old info

3f64bd76

[Original install information, although some new info is included](INSTALL.md) - here.

93b32c51

https://github.com/klaussilveira/gitlist ### Last merge from `klaussilveira` #### Gitlist https://github.com/klaussilveira/gitlist/commits/master

3bb8aec4

April 20, 2019

93b32c51

#### Gitter https://github.com/klaussilveira/gitter/commits/master

3bb8aec4

April 20, 2019

93b32c51

11c7d090

# URL links

d76b3d12

45af583c

[P3X Gitlist playground](https://patrikx3.com/en/front/playground/18/p3x-gitlist#PG18)

939772d8

[Corifeus P3X Gitlist pages](https://pages.corifeus.com/gitlist/) [AlternativeTo Gitlist](https://alternativeto.net/software/p3x-gitlist/)

3675883a

[Github.io Gitlist](https://patrikx3.github.io/gitlist/)

939772d8

3675883a

[Gitlist.tk](https://gitlist.tk/gitlist.git/blob/master/README.md)

939772d8

801d3352

[Git Wiki Kernel Web Interfaces](https://git.wiki.kernel.org/index.php/Interfaces,_frontends,_and_tools#Web_Interfaces)

d76b3d12

3675883a

[//]: https://betapage.co/startup/p3x-gitlist

dd6b4dea

[//]: #@corifeus-footer ---

fa3a0c36

[**P3X-GITLIST**](https://pages.corifeus.com/gitlist) Build v2019.4.115

dd6b4dea

a2094c1d

[![Donate for Corifeus / P3X](https://img.shields.io/badge/Donate-Corifeus-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6) [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)

dd6b4dea

ccaa04c8

## P3X Sponsors

ee2f9a4b

5a07fb6b

[IntelliJ - The most intelligent Java IDE](https://www.jetbrains.com/?from=patrikx3)

5e6d4971

5a07fb6b

[![JetBrains](https://cdn.corifeus.com/assets/svg/jetbrains-logo.svg)](https://www.jetbrains.com/?from=patrikx3) [![NoSQLBooster](https://cdn.corifeus.com/assets/png/nosqlbooster-70x70.png)](https://www.nosqlbooster.com/)

5e6d4971

[The Smartest IDE for MongoDB](https://www.nosqlbooster.com)

ee2f9a4b

dd6b4dea

9aa9b744

[//]: #@corifeus-footer:end