[tor-commits] [manual/translations] update content

[emmapeel at torproject.org]

commit 2ab2ef9ed1721ba97de8a5aa4fd6f54b646360fc
Author: emma peel <emma.peel at riseup.net>
Date:   Fri Sep 17 13:13:15 2021 +0200

    update content
---
 content/downloading/contents.lr  |  3 +--
 content/installation/contents.lr | 51 +++++++++++++++++++++++++++++++---------
 2 files changed, 41 insertions(+), 13 deletions(-)

diff --git a/content/downloading/contents.lr b/content/downloading/contents.lr
index a652578..5e1bd4b 100644
--- a/content/downloading/contents.lr
+++ b/content/downloading/contents.lr
@@ -30,5 +30,4 @@ Send an email to [gettor at torproject.org](mailto:gettor at torproject.org), and in t
 You can also add a language code to get Tor Browser on a language different than English.
 For example, to get links for downloading Tor Browser in Chinese (China) for Windows, send an email to [gettor at torproject.org](mailto:gettor at torproject.org) with the words "windows zh_CN" in it.
 
-GetTor will respond with an email containing links from which you can download the Tor Browser package, the cryptographic signature (needed for verifying the download), the fingerprint of the key used to make the signature, and the package’s checksum.
-You may be offered a choice of “32-bit” or “64-bit” software: this depends on the model of the computer you are using.
+GetTor will respond with an email containing links from which you can download the Tor Browser package, the cryptographic signature (needed for verifying the download), the fingerprint of the key used to make the signature, and the package’s checksum. You may be offered a choice of “32-bit” or “64-bit” software: this depends on the model of the computer you are using.
diff --git a/content/installation/contents.lr b/content/installation/contents.lr
index d50bde9..18f54bf 100644
--- a/content/installation/contents.lr
+++ b/content/installation/contents.lr
@@ -10,7 +10,7 @@ key: 3
 ---
 body:
 
-For Windows:
+## For Windows
 
 1. Navigate to the Tor Browser [download page](https://www.torproject.org/download).
 
@@ -21,7 +21,7 @@ For Windows:
 4. When the download is complete, double click the `.exe` file. Complete the installation wizard process.
 
 
-For macOS:
+## For macOS
 
 1. Navigate to the Tor Browser [download page](https://www.torproject.org/download).
 
@@ -32,7 +32,7 @@ For macOS:
 4. When the download is complete, double click the `.dmg` file. Complete the installation wizard process.
 
 
-For GNU/Linux:
+## For GNU/Linux
 
 1. Navigate to the Tor Browser [download page](https://www.torproject.org/download).
 
@@ -40,19 +40,48 @@ For GNU/Linux:
 
 3. (Recommended) Verify the [file's signature](https://support.torproject.org/en/tbb/how-to-verify-signature/).
 
-4. When the download is complete, extract the archive with the command `tar -xf [TB archive]` or by using an archive manager.
+4. Now follow either the graphical or the command-line method: 
 
-5. You'll need to tell your GNU/Linux that you want the ability to execute shell scripts from the graphical interface or the command line.
-   Navigate to the newly extracted Tor Browser directory.
-   Right click on `start-tor-browser.desktop`, open Properties or Preferences and change the permission to allow executing file as program.
+#### Graphical method
+
+* When the download is complete, extract the archive using an archive manager.
+
+* You'll need to tell your GNU/Linux that you want the ability to execute shell scripts.
+Navigate to the newly extracted Tor Browser directory.
+Right click on `start-tor-browser.desktop`, open Properties or Preferences and change the permission to allow executing file as program.
    Double-click the icon to start up Tor Browser for the first time.
 
-   **Note:** On Ubuntu and some other distros if you try to launch the start-tor-browser.desktop file a text file might open up.
-To change this behavior and launch Tor Browser instead, follow this: Open "Files" (GNOME Files/Nautilus) → open Preferences → go to the 'Behavior' Tab → Select "Run them" or "Ask what to do" under "Executable Text Files".
-If you choose the latter click on "Run" after launching the start-tor-browser.desktop file.
+<img style="max-width:50%" class="col-md-6"  src="../../static/images/linux-make-desktop-file-executable.png" alt="Make the .desktop file executable in Linux">
+
+   **Note:** On Ubuntu and some other distros if you try to launch `start-tor-browser.desktop` a text file might open up.
+To change this behavior and launch Tor Browser instead, follow this:
+* Launch "Files" (GNOME Files/Nautilus)
+* Click on Preferences.
+* Navigate to the 'Behavior' Tab.
+* Select "Run them" or "Ask what to do" under "Executable Text Files".
+* If you choose the latter click on "Run" after launching the `start-tor-browser.desktop` file.
+
+<img style="max-width:50%" class="col-md-6"  src="../../static/images/linux-change-behavior-executable-files.png" alt="Change behavior of executable text file to always run in Linux">
+
+#### Command-line method
 
-6. Alternatively, from inside the Tor Browser directory, you can also start from the command line by running:
+* When the download is complete, extract the archive with the command `tar -xf [TB archive]`.
+
+* From inside the Tor Browser directory, you can launch Tor Browser by running:
 
    `./start-tor-browser.desktop`
 
+   **Note:** If this command fails to run, you probably need to make the file executable. From within this directory run: `chmod +x start-tor-browser.desktop`
+
+* Some additional flags that can be used with `start-tor-browser.desktop` from the command-line:
+
+| **Flag** | **Description** |
+|----------|-----------------|
+| `--register-app` | To register Tor Browser as a desktop application. |
+| `--verbose` | To display Tor and Firefox output in the terminal. |
+| `--log [file]` | To record Tor and Firefox output in file (default: tor-browser.log). |
+| `--detach` | To detach from terminal and run Tor Browser in the background. |
+| `--unregister-app` | To unregister Tor Browser as a desktop application. |
+
+
 See here on how to [update Tor Browser](https://tb-manual.torproject.org/updating/).