Skip to content

Commit 45981ca

Browse files
feat: add steps component and description for the guide
1 parent 41ccb62 commit 45981ca

1 file changed

Lines changed: 67 additions & 0 deletions

File tree

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: animated history for a git repo
3+
description: A guide to install Gource on linux which show us an animated history of a Git repo
4+
---
5+
6+
import { Steps } from "@astrojs/starlight/components";
7+
8+
This tutorial will walk you through how to install and use [Gource](https://gource.io/), a tool that Shows an Animated Git repo Evolution with some Aesthetic Visuals
9+
10+
i will be showing you how to manually compile and install [Gource](https://gource.io/) on [Antix Linux](https://antixlinux.com/)
11+
12+
## Setup Gource
13+
14+
<Steps>
15+
16+
1. ### Prepare
17+
18+
Install Build Dependencies
19+
20+
```sh
21+
sudo apt install libsdl2-dev libsdl2-image-dev libpcre2-dev libfreetype6-dev libglew-dev libglm-dev libboost-filesystem-dev libpng-dev libtinyxml-dev
22+
```
23+
24+
Download Source Codebase from [Gource github](https://github.com/acaudwell/Gource)
25+
26+
```sh
27+
curl -L -o ~/Downloads/gource.tar.gz https://github.com/acaudwell/Gource/releases/download/gource-0.55/gource-0.55.tar.gz &&
28+
tar -xvf ~/Downloads/gource.tar.gz
29+
```
30+
31+
2. ### Compile & Install
32+
33+
```sh
34+
cd ~/Downloads/gource-0.55/ &&
35+
./configure &&
36+
make &&
37+
sudo make install
38+
```
39+
40+
</Steps>
41+
42+
## Usage
43+
44+
just cd into a git repo and run the `gource` command
45+
46+
```sh
47+
$: cd git-project
48+
$: gource
49+
```
50+
51+
## Common Error
52+
53+
if error occurs `failed to load resource '.../data/file.png'` while running the gource command, then you need to manually compile and install SDL2 as Suggested by this issue [failed to load resource '/usr/local/share/gource/file.png'](https://github.com/acaudwell/Gource/issues/43)
54+
55+
Just run this command
56+
57+
```sh
58+
sudo apt install build-essential git cmake libsdl2-dev &&
59+
git clone https://github.com/libsdl-org/SDL_image.git &&
60+
cd SDL_image &&
61+
git checkout SDL2 &&
62+
mkdir build &&
63+
cd build &&
64+
cmake .. &&
65+
make &&
66+
sudo make install
67+
```

0 commit comments

Comments
 (0)