Commit dbbfc9da authored by sajolida's avatar sajolida
Browse files

Add DocBook classes

parent b1adfc99
......@@ -42,7 +42,7 @@ sensitive information or leave no trace.</p>
<span class="guimenu">Applications</span>&nbsp;▸
<span class="guisubmenu">Tails</span>&nbsp;▸
<span class="guimenuitem">Configure persistent volume</span></span> to
start the *Persistence Assistant*. The assistant proposes to create
start the <span class="application">Persistence Assistant</span>. The assistant proposes to create
an encrypted persistent volume on the USB stick.
1. Specify a passphrase of your choice in both the
......@@ -72,9 +72,10 @@ Passphrase</span> text boxes. Click on the <span class="guilabel">Create</span>
feature corresponds to a set of files or settings to be saved in the encrypted
persistent storage.
For the time being, we recommend you to only activate the **Personal
Data** persistence feature. You can modify the configuration of the
encrypted persistent storage later on according to your needs.
For the time being, we recommend you to only activate the
<span class="guilabel">Personal Data</span> persistence feature. You
can modify the configuration of the encrypted persistent storage
later on according to your needs.
<div class="caution">
<p>As a general rule, only activate the persistence features that you
......@@ -86,7 +87,7 @@ Passphrase</span> text boxes. Click on the <span class="guilabel">Create</span>
storage|doc/first_steps/persistence/configure]] to learn more about
the other persistence features.
5. Click **Save**.
5. Click <span class="button">Save</span>.
<div class="step-image">[[!img inc/infography/restart-on-tails.png link="no"]]</div>
......@@ -95,7 +96,7 @@ Passphrase</span> text boxes. Click on the <span class="guilabel">Create</span>
<span class="clone">new</span>
Tails USB stick.
1. In *Tails Greeter*:
1. In <span class="application">Tails Greeter</span>:
- Select your preferred language in the drop-down list on the bottom left of the screen.
- In the <span class="guilabel">Use persistence?</span> section, choose <span class="guilabel">Yes</span> to
......@@ -105,7 +106,7 @@ enable the encrypted persistent storage for the current working session.
- If you select the <span class="guilabel">Read-Only</span> check box, the
content of encrypted persistent storage is available and you can modify
it but the changes are not saved.
- Click **Login**.
- Click <span class="button">Login</span>.
<div class="caution">
<p>Use the encrypted persistent storage only when necessary. You can
......@@ -116,7 +117,8 @@ it but the changes are not saved.
1. After 15&ndash;30 seconds, the Tails desktop appears.
1. You can now save your personal files and working documents in the
**Persistent** folder. To open the **Persistent** folder choose
<span class="guilabel">Persistent</span> folder. To open the
<span class="guilabel">Persistent</span> folder choose
<span class="menuchoice">
<span class="guimenu">Places</span>&nbsp;▸
<span class="guimenuitem">Persistent</span></span>.
......
Tails does not start at all (troubleshooting)
---------------------------------------------
The following section applies if the **Boot Tails** menu does not
appear when starting on a USB stick.
The following section applies if the <span class="guilabel">Boot Tails</span>
menu does not appear when starting on a USB stick.
It is quite common for computers not to start automatically on a
USB stick with Tails installed. Here are two troubleshooting techniques. You should try them
......@@ -44,7 +44,8 @@
Immediately press several times the first potential boot menu key identified in step 1.
- If a boot menu with a list of possible devices to start from
appears, select the first USB stick in the list and press **Enter**.
appears, select the first USB stick in the list and press
<span class="keycap">Enter</span>.
- If the computer starts on
<span class="windows">Windows,</span>
......
Tails does not start entirely (troubleshooting)
-----------------------------------------------
The following section applies if the **Boot Tails** menu appears but not
*Tails Greeter* when starting Tails.
The following section applies if the <span class="guilabel">Boot Tails</span> menu appears but not
<span class="application">Tails Greeter</span> when starting Tails.
1. Restart the computer on the first USB stick.
1. In the **Boot Tails** menu, choose the <span class="guilabel">failsafe</span>
1. In the <span class="guilabel">Boot Tails</span> menu, choose the <span class="guilabel">failsafe</span>
mode which might work better on some computers.
1. If the <span class="guilabel">failsafe</span> mode does not work
better, restart the computer again on the first USB stick.
1. In the **Boot Tails** menu, press `TAB`. A command line with a list
1. In the <span class="guilabel">Boot Tails</span> menu, press
<span class="keycap">TAB</span>. A command line with a list
of boot options appears at the bottom of the screen.
[[!img doc/first_steps/startup_options/boot-menu-with-options.png class="screenshot" link=no]]
1. Press the <span class="keycap">Backspace</span> key several times to
remove the `quiet` option from the command line.
remove the <span class="code">quiet</span> option from the command line.
1. Type `debug nosplash` to add these options to the command line.
1. To start Tails, press **Enter**.
1. To start Tails, press <span class="keycap">Enter</span>.
1. Hopefully, error messages now appear when starting Tails. You can
[[send them to our support team by email|/support/talk]], for example by taking a
picture of the last screen and error messages.
1. If the error message is `/bin/sh: can't access tty; job control
turned off` followed by `(initramfs)`, then try removing the
`live-media=removable` option from the boot command line.
1. If the error message is <span class="code">/bin/sh: can't access tty; job control
turned off</span> followed by <span class="code">(initramfs)</span>, then try removing the
<span class="code">live-media=removable</span> option from the boot command line.
If removing `live-media=removable` allows you to start Tails, please
If removing <span class="code">live-media=removable</span> allows you to start Tails, please
report the problem to our [[support team|support/talk]].
This contributes to improving the [[list
of problematic USB sticks|support/known_issues#problematic-usb-sticks]].
......
......@@ -42,8 +42,8 @@ in a similar way.</p>
[[!inline pages="install/inc/steps/mac_startup_disks.inline" raw="yes"]]
</div>
1. If the computer starts on Tails, the **Boot Tails** menu
appears. Choose **Live** and press **Enter**.
1. If the computer starts on Tails, the <span class="guilabel">Boot Tails</span> menu
appears. Choose <span class="guilabel">Live</span> and press <span class="keycap">Enter</span>.
[[!img doc/first_steps/start_tails/tails_boot_menu.png class="screenshot" link=no alt="Black screen with Tails artwork. 'Boot menu' with two options 'Live' and 'Live (failsafe)'."]]
......@@ -85,7 +85,7 @@ in a similar way.</p>
be impossible to start Tails on your Mac model.</p>
</div>
1. After 30&ndash;60 seconds, another screen called *Tails Greeter* appears.
1. After 30&ndash;60 seconds, another screen called <span class="application">Tails Greeter</span> appears.
[[!img doc/first_steps/startup_options/tails-greeter-welcome-to-tails.png class="screenshot" link=no]]
......@@ -103,7 +103,7 @@ in a similar way.</p>
"""]]
1. In *Tails Greeter*, select your preferred language in the drop-down
1. In <span class="application">Tails Greeter</span>, select your preferred language in the drop-down
list on the bottom left of the screen. Click <span class="button">Login</span>.
1. After 15&ndash;30 seconds, the Tails desktop appears.
......
......@@ -39,11 +39,13 @@ Restart on the <span class="usb">final</span><span class="clone">new</span> Tail
<span class="mac-dvd">[[final recommendations|mac/dvd#recommendations]].</span></p>
</div>
1. In the **Boot Tails** menu, choose **Live** and press **Enter**.
1. In the <span class="guilabel">Boot Tails</span> menu, choose
<span class="guilabel">Live</span> and press <span class="keycap">Enter</span>.
1. After 30&ndash;60 seconds, *Tails Greeter* appears.
1. After 30&ndash;60 seconds, <span class="application">Tails Greeter</span> appears.
1. In *Tails Greeter*, select your preferred language in the drop-down
list on the bottom left of the screen. Click **Login**.
1. In <span class="application">Tails Greeter</span>, select your
preferred language in the drop-down list on the bottom left of the screen.
Click <span class="button">Login</span>.
1. After 15&ndash;30 seconds, the Tails desktop appears.
......@@ -14,7 +14,7 @@ issues, make sure that the Tails you are <span class="install-clone mac-clone">i
which is the latest version.
1. If you are not running the latest version, connect to the Internet
and wait until Tor is ready. After a minute or two, *Tails Upgrader*
and wait until Tor is ready. After a minute or two, <span class="application">Tails Upgrader</span>
appears with instructions on how to upgrade.
Apply all upgrades as requested.
......
......@@ -13,15 +13,15 @@
[[!inline pages="install/inc/steps/install_temporary_intro.inline" raw="yes"]]
1. Install *GNOME Disks*.
1. Install <span class="application">GNOME Disks</span>.
- If you are using the GNOME desktop environment, *GNOME Disks* should be
- If you are using the GNOME desktop environment, <span class="application">GNOME Disks</span> should be
installed by default.
- Otherwise, install the `gnome-disk-utility` package using the
- Otherwise, install the <span class="code">gnome-disk-utility</span> package using the
usual installation method for your Linux distribution.
1. Start *GNOME Disks*.
1. Start <span class="application">GNOME Disks</span>.
<div class="step-image">[[!img inc/infography/plug-first-usb.png link="no"]]</div>
......@@ -34,14 +34,14 @@
<div class="step-image">[[!img inc/infography/install-temporary-tails.png link="no"]]</div>
1. Click on the [[!img lib/emblem-system.png alt="System" class="symbolic" link="no"]]
button and choose **Restore Disk Image&hellip;**.
button and choose <span class="guimenuitem">Restore Disk Image&hellip;</span>.
1. In the **Restore Disk Image** dialog, click on the file selector button and
1. In the <span class="guilabel">Restore Disk Image</span> dialog, click on the file selector button and
choose the ISO image that you downloaded earlier.
1. Click on the **Start Restoring&hellip;** button.
1. Click on the <span class="button">Start Restoring&hellip;</span> button.
1. In the confirmation dialog click **Restore**.
1. In the confirmation dialog click <span class="button">Restore</span>.
The installation takes a few minutes.
1. After the installation is finished, click on the
......
......@@ -59,7 +59,7 @@
1: Apple_HFS Untitled 1 4.0 GB disk1s1
1. Take note of the *device name* of your USB stick.
In this example, the USB stick is 4.0 GB and its device name is `/dev/disk1`.
In this example, the USB stick is 4.0 GB and its device name is <span class="code">/dev/disk1</span>.
Yours might be different.
<div class="caution">
......@@ -67,7 +67,7 @@
<strong>you risk overwriting any hard disk on the system</strong>.</p>
</div>
1. Execute the following command to safely remove the USB stick. Replace `[device]`
1. Execute the following command to safely remove the USB stick. Replace <span class="code">[device]</span>
with the device name found in step 5.
diskutil unmountDisk [device]
......@@ -77,7 +77,7 @@
1. Execute the following command to copy the ISO image that you
downloaded earlier to the USB stick. Replace:
- `[tails.iso]` with the path to the ISO image
- <span class="code">[tails.iso]</span> with the path to the ISO image
<div class="tip">
<p>If you are unsure about the path to the ISO image, you can insert the
......@@ -86,10 +86,10 @@ downloaded earlier to the USB stick. Replace:
Terminal</span>.</p>
</div>
- `[device]` with the device name found in step 5
- <span class="code">[device]</span> with the device name found in step 5
<div class="tip">
<p>You can try to add `r` before `disk` to make the installation faster.</p>
<p>You can try to add <span class="code">r</span> before <span class="code">disk</span> to make the installation faster.</p>
</div>
<pre>dd if=[tails.iso] of=[device] bs=16m && sync</pre>
......
......@@ -24,16 +24,16 @@
1. At the Windows security warning, confirm that you want to
run the program.
1. Read the licence agreement and click **I Agree** to continue and
start <span class="application">Universal USB Installer</span>.
1. Read the licence agreement and click <span class="button">I Agree</span>
to continue and start <span class="application">Universal USB Installer</span>.
1. Select **Tails** from the drop-down list.
1. Select <span class="guilabel">Tails</span> from the drop-down list.
[[!img inc/screenshots/uui.png class="screenshot" link=no alt="screenshot of Universal USB Installer"]]
<div class="step-image">[[!img inc/infography/install-temporary-tails.png link="no"]]</div>
1. Click **Browse** and choose the ISO image that you downloaded earlier.
1. Click <span class="button">Browse</span> and choose the ISO image that you downloaded earlier.
1. Use the drop-down list to specify the USB stick on which you want to install
the ISO image.
......@@ -44,15 +44,15 @@ the ISO image.
<span class="application">Universal USB Installer</span>.</p>
</div>
1. Select the **Format** option.
1. Select the <span class="guilabel">Format</span> option.
1. Click **Create**.
1. Click <span class="button">Create</span>.
1. A warning appears. Click **Yes** to start the installation.
1. A warning appears. Click <span class="button">Yes</span> to start the installation.
The installation takes a few minutes.
1. After the installation is finished, click **Close** to quit *Universal USB
Installer*.
1. After the installation is finished, click <span class="button">Close</span>
to quit <span class="application">Universal USB Installer</span>.
[[!inline pages="install/inc/steps/install_temporary_outro.inline" raw="yes"]]
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment