sylpheed-8.html 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  2. <HTML>
  3. <HEAD>
  4. <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
  5. <TITLE>Sylpheed User's Manual: Sylpheed configuration</TITLE>
  6. <LINK HREF="sylpheed-9.html" REL=next>
  7. <LINK HREF="sylpheed-7.html" REL=previous>
  8. <LINK HREF="sylpheed.html#toc8" REL=contents>
  9. </HEAD>
  10. <BODY>
  11. <A HREF="sylpheed-9.html">Next</A>
  12. <A HREF="sylpheed-7.html">Previous</A>
  13. <A HREF="sylpheed.html#toc8">Contents</A>
  14. <HR>
  15. <H2><A NAME="s8">8.</A> <A HREF="sylpheed.html#toc8">Sylpheed configuration</A></H2>
  16. <P>All the configuration settings of Sylpheed are accessible from
  17. the <I>Configuration</I> menu and consist of common settings
  18. (<I>Common preferences</I>, <I>Filter settings</I>,
  19. <I>Template</I> and <I>actions</I>) and account specific
  20. settings.</P>
  21. <P>With Sylpheed, there is no limit to the number of accounts
  22. you can create. You can create new accounts for each of your
  23. mail account, but also to change the default behaviour of
  24. Sylpheed. As folders can be attached to accounts, the account
  25. specific part of the configuration automatically change based
  26. on the current folder (you can have a different signature when
  27. replying to messages from different folders).</P>
  28. <H2><A NAME="ss8.1">8.1</A> <A HREF="sylpheed.html#toc8.1">Common preferences</A>
  29. </H2>
  30. <P>The Common Preferences, found in the Configuration menu, controls
  31. the window layout and the different options of the graphical
  32. interface of Sylpheed. Depending on some compile time switches
  33. (and on the availability of some extra libraries), some tabs
  34. may be included (or not) in your version of Sylpheed. These tabs
  35. are not listed here but are described (or will be described) in
  36. the sections covering the optional features they control (like the
  37. <I>Privacy</I> tab for the GnuPG interface).</P>
  38. <H3>Receive tab</H3>
  39. <P>In here you can set up how to receive messages.</P>
  40. <P>
  41. <UL>
  42. <LI>You can define a special program to pick up messages from
  43. the default unix mailbox. Usually this is not used, but
  44. you can use it. Actually, this information may be wrong.
  45. If someone knows better, please let me know.</LI>
  46. <LI><I>Local spool</I> lets you define where your local mailbox is
  47. located. You can also tell Sylpheed whether or not to
  48. filter the incoming messages from that mail spool file.
  49. The spool directory defined here is used by all the accounts
  50. of the <I>local</I> type, by default it is set to the
  51. standard UNIX mailbox location.</LI>
  52. <LI><I>Autocheck new mail</I>. When you check this option, Sylpheed
  53. will check if there is new mail on the set interval.</LI>
  54. <LI><I>Check new mail on startup</I> means that Sylpheed will
  55. immediately look for new mail on all the selected accounts
  56. when it loads.</LI>
  57. <LI><I>Update all local folders after incorporation</I>
  58. Well, if you know the use of this option, feel free to
  59. write this part...</LI>
  60. <LI>In the news section you can specify how many articles
  61. should be downloaded when opening a newsgroup.</LI>
  62. </UL>
  63. </P>
  64. <H3>Send tab</H3>
  65. <P>In here you can set up how to send messages.</P>
  66. <P>
  67. <UL>
  68. <LI>You can choose to use an external program (like sendmail) for
  69. sending mail. By default no external program is necessary
  70. and Sylpheed can directly send the outgoing messages to a
  71. SMTP server.</LI>
  72. <LI>The sent messages can be saved in the outbox (<I>Sent</I>
  73. folder), the name of the outbox folder can be specified
  74. for each account (see the account setting section).</LI>
  75. <LI>The outgoing codeset selection can be changed to force
  76. the definition of the character set used in sent mails.
  77. The default and recommended value is <I>automatic</I>,
  78. so Sylpheed determines the codeset when sending each
  79. message.</LI>
  80. </UL>
  81. </P>
  82. <H3>Compose tab</H3>
  83. <P>Controls the composition window's behaviour..</P>
  84. <P>
  85. <UL>
  86. <LI>You can change the signature separator and choose to insert
  87. it automatically (unless your signature file already contains
  88. this separator). Leave it as it is by default (unless you really
  89. need to change it, and are ready to face a religion war), a lot
  90. of mail clients rely on this separator to cut the signature when
  91. quoting mails, and this one is accepted as the standard one.</LI>
  92. <LI>If you hate the editor that comes with Sylpheed, you can choose
  93. to automatically start an editor of your choice when composing
  94. new messages (the editor can be defined in the <I>Other</I> tab).</LI>
  95. <LI>The <I>wrap</I> settings defines how Sylpheed will wrap long
  96. lines. You can choose to wrap quoted messages, wrap as you type,
  97. or wrap when sending. You can also change the maximum line length.</LI>
  98. <LI>The <I>reply</I> settings let you control the way you will reply
  99. to mails. If <I>Automatically select account(...)</I> is set,
  100. the account used when replying to a message is automatically
  101. selected based on the folder the original message is in (as you
  102. where already told, accounts can be attached to folders).
  103. If <I>Quote message when replying</I> is selected, when hiting
  104. the <I>Reply</I> button, the composition window pops up and is
  105. filled with either the complete message you are replying to (if
  106. nothing is selected in the body of this message) or the selected
  107. part of its body. When this option is not selected, the composition
  108. window is always empty, and you must cut-and-paste the parts of
  109. the original message you want to quote manually.</LI>
  110. </UL>
  111. </P>
  112. <H3>Quote tab</H3>
  113. <P>In here you can control the quotation of your replies and forwarded
  114. messages.</P>
  115. <P>
  116. <UL>
  117. <LI>You can individually define the quotation mark that appears
  118. at the beginning of each quoted line when replying and forwarding
  119. a message.</LI>
  120. <LI>You can also define the text that appears before and after the
  121. quotation. The format of the quotation contains placeholders for
  122. parts of the original message that are explains in the window
  123. that appears when hiting the <I>Description of symbols</I>
  124. button.</LI>
  125. </UL>
  126. </P>
  127. <H3>Display tab</H3>
  128. <P>In here you can control the display options of Sylpheed.</P>
  129. <P>
  130. <UL>
  131. <LI>You can change the font used to display the messages. Pressing
  132. the button next to the font name field will open the font selection
  133. window, then you can select among all the available fonts.</LI>
  134. <LI>Turning on the translation of the header fields will change the
  135. content of the header summary (between the summary and the message
  136. pane), and use the localized header fields name based on the
  137. selected language (selected by the 'LANG' environment variable).
  138. This setting will only take effect the next time you will start
  139. Sylpheed.</LI>
  140. <LI>Selecting <I>Display unread next to folder name</I> will add
  141. the number of unread messages next to the folder name in the
  142. folder pane (so you can minimize the width of the folder pane
  143. and hide the unread column).</LI>
  144. <LI>You can also control the content of the summary pane. If you choose
  145. to display the recipient name for the mail you send, in the <I>From</I>
  146. column, for any mail you have sent, the name of the recipient will
  147. appear preceded by an arrow (the characters sequence: -->).
  148. The <I>Expand threads</I> controls the initial state of the message
  149. threads when opening a folder (expanded of collapsed).
  150. The <I>Set display item of summary</I> button opens a selection
  151. window that contains all the available items to display in the
  152. left column, the currently selected items in the right column.
  153. Items can be added or removed using the two arrows that appears
  154. between the columns. Using the <I>up</I> and <I>down</I> buttons
  155. on the right side of the window, you can change the display order
  156. of the selected item in the summary window (from left to right).</LI>
  157. </UL>
  158. </P>
  159. <H3>Message tab</H3>
  160. <P>The message tab controls the message window options.</P>
  161. <P>
  162. <UL>
  163. <LI>The message text can use colours to highlight the different levels
  164. of quotation and URIs. The colours can be changed by using the
  165. colours selection dialog that pops up when pressing the <I>Edit</I>
  166. button next to the <I>Enable coloration of messages</I> toggle.</LI>
  167. <LI>The dispaly of the header summary between the summary and message
  168. panes can also be turned on and off (<I>Display header pane above message
  169. view</I> dialog).</LI>
  170. <LI><I>Display short header on message view</I> and the <I>Edit</I>
  171. button next to it, control the inclusion of some header fields
  172. in the message view. If the message coloration has been turned on,
  173. the addresses that appear in the header part of the message view
  174. are highlighted as URIs.</LI>
  175. <LI>The <I>Line space</I> setting controls the lines spacing of the
  176. message view.</LI>
  177. <LI><I>Leave space on head</I>. Checking this box will make the
  178. start of new lines (unwrapped, where the writer has pressed
  179. the Enter/Return key) indent a few pixels. This can be useful
  180. to read larger e-mails.</LI>
  181. <LI><I>Scroll half page</I>. When enabled, the text in the message
  182. view will only scroll half a page instead of a whole page when
  183. pressing the space bar.</LI>
  184. <LI><I>Smooth scroll</I>. Enabling this box will make the text
  185. in the message view scroll in a smooth, sliding way. For the
  186. eye this can be pleasing, it is a personal preference.</LI>
  187. <LI>Select the <I>Resize attached image</I> if you wnat all the
  188. images (attachment) to be resized to fit in the message window.</LI>
  189. </UL>
  190. </P>
  191. <H3>Interface tab</H3>
  192. <P>The interface tab controls the Sylpheed's Graphical User Interface
  193. behaviour.</P>
  194. <P>
  195. <UL>
  196. <LI>The <I>Open message when cursor keys are pressed</I> toggles controls
  197. the opening of the messages while you go through them in the summary
  198. pane using the cursor (up and down arrows) keys. If this toggle is on,
  199. each time you press the <I>down</I> (or <I>up</I>) key in the the
  200. summary window, the current message changes and the content of the
  201. message view changes to the content of the newly selected message.
  202. Otherwise, the content of the message view does not change unless you
  203. press enter (then the message view contains the content of the selected
  204. message).
  205. This does not change the behaviour of the left mouse button (always selects
  206. and open the pointed message).</LI>
  207. <LI><I>Open first unread message when entering a folder</I> if selected,
  208. when opening a folder, the message view will contain the first unread
  209. message of this folder (or the latest message in the order the folder
  210. uses for sorting messages). If not selected, the message view remains
  211. empty until a message is selected (by changing the current message with
  212. the cursor keys or with the left mouse button).</LI>
  213. <LI><I>Only marks message read when open in new window</I> leaves the
  214. selected message unread (but display it in the message view) until you
  215. open it in a new window (double click the left mouse button).</LI>
  216. <LI>If <I>Execute immediately when moving or deleting messages</I> is not
  217. selected, a new button appears in the button bar marked <I>Execute</I>.
  218. When deleting or moving messages, they are first marked as deleted or
  219. moved but Sylpheed does not move or delete them until you press the
  220. <I>Execute</I> button (or the <I>Execute</I> entry of the
  221. <I>Tools</I> menu).</LI>
  222. <LI>The <I>Receive dialog</I> settings controls the dialog that pops
  223. up (if you have set <I>Show receive dialog</I> to <I>always</I>)
  224. when receiving new mails.
  225. The default is to open a pop up window upon reception error unless
  226. you select the <I>Dont't pop up error dialog (...)</I> toggle.</LI>
  227. <LI><I>The Set key bindings</I> button when pressed, opens a selection
  228. window that contains a list of pre-defined key bindings (<I>Mew</I>,
  229. <I>Mutt</I>, <I>Old Sylpheed</I>) to change all the key bindings
  230. at once. The key bindings can also be changed one by one as described in</LI>
  231. </UL>
  232. </P>
  233. <H3>Other tab</H3>
  234. <P>The other tab contains the settings that does not fit the
  235. previous categories.</P>
  236. <P>
  237. <UL>
  238. <LI><I>Web browser</I>. Here you can enter the name of your favorite
  239. web browser (Netscape, Opera, Mozilla, Lynx etc.). Add the %s parameter
  240. to the command so Sylpheed knows it has to provide the text you clicked
  241. on as the URL that the browser has to visit.
  242. The arrow next to the text field can be used to display a scrolling
  243. list of predefined URL browsing command lines.</LI>
  244. <LI><I>Printing</I>. Here you can define the program that should be used
  245. to print. Default is lpr, and the %s is the name of the temporary file
  246. that Sylpheed creates for lpr to print.
  247. When using the <I>File->Print</I> menu entry to print the selected
  248. message, a text window pops up to allow you to change the command
  249. used to print.</LI>
  250. <LI><I>External editor</I>. You can select an external editor to write
  251. your e-mails with, for example vi, emacs or gedit. Note that for
  252. text-based editors like vi, you need to define a terminal window,
  253. e.g. <CODE>xterm -e vi %s</CODE>. Otherwise there is no place that the
  254. editor will be able to show up. Here too, the %s parameter is the
  255. name of a temporary file that is created by Sylpheed.</LI>
  256. <LI><I>Add address to destination (...)</I> when selected,
  257. double clicking an e-mail address (in the address book,
  258. when the composition window is opened) can be used to add
  259. this address to the <I>To:</I> field.</LI>
  260. <LI>Confirming if you want to exit Sylpheed (or just exit quietly).</LI>
  261. <LI>Cleaning the trashbox when exiting Sylpheed.</LI>
  262. <LI>Have Sylpheed ask you to clean the trash before it is done.</LI>
  263. <LI>Warn you when exiting Sylpheed when there are still messages
  264. queued to be sent.</LI>
  265. </UL>
  266. </P>
  267. <H2><A NAME="ss8.2">8.2</A> <A HREF="sylpheed.html#toc8.2">Setting up an account/changing an account</A>
  268. </H2>
  269. <P>In order to set up an account in Sylpheed, in the <I>Configuration</I>
  270. menu you select <I>Create new account</I>. If you want to change the
  271. settings of an existing account and this account is the current
  272. one, in the <I>Configuration</I> menu select <I>Preferences for
  273. current account</I>, otherwise select <I>Edit accounts...</I>.
  274. There you select the account you want to change. After that you press
  275. <I>edit</I>. Then a dialog appears in which you can enter or update
  276. the following areas:</P>
  277. <H3><A NAME="Basic"></A> Basic tab</H3>
  278. <P>In the "Basic" tab you name the account. This is to make identifying
  279. the account easier. The name is then used in the <I>Change current account</I>
  280. part of the <I>Configuration</I> menu, or in menu found in the lower
  281. right corner of the main window (used to quickly switch to another account).</P>
  282. <P>Choose a name that tells something about the account, like the
  283. name of the ISP, mailbox or news-server you are setting up.
  284. You can select this account to be the default account ("Usually used").
  285. The default account can also be defined from the <I>Edit accounts</I>
  286. window (toggle the <I>D</I> column next to the account name).</P>
  287. <P>Enter your name and e-mail address, and if you have one, the
  288. organization that you use Sylpheed for.
  289. In the Protocol box you select the type of service that this
  290. account will be using. The flavors you can choose are: <I>POP3 normal</I>,
  291. <I>POP3 APOP auth</I>, <I>IMAP4</I>, <I>NNTP news</I> or <I>None (local)</I>.</P>
  292. <P>For POP3 and IMAP services you can then specify the server where
  293. your mail is stored. Details about this name, and also the name
  294. that goes into the field for <I>SMTP server (send)</I> should be given
  295. to you by your ISP.</P>
  296. <P>For a local unix mailbox, the <I>Server for receiving</I> is disabled,
  297. since the mail will be received for you.</P>
  298. <P>The fields for <I>User ID</I> and <I>Password</I> will also be
  299. disabled for accounts that do no deal with POP3 or IMAP services.
  300. Otherwise you can enter the login name and password for the e-mail
  301. server with your ISP here. Usually these are the same as your login
  302. name and password to access the dial-in service, but this is
  303. not standard. If in doubt, contact the helpdesk of your ISP.</P>
  304. <H3>Passwords:</H3>
  305. <P>The password is not printed in the entry field (replaced by stars) but
  306. is stored in plaintext in the Sylpheed configuration files. The Sylpheed
  307. configuration directory (&nbsp;/.sylpheed) is only readable by 'owner', and
  308. not by 'group' and 'other', do not change these access rights.</P>
  309. <H3><A NAME="Receive"></A> Receive tab</H3>
  310. <P>The <I>Receive</I> tab is only used for POP3 accounts. Here you
  311. specify if the mails that were successfully retrieved should be removed
  312. from the server. You can also tell Sylpheed to get all the
  313. messages there, not only the ones you already received (in case
  314. you leave your messages on the server).
  315. You can choose to leave the messages on the server during a selectable
  316. number of days (then remove them).</P>
  317. <P>You can also define a limit for the size of the messages to
  318. download. Any message bigger than this limit will not be
  319. downloaded.</P>
  320. <P>You can also choose to filter messages on receiving, if not
  321. set, the messages are only filtered when you use the filter
  322. entry of the Tools menu.</P>
  323. <P>The default inbox defines the folder that receives the incoming
  324. (and not filtered) messages for this account.
  325. You can define a different folder as inbox for each of your
  326. accounts.</P>
  327. <P>If the <I>Get all checks for messages on this account</I> is turned
  328. off, when using the <I>Get all</I> menu entry (or toolbar button)
  329. this account will not be checked. To check for new mails for
  330. this account, you must select the account, then use the <I>Get</I>
  331. toolbar button (or menu entry).</P>
  332. <H3><A NAME="Send"></A> Send tab</H3>
  333. <P>In the <I>Send</I> tab you can define the settings that apply
  334. to sending mails.</P>
  335. <P>You can choose to add the date field to the messages you send,
  336. generate a unique message identifier, or add custom header
  337. fields.</P>
  338. <H3>X-face pictures:</H3>
  339. <P>The user defined header field should be set up to contain your
  340. X-face picture.
  341. Thanks to Jeff Dairiki, you can have a complete online course in this.
  342. Visit
  343. <A HREF="http://www.dairiki.org/xface/">this page</A> for the details.</P>
  344. <P>If your SMTP server needs authentication, define the user ID and
  345. password to use in this tab. You can also choose to first authenticate with
  346. POP3 before sending.</P>
  347. <H3><A NAME="Compose"></A> Compose tab</H3>
  348. <P>In the <I>Compose</I> tab you can define your signature file,
  349. choose to always copy someone when sending mails (you can
  350. choose to always copy your boss, or yourself), and define the
  351. Reply-To field for the current account.</P>
  352. <H3><A NAME="Privacy"></A> Privacy tab</H3>
  353. <P>This tab is only available when Sylpheed has been compiled
  354. with GPGME and GNUPG (for signature and encryption).</P>
  355. <P>With this tab you can choose the keys to use when signing
  356. or encrypting mails for this account.</P>
  357. <H3><A NAME="Advanced"></A> Advanced tab</H3>
  358. <P>The Advanced tab contains some settings you normally do
  359. not need to change (unless you really know what you are
  360. doing).</P>
  361. <P>You can change the default SMTP or POP3 ports used when
  362. connecting to your mail server, define a domain name to
  363. use when sending a mail. Some ISP (or mail relays) reject
  364. mails without a valid domain name.</P>
  365. <P>The default folders for the sent messages, drafts and
  366. trash can be defined here. If not changed the current account
  367. will use the default folders.</P>
  368. <H3>Attaching accounts to folders</H3>
  369. <P>Pressing the right mouse button over a folder (in the folder pane),
  370. and selecting the <I>Properties</I> entry will open the folder properties
  371. form. In this form, in the <I>General</I> tab you can see (but not modify)
  372. the folder name and the corresponding directory path (relative to the mail
  373. directory). In the <I>Compose</I> tab:</P>
  374. <P>you can select the account, choose to apply this setting also to
  375. the sub-folders.
  376. You can also force the address used when sending mail (to force a mailing
  377. list address, for example), choose to send a copy of the sent mails
  378. to a list of addresses different from the default one defined for the
  379. selected account.</P>
  380. <H3>Using accounts in the real life</H3>
  381. <P>Accounts can, of course be used to retrieve mails from different ISPs,
  382. separate your personal and professional messages, but also to make your
  383. life easier.
  384. You can define different accounts just to change your address (as sender),
  385. your signature, change the sent folder, etc...
  386. Here is a summary of the account specific settings, feel free to
  387. find your own use for them:</P>
  388. <P>
  389. <UL>
  390. <LI>Sender name, address and organization. Signature, extra header
  391. fields.</LI>
  392. <LI>Leave or remove message from server (usefull for debug).</LI>
  393. <LI>Incoming mails filtering and size limit.</LI>
  394. <LI>Default field (<I>Reply-To</I>:, <I>Cc:</I>, <I>Bcc:</I>).</LI>
  395. <LI><I>Draft</I>, <I>Trash</I> and <I>Sent</I> folders.</LI>
  396. </UL>
  397. </P>
  398. <P>By attaching accounts to folders, you can control all these settings
  399. on a folder basis, but you can also change the <I>To:</I>, <I>Cc:</I>,
  400. <I>Bcc:</I>, and <I>Reply-To:</I> for each folder (overrides the account
  401. settings).</P>
  402. <HR>
  403. <A HREF="sylpheed-9.html">Next</A>
  404. <A HREF="sylpheed-7.html">Previous</A>
  405. <A HREF="sylpheed.html#toc8">Contents</A>
  406. </BODY>
  407. </HTML>