Input methods - Revision history

Blu256: Moved content from uncategorised "IBus" page

2022-01-01T17:50:56Z

Moved content from uncategorised "IBus" page

Blu256: Replaced dead link with link to Wayback Machine archived version

2021-12-20T14:39:20Z

Replaced dead link with link to Wayback Machine archived version

Blu256: Added blank lines

2021-12-20T14:34:34Z

Added blank lines

Blu256: /* Installation */ Cosmetic changes

2021-12-20T14:33:05Z

Installation: Cosmetic changes

Blu256: /* Environment variables */ Cosmetic changes

2021-12-20T14:31:26Z

Environment variables: Cosmetic changes

Blu256: Added "Input Methods" page based on TQt's README.immodule

2021-12-20T14:25:32Z

Added "Input Methods" page based on TQt's README.immodule

New page

TQt comes with ''<tt>immodule</tt>'', a modular, extensible input method subsystem. The main goal of <tt>immodule</tt> is to extend and enhance the input method support in the TQt library, in order to provide a modern and powerful multi-language input system, and is similar to the <tt>immodule</tt> for GTK+.

== Installation ==
<tt>immodule</tt> is part of the standard TQt distribution.

<tt>immodule</tt> provides two additional <tt>./configure</tt> options. Choose 'Binary Compatible' for normal use.

{| class="wikitable"
! Options
! Description
|-
| <code>./configure -inputmethod</code>
| Build TQt with 'Binary Compatible' immodule support (default)
|-
| <code>./configure -inputmethod -inputmethod-ext</code>
| Build TQt without binary compatibility, but supports more advanced <tt>immodule</tt> extensions. It cannot be used with ordinary application binaries (i.e. the option is for developers)
|}

== How to use ==

* See users manual of each input method plugins

* Run <code>tqtconfig</code> to choose your favorite XIM input style

=== Environment variables ===

Some environment variables are available for expert users and system integrators. See following examples to use the variables.

{| class="wikitable"
! Example
! Description
|-
| <code>export TQT_IM_MODULE=xim</code>
| Set "xim" input method as default
|-
| <code>export TQT_IM_MODULE=simple</code>
| Set "simple" composing input method as default
|-
| <code>export TQT_IM_SWITCHER=imsw-none<br>export TQT_IM_MODULE=xim</code>
| Set "xim" input method as default, and disable input method selection menu in the context menu*
|-
| <code>export TQT_IM_SWITCHER=imsw-multi<br>export TQT_IM_MODULE=xim</code>
| Set "xim" input method as default, and enable input method selection menu in the context menu* (default configuration)
|-
| <code>export TQT_IM_SWITCHER=imsw-none<br>export TQT_IM_MODULE=iiimqcf</code>
| Set "iiimqcf" that has its own input method switching framework as default, and disable input method selection menu in the context menu. Such configuration is required by some system integrators to provide unified user interface for global input method switching over the desktop
|}

<tt>*</tt> ''Input method selection menu might not be available in some TDE apps.''

== Links ==
* [http://immodule-qt.freedesktop.org/ immodule-qt web-site]
* [https://mirror.git.trinitydesktop.org/gitea/TDE/tqt3/raw/branch/master/README.immodule README.immodule in the TQt source repository] (this article was based on this README)

[[Category:Developers]]

@@ Line 29: / Line 29: @@
 * Run <code>tqtconfig</code> to choose your favorite XIM input style
+=== IBus ===
+IBus is a multilingual input method commonly used for input in languages like Chinese.
+IBus works is confirmed to work with Trinity, with the changes below:
+'''1. Applications need this variable in their environment:'''
+<syntaxhighlight lang="shell-session">
+$ export XMODIFIERS=@im=ibus
+</syntaxhighlight>
+You can add it in your ~/.bashrc or in the terminal just before launching the application.
+'''2. IBus daemon needs to be in XIM mode'''
+<syntaxhighlight lang="shell-session">
+$ ibus-daemon --xim -d
+</syntaxhighlight>
+'''3. Enable the "Embed preedit text" option.'''
+Otherwise it appears at the bottom left corner of the window.
+Right-click on the IBus applet, go to <code>Preferences</code> and enable the "Embed preedit text in application window" option.
+====Known pitfalls====
+* If QT_IM_MODULE is defined (even if it is empty), it blocks IBus. Make sure it's not set anywhere. Remove it from any file, like <tt>~/.xprofile</tt> or <tt>~/.bashrc</tt>.
+* You need to launch IBus first.
+* If IBus is closed while an application is using it, the app will crash.

@@ Line 32: / Line 32: @@
 ! Description
 |-
+| <syntaxhighlight lang="shell-session">
-| <code>export TQT_IM_MODULE=xim</code>
+$ export TQT_IM_MODULE=xim
+</syntaxhighlight>
 | Set "xim" input method as default
 |-
+| <syntaxhighlight lang="shell-session">
-| <code>export TQT_IM_MODULE=simple</code>
+$ export TQT_IM_MODULE=simple
+</syntaxhighlight>
 | Set "simple" composing input method as default
 |-
+| <syntaxhighlight lang="shell-session">
-| <code>export TQT_IM_SWITCHER=imsw-none<br>export TQT_IM_MODULE=xim</code>
+$ export TQT_IM_SWITCHER=imsw-none
+$ export TQT_IM_MODULE=xim
+</syntaxhighlight>
 | Set "xim" input method as default, and disable input method selection menu in the context menu*
 |-
+|
-| <code>export TQT_IM_SWITCHER=imsw-multi<br>export TQT_IM_MODULE=xim</code>
+<syntaxhighlight lang="shell-session">
+$ export TQT_IM_SWITCHER=imsw-multi
+$ export TQT_IM_MODULE=xim
+</syntaxhighlight>
 | Set "xim" input method as default, and enable input method selection menu in the context menu* (default configuration)
 |-
+| <syntaxhighlight lang="shell-session">
-| <code>export TQT_IM_SWITCHER=imsw-none<br>export TQT_IM_MODULE=iiimqcf</code>
+$ export TQT_IM_SWITCHER=imsw-none
-| Set "iiimqcf" that has its own input method switching framework as default, and disable input method selection menu in the context menu. Such configuration is required by some system integrators to provide unified user interface for global input method switching over the desktop
+$ export TQT_IM_MODULE=iiimqcf
+</syntaxhighlight>
+| Set "iiimqcf" that has its own input method switching framework as default, and disable input method selection menu in the context menu.
+Such configuration is required by some system integrators to provide unified user interface for global input method switching over the desktop
 |}
 <tt>*</tt> ''Input method selection menu might not be available in some TDE apps.''
 == Links ==

@@ Line 74: / Line 74: @@
 == Links ==
-* [http://immodule-qt.freedesktop.org/ immodule-qt web-site]
+* [http://web.archive.org/web/20040930060824/http://immodule-qt.freedesktop.org/ Archived immodule-qt web-site (2004/09/30)]
 * [https://mirror.git.trinitydesktop.org/gitea/TDE/tqt3/raw/branch/master/README.immodule README.immodule in the TQt source repository] (this article was based on this README)

@@ Line 1: / Line 1: @@
 TQt comes with ''<tt>immodule</tt>'', a modular, extensible input method subsystem. The main goal of <tt>immodule</tt> is to extend and enhance the input method support in the TQt library, in order to provide a modern and powerful multi-language input system, and is similar to the <tt>immodule</tt> for GTK+.
+__TOC__
 == Installation ==
@@ Line 19: / Line 22: @@
 You should choose 'Binary Compatible' for normal use.
 == How to use ==
@@ Line 67: / Line 71: @@
 <tt>*</tt> ''Input method selection menu might not be available in some TDE apps.''
 == Links ==

@@ Line 4: / Line 4: @@
 <tt>immodule</tt> is part of the standard TQt distribution.
-<tt>immodule</tt> provides two additional <tt>./configure</tt> options. Choose 'Binary Compatible' for normal use.
+<tt>immodule</tt> provides two additional <tt>./configure</tt> options:
 {| class="wikitable"
@@ Line 10: / Line 10: @@
 ! Description
 |-
-| <code>./configure -inputmethod</code>
+| <syntaxhighlight lang="shell-session">$ ./configure -inputmethod</syntaxhighlight>
-| Build TQt with 'Binary Compatible' immodule support (default)
+| Build TQt with 'Binary Compatible' immodule support '''(default)'''
 |-
-| <code>./configure -inputmethod -inputmethod-ext</code>
+| <syntaxhighlight lang="shell-session">$ ./configure -inputmethod -inputmethod-ext</syntaxhighlight>
-| Build TQt without binary compatibility, but supports more advanced <tt>immodule</tt> extensions. It cannot be used with ordinary application binaries (i.e. the option is for developers)
+| Build TQt without binary compatibility, but supports more advanced <tt>immodule</tt> extensions.
+It cannot be used with ordinary application binaries (i.e. the option is for developers)
 |}
+You should choose 'Binary Compatible' for normal use.
 == How to use ==