2021-10-11 07:29:10 +03:00
|
|
|
[![Actions Status](https://github.com/Murmele/gitahead/workflows/GitAhead%20%28master%29/badge.svg)](https://github.com/Murmele/gitahead/actions) [![Actions Status](https://github.com/Murmele/gitahead/workflows/GitAhead%20%28stage%29/badge.svg)](https://github.com/Murmele/gitahead/actions)
|
2019-12-17 07:20:08 +03:00
|
|
|
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
Gittyup
|
2018-12-13 02:22:04 +03:00
|
|
|
==================================
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
Gittyup is a graphical Git client designed to help you understand
|
2020-09-09 21:47:49 +03:00
|
|
|
and manage your source code history. It's available as a [pre-built
|
|
|
|
binary for Windows, Linux, and macOS](https://gitahead.github.io/gitahead.com/), or can be built from source by
|
2018-12-13 02:22:04 +03:00
|
|
|
following the directions below.
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
Gittyup is a continuation of the [GitAhead](https://github.com/gitahead/gitahead) client.
|
|
|
|
|
2018-12-13 02:22:04 +03:00
|
|
|
How to Get Help
|
|
|
|
---------------
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
Ask questions about building or using Gittyup on
|
2018-12-13 02:22:04 +03:00
|
|
|
[Stack Overflow](http://stackoverflow.com/questions/tagged/gitahead) by
|
|
|
|
including the `gitahead` tag. Remember to search for existing questions
|
|
|
|
before creating a new one.
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
Report bugs in Gittyup by opening an issue in the
|
|
|
|
[issue tracker](https://github.com/Murmele/gitahead/issues).
|
2018-12-13 02:22:04 +03:00
|
|
|
Remember to search for existing issues before creating a new one.
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
If you still need help, check out our Matrix channel
|
2021-11-22 10:41:08 +03:00
|
|
|
[Gittyup:martix.org](https://matrix.to/#/#Gittyup:matrix.org).
|
2018-12-13 02:22:04 +03:00
|
|
|
|
|
|
|
Build Environment
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
* C++11 compiler
|
|
|
|
* Windows - MSVC >= 2017 recommended
|
|
|
|
* Linux - GCC >= 6.2 recommended
|
|
|
|
* macOS - Xcode >= 10.1 recommended
|
|
|
|
* CMake >= 3.3.1
|
|
|
|
* Ninja (optional)
|
|
|
|
|
|
|
|
Dependencies
|
|
|
|
------------
|
|
|
|
|
|
|
|
External dependencies can be satisfied by system libraries or installed
|
2019-01-07 23:30:46 +03:00
|
|
|
separately. Included dependencies are submodules of this repository. Some
|
|
|
|
submodules are optional or may also be satisfied by system libraries.
|
2018-12-13 02:22:04 +03:00
|
|
|
|
|
|
|
**External Dependencies**
|
|
|
|
|
2021-06-12 16:44:51 +03:00
|
|
|
* Qt (required >= 5.15)
|
2018-12-13 02:22:04 +03:00
|
|
|
|
|
|
|
**Included Dependencies**
|
|
|
|
|
|
|
|
* libgit2 (required)
|
|
|
|
* cmark (required)
|
|
|
|
* git (only needed for the credential helpers)
|
|
|
|
* libssh2 (needed by `libgit2` for SSH support)
|
|
|
|
* openssl (needed by `libssh2` and `libgit2` on some platforms)
|
|
|
|
|
2019-08-18 19:41:50 +03:00
|
|
|
Note that building `OpenSSL` on Windows requires `Perl` and `NASM`.
|
|
|
|
|
2018-12-13 02:22:04 +03:00
|
|
|
How to Build
|
|
|
|
------------
|
|
|
|
|
|
|
|
**Initialize Submodules**
|
|
|
|
|
|
|
|
git submodule init
|
|
|
|
git submodule update
|
|
|
|
|
|
|
|
**Build OpenSSL**
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
# Start from root of gittyup repo.
|
2018-12-13 02:22:04 +03:00
|
|
|
cd dep/openssl/openssl
|
|
|
|
|
|
|
|
Win:
|
|
|
|
|
|
|
|
perl Configure VC-WIN64A
|
2019-01-26 00:46:52 +03:00
|
|
|
nmake
|
2018-12-13 02:22:04 +03:00
|
|
|
|
|
|
|
Mac:
|
|
|
|
|
2019-01-07 23:30:46 +03:00
|
|
|
./Configure darwin64-x86_64-cc no-shared
|
2018-12-13 02:22:04 +03:00
|
|
|
make
|
|
|
|
|
|
|
|
Linux:
|
|
|
|
|
2019-01-26 00:46:52 +03:00
|
|
|
./config -fPIC
|
2018-12-13 02:22:04 +03:00
|
|
|
make
|
|
|
|
|
|
|
|
**Configure Build**
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
# Start from root of gittyup repo.
|
2018-12-13 02:22:04 +03:00
|
|
|
mkdir -p build/release
|
|
|
|
cd build/release
|
|
|
|
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ../..
|
|
|
|
|
|
|
|
If you have Qt installed in a non-standard location, you may have to
|
|
|
|
specify the path to Qt by passing `-DCMAKE_PREFIX_PATH=<path-to-qt>`
|
|
|
|
where `<path-to-qt>` points to the Qt install directory that contains
|
|
|
|
`bin`, `lib`, etc.
|
|
|
|
|
|
|
|
**Build**
|
|
|
|
|
|
|
|
ninja
|
2021-10-11 07:29:10 +03:00
|
|
|
|
2021-09-14 11:09:36 +03:00
|
|
|
How to Install
|
|
|
|
-----------------
|
|
|
|
**Linux**
|
2021-10-11 07:29:10 +03:00
|
|
|
The easies way to install Gittyup is by using [Flatpak](https://www.flatpak.org/)
|
2021-09-14 11:09:36 +03:00
|
|
|
|
2021-11-17 13:44:53 +03:00
|
|
|
Ubuntu:
|
|
|
|
|
|
|
|
sudo apt-get install flatpak && flatpak install flathub com.github.Murmele.Gittyup
|
|
|
|
Arch:
|
|
|
|
|
|
|
|
sudo pacman -S flatpak && flatpak install flathub com.github.Murmele.Gittyup
|
|
|
|
|
2021-09-14 11:09:36 +03:00
|
|
|
|
2018-12-13 02:22:04 +03:00
|
|
|
|
|
|
|
How to Contribute
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
We welcome contributions of all kinds, including bug fixes, new features,
|
|
|
|
documentation and translations. By contributing, you agree to release
|
|
|
|
your contributions under the terms of the license.
|
|
|
|
|
|
|
|
Contribute by following the typical
|
|
|
|
[GitHub workflow](https://guides.github.com/introduction/flow/index.html)
|
|
|
|
for pull requests. Fork the repository and make changes on a new named
|
2018-12-31 05:26:55 +03:00
|
|
|
branch. Create pull requests against the `master` branch. Follow the
|
|
|
|
[seven guidelines](https://chris.beams.io/posts/git-commit/) to writing a
|
|
|
|
great commit message.
|
2018-12-13 02:22:04 +03:00
|
|
|
|
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
2021-10-11 07:29:10 +03:00
|
|
|
Gittyup and its predecessor GitAhead are licensed under the MIT license. See LICENSE.md for details.
|