help/C/account-irc.page

   1 <page xmlns="http://projectmallard.org/1.0/"
   2       xmlns:its="http://www.w3.org/2005/11/its"
   3       xmlns:e="http://projectmallard.org/experimental/"
   4       type="topic" style="screen"
   5       id="account-irc">
   6
   7   <info>
   8     <link type="guide" xref="irc-manage#manage"/>
   9     <desc>Additional information necessary for connecting to IRC networks.</desc>
  10     <revision pkgversion="2.28" version="0.1" date="2009-08-31" status="review">
  11       <!--
  12       <e:review by="shaunm@gnome.org" date="2009-08-31" status="done"/>
  13       -->
  14     </revision>
  15     <revision pkgversion="2.30" version="0.2" date="2010-04-19" status="review"/>
  16     <credit type="author">
  17       <name>Shaun McCance</name>
  18       <email its:translate="no">shaunm@gnome.org</email>
  19     </credit>
  20     <license>
  21       <p>Creative Commons Share Alike 3.0</p>
  22     </license>
  23 <!--
  24     <copyright>
  25       <year>2009</year>
  26       <name>GNOME Documentation Project</name>
  27     </copyright>
  28     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  29 -->
  30   </info>
  31
  32   <title>IRC account details</title>
  33
  34   <p>IRC accounts require different information than many other types of
  35   accounts.  To create an IRC account, you must specify at least an IRC
  36   network and a nickname.  This page details the information you can
  37   provide for an IRC account.</p>
  38
  39   <note style="info package">
  40     <p>You must have the <sys>telepathy-idle</sys> package installed to use IRC
  41     in <app>Empathy</app>.</p>
  42   </note>
  43
  44   <terms>
  45     <item>
  46       <title><gui>Network</gui></title>
  47       <p>IRC is an open system that allows people to run separate IRC
  48       networks.  Each network is distinct and has its own users and
  49       chat rooms.  <app>Empathy</app> lists the most popular networks
  50       in the <gui>Network</gui> drop-down list.  You can add additional
  51       networks.  See <link xref="#networks"/> below.</p>
  52     </item>
  53     <item>
  54       <title><gui>Nickname</gui></title>
  55       <p>Your nickname is your unique name on the IRC network. Only one
  56       person on a network may use a given nickname.  If you get an error
  57       message that says <link xref="prob-conn-name" role="error-msg"/>
  58       you will need to change your nickname.</p>
  59     </item>
  60     <item>
  61       <title><gui>Password</gui></title>
  62       <p>Some servers, particularly those on private networks, require
  63       a password to connect.  If you are authorized to use the network,
  64       the network administrators should provide you with a password.</p>
  65       <note>
  66         <title>NickServ Passwords</title>
  67         <p>On some networks, nicknames can be registered using a service
  68         known as NickServ.  <app>Empathy</app> does not directly support
  69         nickname passwords.  On some networks, including the popular
  70         freenode network, server passwords are automatically forwarded
  71         to NickServ, allowing you to set this field to identify yourself
  72         with NickServ.  See <link xref="irc-nick-password"/> for more
  73         details.</p>
  74       </note>
  75     </item>
  76     <item>
  77       <title><gui>Real name</gui></title>
  78       <p>You can provide your real name in addition to your nickname.  Other
  79       users will be able to see this when they view your information.</p>
  80     </item>
  81     <item>
  82       <title><gui>Quit message</gui></title>
  83       <p>When you go offline, a quit message is sent to all the chat rooms
  84       you’re in and to all the users you’re having a private conversation
  85       with.  Use this field to provide a custom quit message.</p>
  86     </item>
  87   </terms>
  88
  89 <!--
  90 telepathy-idle note
  91 -->
  92
  93   <section id="networks">
  94     <info>
  95       <title type="link">IRC Networks</title>
  96     </info>
  97
  98     <title>Networks</title>
  99
 100     <p><app>Empathy</app> includes a list of popular IRC networks.  If you
 101     wish to another IRC network, you can add it to the list.  You can also
 102     modify networks and remove them from the list.</p>
 103
 104     <list>
 105       <item><p>To add a network to the list, click <media type="image"
 106       mime="image/png" src="figures/gtk-add.png" width="16"
 107       height="16" its:translate="no"><span
 108       its:translate="yes">Add</span></media>.</p></item>
 109       <item><p>To modify a network in the list, select the network and click
 110       <media type="image" mime="image/png" src="figures/gtk-edit.png" width="16"
 111       height="16" its:translate="no"><span
 112       its:translate="yes">Edit</span></media>.</p></item>
 113       <item><p>To remove a network from the list, select the network and
 114       click <media type="image" mime="image/png" src="figures/gtk-remove.png"
 115       width="16" height="16" its:translate="no"><span
 116       its:translate="yes">Remove</span></media>.</p></item>
 117     </list>
 118
 119     <p>When adding or modifying a network, you can enter the following
 120     information:</p>
 121
 122     <terms>
 123       <item>
 124         <title><gui>Network</gui></title>
 125         <p>This is the name of the network as you want it to appear in
 126         the list of networks.</p>
 127       </item>
 128       <item>
 129         <title><gui>Charset</gui></title>
 130         <p>This specifies the character encoding that is typically used on
 131         this network.  A character encoding is a specific way of recording
 132         characters internally in a computer.  There are many character
 133         encodings, and you need to use the same character encoding as other
 134         users to see their messages correctly.</p>
 135         <!--
 136             Translators: Recommend character encodings that are common
 137             for your language.
 138         -->
 139         <p>By default, <app>Empathy</app> uses UTF-8, a modern character
 140         encoding that can handle text from most of the world's languages.
 141         Another common encoding for English and some other Western languages
 142         is ISO-8859-1.</p>
 143       </item>
 144       <item>
 145         <title><gui>Servers</gui></title>
 146         <p>An IRC network may have many servers you can connect to.  When
 147         you are connected to a server on a particular network, you can
 148         communicate with all users on all other servers on that network.
 149         You can add and remove servers for this network using the
 150         <gui>Add</gui> and <gui>Remove</gui> buttons.</p>
 151         <p>When a server is selected, click the field under <gui>Server</gui>
 152         or <gui>Port</gui> to edit it.  Alternatively, use the left and right
 153         arrow keys to focus the field, and press the space bar to begin
 154         editing.</p>
 155         <p>Select the check box in the <gui>SSL</gui> column to encrypt
 156         all communication with a server.  Note that this does not prevent
 157         other users on the network from seeing what you write on public
 158         chat rooms.</p>
 159       </item>
 160     </terms>
 161   </section>
 162 </page>