Skip to content

Commit

Permalink
Merge branch 'feat/maintenance' into 'main'
Browse files Browse the repository at this point in the history
Update IBus Cangjie installation instructions

See merge request cangjie/cangjie.pages.freedesktop.org!31
  • Loading branch information
yookoala committed Aug 21, 2024
2 parents 35a8304 + 98633cb commit 28e2384
Showing 1 changed file with 25 additions and 14 deletions.
39 changes: 25 additions & 14 deletions projects/ibus-cangjie/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,9 @@ or use autounmask. Once unmasked install as root with :
$ emerge app-i18n/ibus-cangjie
```

## Ubuntu 14.04 or later
## Ubuntu

IBus Cangjie is included in the default Ubuntu repositories, **starting with
IBus Cangjie is included in the default Ubuntu repositories, **since
the 14.04 release**, so you can install it with `apt-get`:

```
Expand All @@ -63,20 +63,30 @@ To build IBus Cangjie, you will need the following:

* Python >= 3.2
* the Python 3 GObject bindings
* IBus >= 1.4.1 (note that its GObject-Introspection bindings must be enabled)
* IBus >= 1.5 (note that its GObject-Introspection bindings must be enabled)
* pycangjie
* pycanberra: this is **optional**, only needed to play event sounds,
especially to give feedback to the user on incorrect inputs. IBus Cangjie
will fail gracefully if pycanberra is not available though, and just won't
play any sound.

### Install from a release tarball
### G​et the Source Code

Download a release tarball from
[the releases section](https://gitlab.freedesktop.org/cangjie/ibus-cangjie/-/releases) on.
For stable releases, you may download the release tarball from
[the releases section][releases] of our repository page.

Installation requires [meson](https://mesonbuild.com/) build system to run.
After installing meson, from the root folder of the unpacked tarball, run:
Alternatively, you may get the latest development version (or or any release
version) with [git][git] with this command:

```
$ git clone https://gitlab.freedesktop.org/cangjie/ibus-cangjie.git
```

### Compile and Install

L​atest developement version of ibus-cangjie requires the [meson][meson]
build system to compile. After installing meson, from the root folder of the
source code, run:

```
$ meson setup ./builddir --prefix=/usr --wipe
Expand All @@ -91,13 +101,9 @@ restart ibus daemon to reload the newly built and installed version:
$ ibus restart
```

### Install from Git
#### For Older Versions

First, you need to clone the development repository:

```
$ git clone https://gitlab.freedesktop.org/cangjie/ibus-cangjie.git
```
Previous releases (2.4 or earlier) is built with [GNU Automake][automake].

Then, from the root folder of the Git clone, do the usual Autotools dance:

Expand All @@ -106,3 +112,8 @@ $ ./autogen.sh
$ make
$ sudo make install
```

[releases]: https://gitlab.freedesktop.org/cangjie/ibus-cangjie/-/releases
[meson]: https://mesonbuild.com/
[git]: https://git-scm.com/
[automake]: https://www.gnu.org/software/automake/manual/html_node/index.html

0 comments on commit 28e2384

Please sign in to comment.