Changeset View
Changeset View
Standalone View
Standalone View
doc/index.docbook
Show First 20 Lines • Show All 105 Lines • ▼ Show 20 Line(s) | |||||
106 | 106 | | |||
107 | <keywordset> | 107 | <keywordset> | ||
108 | <keyword>KDE</keyword> | 108 | <keyword>KDE</keyword> | ||
109 | <keyword>IM</keyword> | 109 | <keyword>IM</keyword> | ||
110 | <keyword>Instant</keyword> | 110 | <keyword>Instant</keyword> | ||
111 | <keyword>Messaging</keyword> | 111 | <keyword>Messaging</keyword> | ||
112 | <keyword>Jabber</keyword> | 112 | <keyword>Jabber</keyword> | ||
113 | <keyword>IRC</keyword> | 113 | <keyword>IRC</keyword> | ||
114 | <keyword>WLM</keyword> | | |||
115 | <keyword>ICQ</keyword> | 114 | <keyword>ICQ</keyword> | ||
116 | <keyword>AIM</keyword> | 115 | <keyword>AIM</keyword> | ||
117 | <keyword>Yahoo</keyword> | 116 | <keyword>Yahoo</keyword> | ||
118 | <keyword>Gadu-Gadu</keyword> | 117 | <keyword>Gadu-Gadu</keyword> | ||
119 | <keyword>GroupWise</keyword> | 118 | <keyword>GroupWise</keyword> | ||
120 | <keyword>Novell</keyword> | 119 | <keyword>Novell</keyword> | ||
121 | <keyword>WinPopup</keyword> | 120 | <keyword>WinPopup</keyword> | ||
122 | <keyword>SMS</keyword> | 121 | <keyword>SMS</keyword> | ||
Show All 30 Lines | |||||
153 | </sect1> | 152 | </sect1> | ||
154 | </chapter> | 153 | </chapter> | ||
155 | 154 | | |||
156 | <chapter id="getting-started"> | 155 | <chapter id="getting-started"> | ||
157 | <title>Getting Started</title> | 156 | <title>Getting Started</title> | ||
158 | <para>To use &kopete; you need to set up one or more accounts for the instant messaging services you wish to use.</para> | 157 | <para>To use &kopete; you need to set up one or more accounts for the instant messaging services you wish to use.</para> | ||
159 | <para>You've probably already chosen a messaging service, either because you already use &im;, or you need to use the same service as your friends. If you don't fit into either of these categories, please consider using a messaging service based on open standards, because these are designed for use by Free Software. Other messaging services are prone to changing the underlying technology without making the details freely available, making them harder for Free Software developers to support.</para> | 158 | <para>You've probably already chosen a messaging service, either because you already use &im;, or you need to use the same service as your friends. If you don't fit into either of these categories, please consider using a messaging service based on open standards, because these are designed for use by Free Software. Other messaging services are prone to changing the underlying technology without making the details freely available, making them harder for Free Software developers to support.</para> | ||
160 | <para>The messaging services that &kopete; supports that are based on open standards are Jabber and IRC.</para> | 159 | <para>The messaging services that &kopete; supports that are based on open standards are Jabber and IRC.</para> | ||
161 | <para>The following section assumes you are registered with an &im; service already. If not, you can register with Gadu-Gadu, Jabber, and <trademark>WLM</trademark> from inside &kopete;; for other services, you'll have to register using their respective web site before creating an account in &kopete;.</para> | 160 | <para>The following section assumes you are registered with an &im; service already. If not, you can register with Gadu-Gadu, and Jabber from inside &kopete;; for other services, you'll have to register using their respective web site before creating an account in &kopete;.</para> | ||
162 | <sect1 id="creating-accounts"> | 161 | <sect1 id="creating-accounts"> | ||
163 | <title>Creating Accounts</title> | 162 | <title>Creating Accounts</title> | ||
164 | <para>To create an account, use <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure...</guimenuitem> </menuchoice> to display the Configure window.</para> | 163 | <para>To create an account, use <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure...</guimenuitem> </menuchoice> to display the Configure window.</para> | ||
165 | <para>The Configure window is the main way to set up and customize &kopete;. On the left a column of icons control which aspect of &kopete; is being configured. Click the <guiicon>Accounts</guiicon> icon. The main pane will change to display the account management pane. This is currently empty, but will soon list your &im; accounts. Click <guibutton>Add Account</guibutton> to display the <interface>Account Wizard</interface>.</para> | 164 | <para>The Configure window is the main way to set up and customize &kopete;. On the left a column of icons control which aspect of &kopete; is being configured. Click the <guiicon>Accounts</guiicon> icon. The main pane will change to display the account management pane. This is currently empty, but will soon list your &im; accounts. Click <guibutton>Add Account</guibutton> to display the <interface>Account Wizard</interface>.</para> | ||
166 | <para>The <interface>Account Wizard</interface> helps you create an &im; account. On the first page, you are asked to select the messaging service that you'd like to use. Click one of the services shown and then click <guibutton>Next</guibutton>. On the following page, you should enter your registration details for that instant messaging service.</para> | 165 | <para>The <interface>Account Wizard</interface> helps you create an &im; account. On the first page, you are asked to select the messaging service that you'd like to use. Click one of the services shown and then click <guibutton>Next</guibutton>. On the following page, you should enter your registration details for that instant messaging service.</para> | ||
167 | <para>Most services just require you to enter a username or unique identifying number (<acronym>UIN</acronym>) and password. The special purpose services Winpopup and <acronym>SMS</acronym> work slightly differently, so please see their specific sections. There are a couple of other options that apply to most services that you should look at:</para> | 166 | <para>Most services just require you to enter a username or unique identifying number (<acronym>UIN</acronym>) and password. The special purpose services Winpopup and <acronym>SMS</acronym> work slightly differently, so please see their specific sections. There are a couple of other options that apply to most services that you should look at:</para> | ||
168 | <variablelist> | 167 | <variablelist> | ||
169 | <varlistentry><term>Remember password</term><listitem><para>When this is checked, &kopete; will store the password for you, so you don't have to enter it every time you connect to the &im; service. If you are security-conscious or want to limit access to the &im; account you can leave this unchecked.</para></listitem></varlistentry> | 168 | <varlistentry><term>Remember password</term><listitem><para>When this is checked, &kopete; will store the password for you, so you don't have to enter it every time you connect to the &im; service. If you are security-conscious or want to limit access to the &im; account you can leave this unchecked.</para></listitem></varlistentry> | ||
▲ Show 20 Lines • Show All 518 Lines • ▼ Show 20 Line(s) | 685 | <sect1 id="protocols-list"> | |||
688 | <sect2 id="protocols-aim"> | 687 | <sect2 id="protocols-aim"> | ||
689 | <title>AIM</title> | 688 | <title>AIM</title> | ||
690 | <para>AIM supports chatrooms. Use the <guilabel>Join Chat...</guilabel> command on the AIM account menu to join a chatroom. Contact pictures and custom emoticons are also supported.</para> | 689 | <para>AIM supports chatrooms. Use the <guilabel>Join Chat...</guilabel> command on the AIM account menu to join a chatroom. Contact pictures and custom emoticons are also supported.</para> | ||
691 | </sect2> | 690 | </sect2> | ||
692 | <sect2 id="protocols-icq"> | 691 | <sect2 id="protocols-icq"> | ||
693 | <title>ICQ</title> | 692 | <title>ICQ</title> | ||
694 | <para>ICQ has an Invisibility feature which allows you to hide from selected contacts. You may also search the ICQ user folder when adding a contact. A wide range of contact details can be set using the <guilabel>Properties</guilabel> option.</para> | 693 | <para>ICQ has an Invisibility feature which allows you to hide from selected contacts. You may also search the ICQ user folder when adding a contact. A wide range of contact details can be set using the <guilabel>Properties</guilabel> option.</para> | ||
695 | </sect2> | 694 | </sect2> | ||
696 | <sect2 id="protocols-msn"> | | |||
697 | <title>WLM</title> | | |||
698 | <para>File transfer and multi user chats work. To transfer a file, drag the file from &dolphin; or the desktop into the chat window. To invite someone else into a chat, drag them from the Contact List into the chat window. The <menuchoice><guimenu>File</guimenu></menuchoice> menu also contains these commands. In addition, WLM supports custom emoticons.</para> | | |||
699 | <para>To use file transfer, make sure port 6891 is forwarded to your computer.</para> | | |||
700 | </sect2> | | |||
701 | <sect2 id="protocols-yahoo"> | 695 | <sect2 id="protocols-yahoo"> | ||
702 | <title>Yahoo</title> | 696 | <title>Yahoo</title> | ||
703 | <para>Yahoo can send and receive webcam video. It also supports Yahoo mail and the Yahoo address book from the account menu. Conferencing is also possible.</para> | 697 | <para>Yahoo can send and receive webcam video. It also supports Yahoo mail and the Yahoo address book from the account menu. Conferencing is also possible.</para> | ||
704 | </sect2> | 698 | </sect2> | ||
705 | <sect2 id="protocols-jabber"> | 699 | <sect2 id="protocols-jabber"> | ||
706 | <title>Jabber</title> | 700 | <title>Jabber</title> | ||
707 | <para>Jabber, also known as XMPP, supports file transfer, conferencing and any other services supplied by the Jabber server. For example, many Jabber servers have a user directory, and some provide transports to other messaging systems. To access services, use <menuchoice><guimenu>Services...</guimenu></menuchoice> on the account menu. Jabber file transfer can work without port forwarding, but enjoys better performance where a direct connection is possible. By default, port 8010 is used for port forwarding, but this is configurable in each account's settings.</para> | 701 | <para>Jabber, also known as XMPP, supports file transfer, conferencing and any other services supplied by the Jabber server. For example, many Jabber servers have a user directory, and some provide transports to other messaging systems. To access services, use <menuchoice><guimenu>Services...</guimenu></menuchoice> on the account menu. Jabber file transfer can work without port forwarding, but enjoys better performance where a direct connection is possible. By default, port 8010 is used for port forwarding, but this is configurable in each account's settings.</para> | ||
708 | </sect2> | 702 | </sect2> | ||
▲ Show 20 Lines • Show All 333 Lines • ▼ Show 20 Line(s) | |||||
1042 | </question> | 1036 | </question> | ||
1043 | <answer><para>You can change the order of accounts &kopete; tries to message people with by using the Up and Down arrows in the bottom right corner of the account configuration screen. &kopete; will try to connect with accounts starting from the top. However, if one service has a higher status value than the others for that user, &kopete; will use that one. For example, if a person has three services and two are marked as away and the third is marked as online, &kopete; will always try to message the user using the online service.</para><tip><para>If you click on the small protocol icon on the right of the menu item, instead of on the person's name, you will always try to contact the person using that service!</para></tip> | 1037 | <answer><para>You can change the order of accounts &kopete; tries to message people with by using the Up and Down arrows in the bottom right corner of the account configuration screen. &kopete; will try to connect with accounts starting from the top. However, if one service has a higher status value than the others for that user, &kopete; will use that one. For example, if a person has three services and two are marked as away and the third is marked as online, &kopete; will always try to message the user using the online service.</para><tip><para>If you click on the small protocol icon on the right of the menu item, instead of on the person's name, you will always try to contact the person using that service!</para></tip> | ||
1044 | </answer> | 1038 | </answer> | ||
1045 | </qandaentry> | 1039 | </qandaentry> | ||
1046 | <qandaentry> | 1040 | <qandaentry> | ||
1047 | <question><para>I need to connect via a SOCKS proxy, but I cannot find any proxy configuration options in &kopete;. How do I set up &kopete; to use SOCKS?</para> | 1041 | <question><para>I need to connect via a SOCKS proxy, but I cannot find any proxy configuration options in &kopete;. How do I set up &kopete; to use SOCKS?</para> | ||
1048 | </question> | 1042 | </question> | ||
1049 | <answer><itemizedlist> | 1043 | <answer><itemizedlist> | ||
1050 | <listitem><para><trademark>WLM</trademark>, <trademark>ICQ</trademark>, <trademark>AIM</trademark>, Jabber, and <trademark>Yahoo</trademark> use the &kde; network infrastructure. Their SOCKS proxy details are configured with the rest of &kde;, in &systemsettings;, <menuchoice><guimenu>Network and Connectivity</guimenu><guisubmenu>Network Settings</guisubmenu><guimenuitem>Proxy</guimenuitem></menuchoice>.</para></listitem> | 1044 | <listitem><para><trademark>ICQ</trademark>, <trademark>AIM</trademark>, Jabber, and <trademark>Yahoo</trademark> use the &kde; network infrastructure. Their SOCKS proxy details are configured with the rest of &kde;, in &systemsettings;, <menuchoice><guimenu>Network and Connectivity</guimenu><guisubmenu>Network Settings</guisubmenu><guimenuitem>Proxy</guimenuitem></menuchoice>.</para></listitem> | ||
1051 | </itemizedlist> | 1045 | </itemizedlist> | ||
1052 | </answer> | 1046 | </answer> | ||
1053 | </qandaentry> | 1047 | </qandaentry> | ||
1054 | <qandaentry> | 1048 | <qandaentry> | ||
1055 | <question><para>Is it possible to customize the icons I see in &kopete;?</para></question> | 1049 | <question><para>Is it possible to customize the icons I see in &kopete;?</para></question> | ||
1056 | <answer><para>You can switch between different emoticons using the Emoticons tab of the Appearance page of the Configure &kopete; dialog.</para> | 1050 | <answer><para>You can switch between different emoticons using the Emoticons tab of the Appearance page of the Configure &kopete; dialog.</para> | ||
1057 | <para>To install new emoticons, first look at the <ulink url="https://store.kde.org/">KDE Store</ulink>, where there are a lot of additional emoticon sets to download.</para> | 1051 | <para>To install new emoticons, first look at the <ulink url="https://store.kde.org/">KDE Store</ulink>, where there are a lot of additional emoticon sets to download.</para> | ||
1058 | 1052 | | |||
▲ Show 20 Lines • Show All 61 Lines • ▼ Show 20 Line(s) | |||||
1120 | </qandaentry> | 1114 | </qandaentry> | ||
1121 | <qandaentry> | 1115 | <qandaentry> | ||
1122 | <question><para>Jabber SSL support stopped working, I get the message that the QCA TLS plugin is probably missing. What am I supposed to do?</para> | 1116 | <question><para>Jabber SSL support stopped working, I get the message that the QCA TLS plugin is probably missing. What am I supposed to do?</para> | ||
1123 | </question> | 1117 | </question> | ||
1124 | <answer><para>As the error message indicates, you are missing the QCA TLS plugin, which handles the Jabber plugin's TLS/SSL encryption. Install the package <application>qca-tls</application> (and eventually <application>qca-ossl</application>) or retrieve the plugin from <ulink url="http://delta.affinix.com/qca">its homepage</ulink>. Please note that you only need to install the <application>qca-tls</application> plugin, <emphasis>not</emphasis> the QCA library itself. A recompilation of &kopete; is not necessary, in fact not even a restart. In case you have installed the plugin and it still won't work, Qt can probably not find it. Since qca-tls installs itself as a &Qt; plugin, you will have to make sure that it gets installed to the plugin directory of the &Qt; version you are using to run &kopete;.</para> | 1118 | <answer><para>As the error message indicates, you are missing the QCA TLS plugin, which handles the Jabber plugin's TLS/SSL encryption. Install the package <application>qca-tls</application> (and eventually <application>qca-ossl</application>) or retrieve the plugin from <ulink url="http://delta.affinix.com/qca">its homepage</ulink>. Please note that you only need to install the <application>qca-tls</application> plugin, <emphasis>not</emphasis> the QCA library itself. A recompilation of &kopete; is not necessary, in fact not even a restart. In case you have installed the plugin and it still won't work, Qt can probably not find it. Since qca-tls installs itself as a &Qt; plugin, you will have to make sure that it gets installed to the plugin directory of the &Qt; version you are using to run &kopete;.</para> | ||
1125 | </answer> | 1119 | </answer> | ||
1126 | </qandaentry> | 1120 | </qandaentry> | ||
1127 | <qandaentry> | 1121 | <qandaentry> | ||
1128 | <question><para>I AM behind a firewall. Which ports need to be open for WLM file transfers?</para> | | |||
1129 | </question> | | |||
1130 | <answer><para>If you are behind a firewall, port 6891 needs to be open to inbound TCP traffic.</para> | | |||
1131 | </answer> | | |||
1132 | </qandaentry> | | |||
1133 | <qandaentry> | | |||
1134 | <question><para>I use Jabber and ICQ together. Whenever I go online with Jabber, I am disconnected from ICQ with an error message about being connected from another client. What's | 1122 | <question><para>I use Jabber and ICQ together. Whenever I go online with Jabber, I am disconnected from ICQ with an error message about being connected from another client. What's | ||
1135 | up?</para> | 1123 | up?</para> | ||
1136 | </question> | 1124 | </question> | ||
1137 | <answer><para>Remember when you played with ICQ transports on that other Jabber client? You set up an <quote>ICQ Transport</quote> which allows you to talk to ICQ people from Jabber. ICQ doesn't allow multiple connections to the same account, and disconnects you. Look in your Jabber contacts for a contact of the form <guilabel>123456@icq.jabber.org</guilabel> and delete it.</para> | 1125 | <answer><para>Remember when you played with ICQ transports on that other Jabber client? You set up an <quote>ICQ Transport</quote> which allows you to talk to ICQ people from Jabber. ICQ doesn't allow multiple connections to the same account, and disconnects you. Look in your Jabber contacts for a contact of the form <guilabel>123456@icq.jabber.org</guilabel> and delete it.</para> | ||
1138 | </answer> | 1126 | </answer> | ||
1139 | </qandaentry> | 1127 | </qandaentry> | ||
1140 | </qandaset> | 1128 | </qandaset> | ||
1141 | </chapter> <!-- faq --> | 1129 | </chapter> <!-- faq --> | ||
▲ Show 20 Lines • Show All 83 Lines • Show Last 20 Lines |