Merge pull request #66 from gnome-terminator/doc/install
This commit is contained in:
Markus Frosch
GitHub
commit
0d0d0393ea
63
INSTALL
63
INSTALL
|
|
@ -1,63 +0,0 @@
|
||||||
It's strongly recommended to install Terminator using your OS's package
|
|
||||||
system rather than using setup.py yourself.
|
|
||||||
|
|
||||||
Packages are known to be available under the name "terminator" for the
|
|
||||||
following Distributions
|
|
||||||
|
|
||||||
* Arch Linux
|
|
||||||
* CentOS
|
|
||||||
* Debian
|
|
||||||
* Fedora
|
|
||||||
* FreeBSD
|
|
||||||
* Gentoo
|
|
||||||
* OpenSUSE
|
|
||||||
* Ubuntu
|
|
||||||
|
|
||||||
If you maintain terminator for an OS other than these, please get in touch
|
|
||||||
or issue a PR to this file.
|
|
||||||
|
|
||||||
If you don't have this option, please make sure you satisfy Terminator's
|
|
||||||
dependencies yourself:
|
|
||||||
|
|
||||||
* Python 3.5+ recommended:
|
|
||||||
|
|
||||||
Debian/Ubuntu: python3
|
|
||||||
Fedora/CentOS: python3
|
|
||||||
FreeBSD: python37
|
|
||||||
|
|
||||||
* Python GTK and VTE bindings:
|
|
||||||
|
|
||||||
Fedora/CentOS: python3-gobject python3-configobj python3-psutil vte291
|
|
||||||
keybinder3 intltool gettext
|
|
||||||
Debian/Ubuntu: python3-gi python3-psutil python3-configobj
|
|
||||||
gir1.2-keybinder-3.0 gettext intltool
|
|
||||||
FreeBSD: py37-psutil py37-configobj keybinder-gtk3 py37-gobject3 gettext
|
|
||||||
intltool libnotify vte3
|
|
||||||
|
|
||||||
If you don't care about native language support or icons, Terminator
|
|
||||||
should run just fine directly from this directory, just:
|
|
||||||
|
|
||||||
./terminator --help
|
|
||||||
|
|
||||||
And go from there. Manpages are available in the 'doc' directory.
|
|
||||||
|
|
||||||
To install properly, run:
|
|
||||||
|
|
||||||
./setup.py install --record=install-files.txt
|
|
||||||
|
|
||||||
See --help for an overview of the available options; e.g. --prefix to
|
|
||||||
install to a custom base directory, and --without-gettext to avoid
|
|
||||||
installing natural language support files.
|
|
||||||
|
|
||||||
setup.py supports basic uninstallation provided --record was used for
|
|
||||||
installation as above:
|
|
||||||
|
|
||||||
./setup.py uninstall --manifest=install-files.txt
|
|
||||||
|
|
||||||
Note that uninstall will avoid removing most empty directories so it
|
|
||||||
won't harm e.g. locale or icon directories which only contain Terminator
|
|
||||||
data. It also won't rebuild the icon cache, so you may wish to:
|
|
||||||
|
|
||||||
gtk-update-icon-cache -q -f ${PREFIX}/share/icons/hicolor
|
|
||||||
|
|
||||||
Where ${PREFIX} is the base install directory; e.g. /usr/local.
|
|
||||||
|
|
@ -0,0 +1,110 @@
|
||||||
|
Installing Terminator
|
||||||
|
=====================
|
||||||
|
|
||||||
|
It's strongly recommended to install Terminator using your OS's package
|
||||||
|
system rather than using setup.py yourself.
|
||||||
|
|
||||||
|
Packages are known to be available under the name "terminator" under a
|
||||||
|
lot of distributions, see below for a list.
|
||||||
|
|
||||||
|
## Source Install
|
||||||
|
|
||||||
|
If you can't use distribution packages, make sure you satisfy Terminator's
|
||||||
|
dependencies yourself:
|
||||||
|
|
||||||
|
**Python 3.5+ recommended:** `python3` or `python37` (in FreeBSD)
|
||||||
|
|
||||||
|
**Python GTK and VTE bindings:**
|
||||||
|
|
||||||
|
Fedora/CentOS: python3-gobject python3-configobj python3-psutil vte291
|
||||||
|
keybinder3 intltool gettext
|
||||||
|
Debian/Ubuntu: python3-gi python3-psutil python3-configobj
|
||||||
|
gir1.2-keybinder-3.0 gettext intltool
|
||||||
|
FreeBSD: py37-psutil py37-configobj keybinder-gtk3 py37-gobject3 gettext
|
||||||
|
intltool libnotify vte3
|
||||||
|
|
||||||
|
If you don't care about native language support or icons, Terminator
|
||||||
|
should run just fine directly from this directory, just:
|
||||||
|
|
||||||
|
./terminator --help
|
||||||
|
|
||||||
|
And go from there. Manpages are available in the 'doc' directory.
|
||||||
|
|
||||||
|
> **Note:** Currently most distributions use `python3` as binaries for Python 3,
|
||||||
|
> make sure to update either the shebangs, call the scripts with `python3` or
|
||||||
|
> use a wrapper script.
|
||||||
|
>
|
||||||
|
> Setuptools install will update the scripts with the correct shebang.
|
||||||
|
|
||||||
|
To install properly, run:
|
||||||
|
|
||||||
|
python3 setup.py install --record=install-files.txt
|
||||||
|
|
||||||
|
See `--help` for an overview of the available options; e.g. `--prefix` to
|
||||||
|
install to a custom base directory, and `--without-gettext` to avoid
|
||||||
|
installing natural language support files.
|
||||||
|
|
||||||
|
setup.py supports basic uninstallation provided `--record` was used for
|
||||||
|
installation as above:
|
||||||
|
|
||||||
|
python3 setup.py uninstall --manifest=install-files.txt
|
||||||
|
|
||||||
|
Note that uninstall will avoid removing most empty directories so it
|
||||||
|
won't harm e.g. locale or icon directories which only contain Terminator
|
||||||
|
data. It also won't rebuild the icon cache, so you may wish to:
|
||||||
|
|
||||||
|
gtk-update-icon-cache -q -f ${PREFIX}/share/icons/hicolor
|
||||||
|
|
||||||
|
Where ${PREFIX} is the base install directory; e.g. /usr/local.
|
||||||
|
|
||||||
|
## Distributions
|
||||||
|
|
||||||
|
[](https://repology.org/project/terminator/versions)
|
||||||
|
|
||||||
|
If you maintain terminator for an OS other than these, please get in touch
|
||||||
|
or issue a PR to this file.
|
||||||
|
|
||||||
|
Distribution | Contact | Package Info | Source Code | Bug Tracker |
|
||||||
|
-------------|---------|-----|-------------|-------------|
|
||||||
|
ArchLinux | [@grazzolini] | [archlinux.org] | [git.archlinux.org] | [bugs.archlinux.org]
|
||||||
|
CentOS EPEL | [@mattrose], [@dmaphy] | | [src.fedoraproject.org/branches]
|
||||||
|
Debian | [@lazyfrosch] | [tracker.debian.org] | [salsa.debian.org] | [bugs.debian.org]
|
||||||
|
Fedora | [@mattrose], [@dmaphy] | | [src.fedoraproject.org] | [bugzilla.redhat.com]
|
||||||
|
FreeBSD | | [freshports.org] | [svnweb.freebsd.org] | [bugs.freebsd.org]
|
||||||
|
Gentoo | | [packages.gentoo.org] | [github.com/gentoo] | [bugs.gentoo.org]
|
||||||
|
OpenSUSE | | [build.opensuse.org] |
|
||||||
|
Ubuntu | copied from Debian | [launchpad.net/ubuntu] | | [bugs.launchpad.net]
|
||||||
|
|
||||||
|
[@lazyfrosch]: https://github.com/lazyfrosch
|
||||||
|
[tracker.debian.org]: https://tracker.debian.org/pkg/terminator
|
||||||
|
[salsa.debian.org]: https://salsa.debian.org/python-team/applications/terminator
|
||||||
|
[bugs.debian.org]: https://bugs.debian.org/cgi-bin/pkgreport.cgi?repeatmerged=no&src=terminator
|
||||||
|
|
||||||
|
[@mattrose]: https://github.com/mattrose
|
||||||
|
[@dmaphy]: https://github.com/dmaphy
|
||||||
|
[src.fedoraproject.org]: https://src.fedoraproject.org/rpms/terminator
|
||||||
|
[src.fedoraproject.org/branches]: https://src.fedoraproject.org/rpms/terminator/branches
|
||||||
|
[bugzilla.redhat.com]: https://bugzilla.redhat.com/buglist.cgi?component=terminator&product=Fedora
|
||||||
|
|
||||||
|
[launchpad.net/ubuntu]: https://launchpad.net/ubuntu/+source/terminator
|
||||||
|
[bugs.launchpad.net]: https://bugs.launchpad.net/ubuntu/+source/terminator/+bugs
|
||||||
|
|
||||||
|
[@grazzolini]: https://github.com/grazzolini
|
||||||
|
[archlinux.org]: https://www.archlinux.org/packages/community/any/terminator/
|
||||||
|
[git.archlinux.org]: https://git.archlinux.org/svntogit/community.git/tree/trunk?h=packages/terminator
|
||||||
|
[bugs.archlinux.org]: https://bugs.archlinux.org/?project=5&string=terminator
|
||||||
|
|
||||||
|
[packages.gentoo.org]: https://packages.gentoo.org/packages/x11-terms/terminator
|
||||||
|
[github.com/gentoo]: https://github.com/gentoo/gentoo/tree/master/x11-terms/terminator
|
||||||
|
[bugs.gentoo.org]: https://bugs.gentoo.org/buglist.cgi?quicksearch=x11-terms%2Fterminator
|
||||||
|
|
||||||
|
[build.opensuse.org]: https://build.opensuse.org/package/show/X11:terminals/terminator
|
||||||
|
|
||||||
|
[svnweb.freebsd.org]: https://svnweb.freebsd.org/ports/head/x11/terminator
|
||||||
|
[freshports.org]: https://freshports.org/x11/terminator
|
||||||
|
[bugs.freebsd.org]: https://bugs.freebsd.org/bugzilla/buglist.cgi?quicksearch=terminator
|
||||||
|
|
||||||
|
A more extensive list can be found on Repology:
|
||||||
|
|
||||||
|
[](https://repology.org/project/terminator/versions)
|
||||||
|
|
||||||
Loading…
Reference in New Issue