update README

- moved hyperlinks to the same section
- removed redundant and incorectly-formated Markdown hyperlink
- added the information of offlineimap 3 Arch Linux AUR package
- removed info of installing imaplib2 from its github repo: imaplib2 now
  has a release on PyPI.
This commit is contained in:
Pi-Yueh Chuang 2021-06-10 18:16:53 -04:00
parent fe443e6bd3
commit 199b8257eb
No known key found for this signature in database
GPG Key ID: 4D88B842DD03DDE4

View File

@ -13,7 +13,9 @@ Upstream status (`next` branch):
[blog]: https://www.offlineimap.org/posts.html [blog]: https://www.offlineimap.org/posts.html
Links: Links:
* Official github code repository: [offlineimap] * Official github code repository
* for Python 2: [offlineimap]
* for Python 3: [offlineimap3]
* Website: [website] * Website: [website]
* Wiki: [wiki] * Wiki: [wiki]
* Blog: [blog] * Blog: [blog]
@ -22,14 +24,13 @@ Links:
***"Get the emails where you need them."*** ***"Get the emails where you need them."***
[Official offlineimap][https://github.com/OfflineIMAP/offlineimap3].
## Description ## Description
OfflineIMAP is software that downloads your email mailbox(es) as **local OfflineIMAP is software that downloads your email mailbox(es) as **local
Maildirs**. OfflineIMAP will synchronize both sides via *IMAP*. Maildirs**. OfflineIMAP will synchronize both sides via *IMAP*.
## Why should I use OfflineIMAP? ## Why should I use OfflineIMAP?
IMAP's main downside is that you have to **trust** your email provider to IMAP's main downside is that you have to **trust** your email provider to
@ -61,11 +62,11 @@ GNU General Public License v2.
You should first check if your distribution already packages OfflineIMAP for you. You should first check if your distribution already packages OfflineIMAP for you.
Downloads releases as [tarball or zipball](https://github.com/OfflineIMAP/offlineimap3/tags). Downloads releases as [tarball or zipball](https://github.com/OfflineIMAP/offlineimap3/tags).
If you are running Linux Os, you can install offlineimap with: If you are running Linux, you can install offlineimap with:
- openSUSE `zypper in offlineimap` - openSUSE `zypper in offlineimap`
- Arch Linux `pacman -S offlineimap`
- fedora `dnf install offlineimap` - fedora `dnf install offlineimap`
- Arch Linux: through AUR package [offlineimap3-git](https://aur.archlinux.org/packages/offlineimap3-git/)
## Feedbacks and contributions ## Feedbacks and contributions
@ -98,9 +99,6 @@ Bugs, issues and contributions can be requested to both the mailing list or the
* Python v3+ * Python v3+
* rfc6555 (required) * rfc6555 (required)
* imaplib2 >= 3.5 * imaplib2 >= 3.5
* If you encounter an error that `cannot import name 'IMAP4' from 'imaplib2'`, it means that you need to install imaplib2 from the git repository.
* First, clone https://github.com/jazzband/imaplib2.git to your local computer.
* Then, enter the directory of the repository, run `pip install .` or `pip install --user .`.
* gssapi (optional), for Kerberos authentication * gssapi (optional), for Kerberos authentication
* portalocker (optional), if you need to run offlineimap in Cygwin for Windows * portalocker (optional), if you need to run offlineimap in Cygwin for Windows