Add section on downloading, and TODO file
Harmony commited on 2015-06-25 13:29:51
Zeige 2 geänderte Dateien mit 186 Einfügungen und 0 Löschungen.
- C/downloading.page 0000000..31b5b7f
- TODO 0000000..7b45e95
| ... | ... |
@@ -0,0 +1,131 @@ |
| 1 |
+<page xmlns="http://projectmallard.org/1.0/" |
|
| 2 |
+ type="topic" |
|
| 3 |
+ id="downloading"> |
|
| 4 |
+ |
|
| 5 |
+<info> |
|
| 6 |
+ <desc>How to download Tor Browser</desc> |
|
| 7 |
+ <link type="guide" xref="index" /> |
|
| 8 |
+</info> |
|
| 9 |
+ |
|
| 10 |
+<title>Downloading</title> |
|
| 11 |
+ |
|
| 12 |
+<p> |
|
| 13 |
+The safest and simplest way to download Tor Browser is from the official |
|
| 14 |
+Tor Project website at https://www.torproject.org. Your connection to |
|
| 15 |
+the site will be secured using |
|
| 16 |
+<link xref='secure-connections'>HTTPS</link>, so you can be sure that no |
|
| 17 |
+one is tampering with your copy of the software while you download it. |
|
| 18 |
+</p> |
|
| 19 |
+ |
|
| 20 |
+<p> |
|
| 21 |
+However, there may be times when you cannot access the Tor Project |
|
| 22 |
+website: for example, it could be blocked on your network. If this |
|
| 23 |
+happens, you can use one of the alternative download methods listed |
|
| 24 |
+below. |
|
| 25 |
+</p> |
|
| 26 |
+ |
|
| 27 |
+<section id="satori"> |
|
| 28 |
+<title>Satori</title> |
|
| 29 |
+ <p> |
|
| 30 |
+ Satori is an add-on for the Chrome or Chromium browsers that allows you |
|
| 31 |
+ to download several security and privacy programs from different |
|
| 32 |
+ sources. |
|
| 33 |
+ </p> |
|
| 34 |
+ <p> |
|
| 35 |
+ To download Tor Browser using Satori: |
|
| 36 |
+ </p> |
|
| 37 |
+ <steps> |
|
| 38 |
+ <item> |
|
| 39 |
+ <p> |
|
| 40 |
+ Install Satori from the Chrome App Store. |
|
| 41 |
+ </p> |
|
| 42 |
+ </item> |
|
| 43 |
+ <item> |
|
| 44 |
+ <p> |
|
| 45 |
+ Select Satori from your browser’s Apps menu. |
|
| 46 |
+ </p> |
|
| 47 |
+ </item> |
|
| 48 |
+ <item> |
|
| 49 |
+ <p> |
|
| 50 |
+ When Satori opens, click on your preferred language. A menu will open |
|
| 51 |
+ listing the available downloads for that language. Find the entry for |
|
| 52 |
+ Tor Browser under the name of your operating system. Select |
|
| 53 |
+ either “A” or “B” after the name of the program — each one represents |
|
| 54 |
+ a different source from which to get the software. Your download will |
|
| 55 |
+ then begin. |
|
| 56 |
+ </p> |
|
| 57 |
+ </item> |
|
| 58 |
+ <item> |
|
| 59 |
+ <p> |
|
| 60 |
+ Wait for your download to finish, then find the “Generate Hash” |
|
| 61 |
+ section in Satori’s menu and click “Select Files”. |
|
| 62 |
+ </p> |
|
| 63 |
+ </item> |
|
| 64 |
+ <item> |
|
| 65 |
+ <p> |
|
| 66 |
+ Select the downloaded Tor Browser file. Satori will display the |
|
| 67 |
+ checksum of the file, which you should compare with the software’s |
|
| 68 |
+ original checksum: you can find this by clicking the word “checksum” |
|
| 69 |
+ after the link you clicked on to start the download. If the checksums |
|
| 70 |
+ match, your download was successful, and you can |
|
| 71 |
+ <link xref='first-time'>begin using Tor Browser</link>. If they do not |
|
| 72 |
+ match, you may need to try downloading again, or from a different |
|
| 73 |
+ source. |
|
| 74 |
+ </p> |
|
| 75 |
+ </item> |
|
| 76 |
+ </steps> |
|
| 77 |
+</section> |
|
| 78 |
+ |
|
| 79 |
+<section id="gettor"> |
|
| 80 |
+<title>GetTor</title> |
|
| 81 |
+ <p> |
|
| 82 |
+ GetTor is an email-based service that automatically responds to |
|
| 83 |
+ messages with links to the latest version of Tor Browser, hosted at a |
|
| 84 |
+ variety of locations, such as Dropbox. |
|
| 85 |
+ </p> |
|
| 86 |
+ |
|
| 87 |
+ <p> |
|
| 88 |
+ To use GetTor: |
|
| 89 |
+ </p> |
|
| 90 |
+ <steps> |
|
| 91 |
+ <item> |
|
| 92 |
+ <p> |
|
| 93 |
+ Send an email to gettor@torproject.org, and in the body |
|
| 94 |
+ of the message simply write “windows”, “osx”, or “linux”, (without |
|
| 95 |
+ quotation marks) depending on your operating system. |
|
| 96 |
+ </p> |
|
| 97 |
+ </item> |
|
| 98 |
+ <item> |
|
| 99 |
+ <p> |
|
| 100 |
+ GetTor will respond with an email containing links from which you can |
|
| 101 |
+ download the Tor Browser package, the cryptographic signature (needed |
|
| 102 |
+ for verifying the download), the fingerprint of the key used to make |
|
| 103 |
+ the signature, and the package’s checksum. You may be offered a choice |
|
| 104 |
+ of “32-bit” or “64-bit” software: this depends on the model of the |
|
| 105 |
+ computer you are using. |
|
| 106 |
+ </p> |
|
| 107 |
+ </item> |
|
| 108 |
+ </steps> |
|
| 109 |
+</section> |
|
| 110 |
+ |
|
| 111 |
+<section id="website-mirror"> |
|
| 112 |
+<title>Tor website mirrors</title> |
|
| 113 |
+ <p> |
|
| 114 |
+ A number of volunteers around the world host “mirrors” of the Tor |
|
| 115 |
+ Project website. These are identical copies of all the content and |
|
| 116 |
+ software on the main website, hosted at different IP addresses and |
|
| 117 |
+ URLs. The Tor Project periodically checks mirrored versions of the |
|
| 118 |
+ software to make sure they are the same as the originals. |
|
| 119 |
+ </p> |
|
| 120 |
+ |
|
| 121 |
+ <p> |
|
| 122 |
+ If the main Tor website is blocked for you, and the automated |
|
| 123 |
+ distribution methods above do not work, send an email to |
|
| 124 |
+ help@rt.torproject.org asking for some website mirror addresses. You |
|
| 125 |
+ should then be able to download Tor Browser as normal from these sites. |
|
| 126 |
+ Please note that you should take extra care to verify the software you |
|
| 127 |
+ download from a mirror, to ensure that it has not been tampered with. |
|
| 128 |
+ </p> |
|
| 129 |
+</section> |
|
| 130 |
+ |
|
| 131 |
+</page> |
| ... | ... |
@@ -0,0 +1,55 @@ |
| 1 |
+========== |
|
| 2 |
+SHORT TERM |
|
| 3 |
+========== |
|
| 4 |
+ |
|
| 5 |
+ADDITIONAL SCREENSHOTS |
|
| 6 |
+ |
|
| 7 |
+Produce screenshots illustrating the download methods in the “How to |
|
| 8 |
+download” section (Satori, GetTor, mirrors). |
|
| 9 |
+ |
|
| 10 |
+SECTIONS TO ADD/EXPAND/MODIFY |
|
| 11 |
+ |
|
| 12 |
+Add a section that explains how to verify the Tor Browser download in |
|
| 13 |
+clear and simple steps. |
|
| 14 |
+ |
|
| 15 |
+Expand “Using for the first time” section with guidance on |
|
| 16 |
+extracting/“installing” Tor Browser, and locating it in the filesystem |
|
| 17 |
+on each OS. Cover the need to move TB to OSX Applications folder (and |
|
| 18 |
+not run from disk image). Take into account the change in Mac OSX |
|
| 19 |
+installation once a developer cert is available (ETA: August 2015) |
|
| 20 |
+ |
|
| 21 |
+Modify “Bridges” page if/when we have a domain-fronted API to |
|
| 22 |
+autodiscover fresh bridges (ETA: December 2015) |
|
| 23 |
+ |
|
| 24 |
+[XXX Add more here XXX] |
|
| 25 |
+ |
|
| 26 |
+=========== |
|
| 27 |
+MEDIUM TERM |
|
| 28 |
+=========== |
|
| 29 |
+ |
|
| 30 |
+LOCALIZATION |
|
| 31 |
+ |
|
| 32 |
+Plan for the localization of the manual’s text into the set of languages |
|
| 33 |
+for which Tor Browser is currently built; this could be done through |
|
| 34 |
+crowdsourced translation (on Transifex) or by individual translators. |
|
| 35 |
+ |
|
| 36 |
+DISTRIBUTION |
|
| 37 |
+ |
|
| 38 |
+Work out distribution strategies for the manual. An online copy will be |
|
| 39 |
+available, and could be promoted through Tor’s outreach channels and |
|
| 40 |
+linked to from the website. GetTor could provide links to the manual |
|
| 41 |
+or to a downloadable file. A file could be included in the Tor Browser |
|
| 42 |
+download (see discussion on #11698). |
|
| 43 |
+ |
|
| 44 |
+MAINTAINABILITY |
|
| 45 |
+ |
|
| 46 |
+Develop a clear plan for updating the manual text as Tor Browser |
|
| 47 |
+evolves. This will involve incorporating user |
|
| 48 |
+feedback/frequently-encountered issues from the help desk assistants, |
|
| 49 |
+and making sure that information about major user interface changes is |
|
| 50 |
+obtained from the Tor Browser team in good time. |
|
| 51 |
+ |
|
| 52 |
+OTHER SOFTWARE PRODUCTS |
|
| 53 |
+ |
|
| 54 |
+Continue discussion with other software development teams who might |
|
| 55 |
+require user documentation for their products (e.g. Tor Messenger) |
|
| 0 | 56 |