Commits (9)
.. include:: defs.txt
.. include:: images.txt
.. _librem_5_contacts:
......
.. include:: defs.txt
.. include:: images.txt
.. _librem_5_initial_setup:
......
.. include:: defs.txt
.. _librem_5_quick_tour:
A Quick Tour
......@@ -15,16 +13,23 @@ The first thing you need to do after switching on your phone is to unlock it.
Unlocking the Screen
--------------------
When you power on your phone it will be locked, displaying the lock screen.
When you power on your phone it will be locked, displaying the lock screen. If the screen has switched off, press the power button briefly to switch it on again.
.. image:: ../images/hardware/librem5-power-button.svg
:width: 480
:align: center
:alt: The location of the power button
The screen should now show the lock screen.
.. image:: images/phosh/phosh-locked-sim-locked.png
.. image:: ../images/phosh/phosh-locked-sim-locked.png
:align: center
:scale: 50%
:alt: The lock screen
The first two icons shows the state of the cellular and wireless networks. If these icons are missing then the switches on the side of the phone have been set to disable the modem and WLAN card.
.. image:: images/phosh/phosh-locked-icons-cropped.png
.. image:: ../images/phosh/phosh-locked-icons-cropped.png
:align: center
:alt: The lock screen icons
......@@ -32,7 +37,7 @@ The third icon shows the state of the battery, providing information about its c
To unlock the screen, swipe up from the bottom of the screen to reveal the passcode entry screen.
.. image:: images/phosh/phosh-locked-passcode-entry.png
.. image:: ../images/phosh/phosh-locked-passcode-entry.png
:align: center
:scale: 50%
:alt: The passcode entry screen
......@@ -46,7 +51,7 @@ App Drawer
The app drawer is used to access the built-in and installed applications on the phone. It is automatically opened when you switch on the phone and unlock it, giving you the option to launch an app straight away.
.. image:: images/phosh/phosh-app-drawer.png
.. image:: ../images/phosh/phosh-app-drawer.png
:align: center
:scale: 50%
:alt: The app drawer is open when you unlock the phone
......@@ -55,7 +60,7 @@ The built-in apps are shown in the top row. Installed apps are shown beneath the
To close the app drawer, press the down arrow under the time at the top of the screen. This will reveal the background wallpaper.
.. image:: images/phosh/phosh-background.png
.. image:: ../images/phosh/phosh-background.png
:align: center
:scale: 50%
:alt: The default background
......@@ -64,7 +69,7 @@ To open the app drawer again, press the up arrow at the bottom of the screen.
When one or more applications are running, thumbnail images of them will appear in the top half of the screen, above the icons in the app drawer.
.. image:: images/phosh/phosh-overview.png
.. image:: ../images/phosh/phosh-overview.png
:align: center
:scale: 50%
:alt: Thumbnails of running apps appear above the icons in the app drawer
......@@ -78,7 +83,7 @@ Status Line
At the top of the screen is a status line showing the current time, battery level and network status.
.. image:: images/phosh/phosh-status-line.png
.. image:: ../images/phosh/phosh-status-line.png
:align: center
:scale: 75%
:alt: The status line at the top of the screen
......@@ -94,7 +99,7 @@ Settings Panel
Tap the status bar at the top of the screen to open the settings panel. This provides access to common settings and notifications.
.. image:: images/phosh/phosh-settings-panel.png
.. image:: ../images/phosh/phosh-settings-panel.png
:align: center
:alt: The settings panel
......@@ -108,26 +113,30 @@ A series of icons provide shortcuts for common tasks:
* The power indicator shows the battery's current charge and charging state. Tapping this opens the **Power** section of the :ref:`settings <librem_5_settings>` application.
* The screen orientation indicator shows the current screen orientation and can be used to switch between **Portrait** and **Landscape** modes.
* The bell indicator is used to enable and disable sound notifications.
* The **Torch** indicator is used to switch the camera flash LED on and off, using it as a flashlight.
* The docking indicator shows whether the phone is **Docked** or **Undocked**. When docked, the phone can display applications on an external monitor.
To close the panel, tap the region above the icons, where the status line is usually located.
At the top-right corner is the power button. Tap this to access menu items that let you power off the phone and lock the screen.
Locking the Screen
------------------
.. image:: images/phosh/phosh-settings-panel-menu.png
At the top-right corner of the settings panel is the power button. Tap this to access menu items that let you lock the screen, restart the phone, and switch off the power.
.. image:: ../images/phosh/phosh-settings-panel-menu.png
:align: center
:alt: The settings panel
You can also lock the screen by briefly pressing the power button on the side of the phone.
To close the panel, tap the region above the icons, where the status line is usually located.
.. _librem_5_quick_tour_notification_area:
Notification Area
-----------------
Certain notifications from applications are presented in the area below the settings panel. These are typically notifications that you may need to be
reminded about.
Certain notifications from applications are presented in the area below the settings panel. These are typically notifications that you may have missed and need to be reminded about.
.. image:: images/phosh/phosh-settings-notifications.png
.. image:: ../images/phosh/phosh-settings-notifications.png
:align: center
:scale: 50%
:alt: The notification area of the settings panel
......@@ -135,6 +144,8 @@ reminded about.
The notifications that appear here will usually be displayed briefly at the top
of the screen before they are placed in the area.
See :ref:`librem_5_notifications` for information about how notifications are delivered from applications and the system.
Virtual Keyboard
----------------
......@@ -142,15 +153,15 @@ When you need to input text into an application, the virtual keyboard will open
The keyboard provides different views that you can switch between: one with the alphabet, another with digits, and a third view with symbols.
.. |keyboard-us-alpha| image:: images/keyboard/keyboard-us-alpha.png
.. |keyboard-us-alpha| image:: ../images/keyboard/keyboard-us-alpha.png
:scale: 50%
:alt: The virtual keyboard with US alphabet layout
.. |keyboard-us-numbers| image:: images/keyboard/keyboard-us-numbers.png
.. |keyboard-us-numbers| image:: ../images/keyboard/keyboard-us-numbers.png
:scale: 50%
:alt: The virtual keyboard with US numbers layout
.. |keyboard-us-symbols| image:: images/keyboard/keyboard-us-symbols.png
.. |keyboard-us-symbols| image:: ../images/keyboard/keyboard-us-symbols.png
:scale: 50%
:alt: The virtual keyboard with US symbols layout
......@@ -174,3 +185,6 @@ Next Steps
The next thing you should do is to change the default passcode. This is described in :ref:`librem_5_settings_password`.
After you have done that, you can set up your phone's connection to the mobile network. This is described in the :ref:`librem_5_mobile_networks` section of this guide.
.. include:: ../defs.txt
.. include:: images.txt
......@@ -5,7 +5,7 @@ Kill Switches
The Librem 5 provides three kill switches that can be used to disable hardware features of the phone.
.. image:: images/hardware/librem5-switches.svg
.. image:: ../images/hardware/librem5-switches.svg
:align: center
:width: 480
:alt: The locations of kill switches on the edge of the phone
......@@ -16,7 +16,7 @@ When a switch is positioned in the “down” position, the corresponding hardwa
* The Modem switch controls power to the M.2 modem card.
* The WLAN/Bluetooth switch controls power to the combined M.2 WiFi/Bluetooth module.
* The Camera switch controls power to the camera and microphone.
* The Camera/Microphone switch controls power to the camera and microphone.
When **all three** switches are in the “down” position, these additional features are disabled:
......
.. _librem_5_notifications:
Notifications
=============
When the phone's system software or applications need to inform you about something, they will send notifications in the form of pop-up messages. You can configure how these will be presented to you, and optionally use sounds and the phone indicator lights to alert you to their presence.
.. contents::
:local:
The sections below should help you manage and customize notifications to meet your needs.
Pop-up Messages
---------------
When an application or system service sends a notification, it will initially appear as a pop-up window at the top of the screen. It will remain there for a few seconds then disappear. If you tap the notification when it appears, you will be taken to the application that sent it.
.. image:: ../images/phosh/phosh-popup-notifications.png
:align: center
:scale: 50%
:alt: A pop-up notification showing that a timer countdown has finished
If you missed the notification then it will be stored until you can respond to it, or until you switch to the application that sent it.
Missed Notifications
--------------------
If you miss a notification it will be displayed below the settings panel when it is opened.
.. image:: ../images/phosh/phosh-settings-notifications.png
:align: center
:scale: 50%
:alt: A missed notification for Clocks displayed below the settings panel
Tap on a missed notification to switch to the application that sent it.
Configuration
-------------
Notifications are configured in the **Settings** application in the :ref:`librem_5_settings_notifications` page.
.. |notifications| image:: ../images/settings/settings-notifications.png
:scale: 50%
:alt: The Notifications page, allowing customization for individual applications
.. |notifications-power| image:: ../images/settings/settings-notifications-power.png
:scale: 50%
:alt: The Power notifications page
.. centered:: |notifications| |notifications-power|
Notifications can be configured to be delivered in a different way for each application. Except for urgent notifications, they can also be disabled for all applications and services.
......@@ -15,7 +15,7 @@ Overview
The status line contains the current time in the center, separating indicators for connectivity on the left from other indicators on the right.
.. image:: images/phosh/phosh-status-line.png
.. image:: ../images/phosh/phosh-status-line.png
:align: center
:scale: 75%
:alt: The status line at the top of the screen
......@@ -44,7 +44,7 @@ Another icon that may appear indicates a disabled connection.
The type of cellular network in use is presented as a simple label alongside the signal strength. Most users will see **2G**, **3G** or **4G**.
.. image:: images/phosh/phosh-status-line-3G.png
.. image:: ../images/phosh/phosh-status-line-3G.png
:align: center
:scale: 75%
:alt: The status line showing a 3G cellular network in use
......@@ -99,4 +99,86 @@ At the right edge of the display, the battery indicator shows the level of charg
Other icons may be shown in the exceptional case where the phone is powered without a battery.
.. include:: defs.txt
.. include:: ../defs.txt
.. Larger icons for inline use in tables
.. Networking
.. |network-txrx| image:: ../images/icons/network-transmit-receive-symbolic.svg
:width: 40
.. |network-offline| image:: ../images/icons/network-offline-symbolic.svg
:width: 40
.. |network-no-route| image:: ../images/icons/network-no-route-symbolic.svg
:width: 40
.. Cellular
.. |cell-dis| image:: ../images/icons/network-cellular-disabled-symbolic.svg
:width: 40
.. |cell-excellent| image:: ../images/icons/network-cellular-signal-excellent-symbolic.svg
:width: 40
.. |cell-good| image:: ../images/icons/network-cellular-signal-good-symbolic.svg
:width: 40
.. |cell-ok| image:: ../images/icons/network-cellular-signal-ok-symbolic.svg
:width: 40
.. |cell-weak| image:: ../images/icons/network-cellular-signal-weak-symbolic.svg
:width: 40
.. |cell-none| image:: ../images/icons/network-cellular-signal-none-symbolic.svg
:width: 40
.. WLAN
.. |wlan-excellent| image:: ../images/icons/network-wireless-signal-excellent-symbolic.svg
:width: 40
.. |wlan-good| image:: ../images/icons/network-wireless-signal-good-symbolic.svg
:width: 40
.. |wlan-ok| image:: ../images/icons/network-wireless-signal-ok-symbolic.svg
:width: 40
.. |wlan-weak| image:: ../images/icons/network-wireless-signal-weak-symbolic.svg
:width: 40
.. |wlan-none| image:: ../images/icons/network-wireless-signal-none-symbolic.svg
:width: 40
.. |wlan-dis| image:: ../images/icons/network-wireless-disabled-symbolic.svg
:width: 40
.. |wlan-offline| image:: ../images/icons/network-wireless-offline-symbolic.svg
:width: 40
.. |wlan-acquire| image:: ../images/icons/network-wireless-acquiring-symbolic.svg
:width: 40
.. |wlan-connect| image:: ../images/icons/network-wireless-connected-symbolic.svg
:width: 40
.. Battery
.. |battery-empty| image:: ../images/icons/battery-empty-symbolic.svg
:width: 40
.. |charging-empty| image:: ../images/icons/battery-empty-charging-symbolic.svg
:width: 40
.. |battery-low| image:: ../images/icons/battery-low-symbolic.svg
:width: 40
.. |charging-low| image:: ../images/icons/battery-low-charging-symbolic.svg
:width: 40
.. |battery-full| image:: ../images/icons/battery-full-symbolic.svg
:width: 40
.. |charging-full| image:: ../images/icons/battery-full-charging-symbolic.svg
:width: 40
.. include:: defs.txt
.. _librem_5_virtual_keyboard:
Virtual Keyboard
......@@ -23,7 +21,7 @@ Layouts
The layout of the virtual keyboard is close to that of conventional physical keyboards, except that it is designed more for text input than as a general input device. As a result, many of the keys found on a physical keyboard, such as *Ctrl*, *Alt* and the cursor keys are not included in the normal layout.
.. image:: images/keyboard/keyboard-us-alpha.png
.. image:: ../images/keyboard/keyboard-us-alpha.png
:align: center
:alt: The virtual keyboard with US alphabet layout
......@@ -40,15 +38,15 @@ Views
The keyboard provides different views that you can switch between: one with the alphabet, another with digits, and a third view with symbols.
.. |keyboard-us-alpha| image:: images/keyboard/keyboard-us-alpha.png
.. |keyboard-us-alpha| image:: ../images/keyboard/keyboard-us-alpha.png
:scale: 50%
:alt: The virtual keyboard with US alphabet layout
.. |keyboard-us-numbers| image:: images/keyboard/keyboard-us-numbers.png
.. |keyboard-us-numbers| image:: ../images/keyboard/keyboard-us-numbers.png
:scale: 50%
:alt: The virtual keyboard with US numbers layout
.. |keyboard-us-symbols| image:: images/keyboard/keyboard-us-symbols.png
.. |keyboard-us-symbols| image:: ../images/keyboard/keyboard-us-symbols.png
:scale: 50%
:alt: The virtual keyboard with US symbols layout
......@@ -67,14 +65,16 @@ Switching Layouts
The keyboard automatically handles switching between layouts for specialized tasks, such as entering phone numbers, but you can also choose between layouts for different languages by pressing the |mode| key.
.. image:: images/keyboard/keyboard-mode-selection.png
.. image:: ../images/keyboard/keyboard-mode-selection.png
:align: center
:alt: Opening the keyboard mode selection menu
This provides access to layouts such as a terminal layout for consoles and terminal emulators, as well as an emoji layout for messaging applications.
.. image:: images/keyboard/keyboard-emoji-layout.png
.. image:: ../images/keyboard/keyboard-emoji-layout.png
:align: center
:alt: The emoji layout for use with messaging applications
The menu also shows which other layouts are available for other languages.
.. include:: images.txt
.. |backspace| image:: ../images/icons/edit-clear-symbolic.svg
:width: 20
.. |close| image:: ../images/icons/window-close-symbolic.svg
:width: 20
.. |enter| image:: ../images/icons/key-enter.svg
:width: 20
.. |keyboard| image:: ../images/icons/input-keyboard-symbolic.svg
:width: 20
.. |mode| image:: ../images/icons/keyboard-mode-symbolic.svg
:width: 20
.. |shift| image:: ../images/icons/key-shift.svg
:width: 20
Using the Phone
===============
We recommend taking :ref:`librem_5_quick_tour` before exploring the phone software in more detail.
.. toctree::
A_Quick_Tour
Status
Notifications
Virtual_Keyboard
Kill_Switches
.. include:: defs.txt
.. include:: images.txt
.. _librem_5_messages:
......@@ -55,14 +56,29 @@ Press one of the contacts to continue chatting with them.
Start a New SMS Chat
~~~~~~~~~~~~~~~~~~~~
To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the name and phone number for your contact. Select **SMS** as your chat account if it is not the default option.
To start an SMS chat quickly, tap inside the search bar and enter a phone number. An item should appear below the search bar as you type.
.. image:: images/chatty/chatty-new-contact.png
.. image:: images/chatty/chatty-start-chat-number.png
:align: center
:scale: 50%
:alt: Starting a new chat with a phone number
When you have entered the phone number, tap the item to start an SMS chat.
To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the name and phone number for your contact. Select **SMS** as your chat account if it is not the default option.
.. |new-sms-contact| image:: images/chatty/chatty-new-contact.png
:scale: 50%
:alt: Adding a new SMS contact
.. |new-sms-with-xmpp-contact| image:: images/chatty/chatty-new-contact-xmpp.png
:scale: 50%
:alt: Adding a new SMS contact with an XMPP option present
.. centered:: |new-sms-contact| |new-sms-with-xmpp-contact|
Press **Add to Contacts** to add the contact -- this will open the **Contacts** application. You can send a message to the new contact from within **Contacts** or return to **Chats** to start a conversation from the **Start Chat** screen.
When you have entered the phone number and optional name for your new contact, press **Add Contact** to add the contact and start composing a new message. If the contact's number is already known, the **Add Contact** button will be disabled.
When a new conversation has started, it will be shown in a layout like the image below, with incoming messages on the left and outgoing ones on the right.
.. image:: images/chatty/chatty-sms-conversation.png
:align: center
......@@ -76,12 +92,16 @@ Start a New XMPP Chat
Before starting an XMPP chat you need to add an XMPP account to **Chats** -- see the :ref:`librem_5_messages_adding_account` section below.
To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the ID of your contact. Select your XMPP ID as your chat account if it is not the default option.
To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the ID of your contact. Select your Jabber/XMPP ID as your chat account if it is not the default option.
.. image:: images/chatty/chatty-start-chat-new-xmpp-contact.png
:align: center
.. |new-xmpp-contact| image:: images/chatty/chatty-start-chat-new-xmpp-contact.png
:scale: 50%
:alt: Adding a new XMPP contact
.. |new-xmpp-contact-filled| image:: images/chatty/chatty-start-chat-new-xmpp-contact-filled.png
:scale: 50%
:alt: Adding a new XMPP contact with details filled in
.. centered:: |new-xmpp-contact| |new-xmpp-contact-filled|
When you have entered the Jabber ID and an optional name for your new contact, press **Add Contact** to add the contact and start composing a new message. If the contact's ID is already known, the **Add Contact** button will be disabled.
......@@ -99,6 +119,19 @@ If you accepted the contact, you should be able to continue the chat with them.
:scale: 50%
:alt: Continuing an XMPP chat
Individual conversations can be configured by accessing the **Chat Details** page via the menu at the top-right of the screen.
.. |xmpp-chat-menu| image:: images/chatty/chatty-chat-xmpp-menu.png
:scale: 50%
:alt: Opening the XMPP chat menu
.. |xmpp-chat-details| image:: images/chatty/chatty-chat-xmpp-details.png
:scale: 50%
:alt: Viewing the XMPP chat details
.. centered:: |xmpp-chat-menu| |xmpp-chat-details|
As well as details about the connection, you can enable and disable notifications for newly received messages specifically in this conversation.
You can return to the **Chats** list by pressing the back button at the top-left of the screen.
Leaving a Chat
......@@ -167,7 +200,7 @@ The new account should now be shown in the list. By default, the account is acti
An animation may be shown to indicate that the server is being contacted.
If you wish to disable the account, slide the switch left into the off position.
If you wish to disable the connection to the server for the account, slide the switch left into the off position.
Editing and Deleting an Account
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
......
......@@ -13,7 +13,7 @@ The sections below cover each step in the process.
Switch on the Modem
-------------------
The phone cannot configure the mobile network without access to the modem. If the modem is disabled, slide the switch into the enabled position.
The phone cannot configure the mobile network without access to the modem. If the modem is disabled, slide the switch into the enabled position, away from the SIM slot.
.. image:: images/hardware/librem5-switches.svg
:align: center
......
.. include:: defs.txt
.. include:: images.txt
.. _librem_5_settings:
......@@ -80,21 +81,39 @@ Cellular
The **Cellular** page is used to configure your phone's connection to the mobile network. See the :ref:`librem_5_mobile_networks_unlock_sim` section for more information.
.. _librem_5_settings_notifications:
Notifications
-------------
The **Notifications** page is useful when you want to configure how notifications are reported for individual applications and components.
.. |notifications| image:: images/settings/settings-notifications.png
.. image:: images/settings/settings-notifications.png
:scale: 50%
:align: center
:alt: The Notifications page, allowing customization for individual applications
.. |notifications-power| image:: images/settings/settings-notifications-power.png
Notifications can be turned off for all applications and services with the **Do Not Disturb** option.
Press any of the names in the list to open a page showing the preferences for that application or component.
.. image:: images/settings/settings-notifications-power.png
:scale: 50%
:align: center
:alt: The Power notifications page
.. centered:: |notifications| |notifications-power|
The options shown in the image are as follows:
* **Notifications** -- this option allows you to enable or disable delivery of notifications completely for the application.
* **Sound Alerts** will use the system alert sound configured in the **Sound** settings when enabled. Otherwise, no sounds will be used to alert you to new notifications from the application.
* **Notification Popups** are shown at the top of the screen when a notification is delivered.
* **Show Message Content in Popups** -- this option determines whether a summary or a more detailed notification is shown if the application supports it. Only a summary is shown if this is disabled.
* **Lock Screen Notifications** can be shown when the phone is locked and the lock screen is displayed. When enabled, this may result in a message appearing on the lock screen.
* **Show Message Content on Lock Screen** -- this option determines whether a summary or a more detailed message is shown in a lock screen notification if the application supports it.
When you have finished fine-tuning the notification settings, press the back button at the top-left of the screen to return to the main **Notifications** page.
Press any of the names in the list to open a page showing the preferences for that application or component. Press the back button at the top-left of the screen to return to the list.
See the :ref:`librem_5_notifications` chapter of this guide for background information about notifications and how they are used.
.. _librem_5_settings_region_language:
......
......@@ -18,7 +18,12 @@ You will need the following item:
These optional items can also be installed
* microSD card
* 2FF format Smart card
* 3FF format (micro-SIM sized) smart card
*Note that Birch and Chestnut models of the phone accepted 2FF format (mini-SIM) smart cards.*
.. Birch and Chestnut used 2FF format/size; Dogwood uses 3FF.
.. See https://en.wikipedia.org/wiki/SIM_card#3FF for useful information.
Install the nano-SIM Card and microSD Card
------------------------------------------
......
.. include:: defs.txt
.. include:: images.txt
.. _librem_5_software:
......
......@@ -19,5 +19,3 @@ These documents provide additional information that may help to diagnose problem
:maxdepth: 1
Troubleshooting/LEDs
.. include:: /defs.txt
.. include:: defs.txt
.. include:: images.txt
.. _librem_5_wlan:
......
.. include:: defs.txt
.. include:: images.txt
.. _librem_5_web:
......@@ -53,11 +54,9 @@ At the bottom of the screen, the toolbar contains buttons that control navigatio
:align: center
:alt: The bottom bar, showing navigation controls
The first two are back and forward buttons that show the previous and next pages in the browsing history. The third button reloads the current page.
The first two are back and forward buttons that show the previous and next pages in the browsing history.
The |new-tab| (new tab) button in the middle :ref:`opens a new tab <librem_5_web_tabs>`. The numbered button at the right edge of the bar opens the **Tabs** page.
Next to the numbered button, the |bookmarks| (bookmarks) button opens the :ref:`list of bookmarks <librem_5_web_bookmarks>`.
Next to the numbered button, the |bookmarks| (bookmarks) button opens the :ref:`list of bookmarks <librem_5_web_bookmarks>`. The numbered button shows the number of open tabs -- only 1 in the image -- and is used to :ref:`open and switch between tabs <librem_5_web_tabs>`.
.. _librem_5_web_bookmarks:
......@@ -101,7 +100,7 @@ If you are viewing a bookmarked page, you can press the star to open the **Bookm
Editing and Removing Bookmarks
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To edit a bookmark for a page that you are not viewing, open the list of bookmarks and press the symbol to the right of the bookmark.
To edit a bookmark for a page, open the list of bookmarks and press the symbol to the right of the bookmark.
.. image:: images/web/web-bookmarks.png
:align: center
......@@ -117,7 +116,7 @@ This will open the **Bookmark Properties** page where you can edit the details f
When you have finished editing it, you can simply press the back button at the top-left of the screen.
If you want to remove it, press the **Remove Bookmark** button instead.
If you want to remove it, press the **Remove** button instead.
.. _librem_5_web_tabs:
......@@ -130,9 +129,7 @@ Tabs allow you to view more than one page at a time. To begin with, you are usin
:align: center
:alt: The bottom bar, showing the number of tabs open
You can open a new tab by pressing the |new-tab| (new tab) button in the middle of the bottom bar.
Press the tab button to open the **Tabs** page, containing a list of open tabs.
Press the numbered button to open the **Tabs** page, containing a list of open tabs.
.. image:: images/web/web-tabs.png
:align: center
......@@ -146,12 +143,6 @@ If you want to return to the current tab and its contents, press the back button
Opening and Closing Tabs
~~~~~~~~~~~~~~~~~~~~~~~~
While viewing a web page, you can open a new tab by pressing the |new-tab| (new tab) button in the middle of the bottom bar.
.. image:: images/web/web-bottom-bar.png
:align: center
:alt: The bottom bar, showing the number of tabs open
While viewing the list of open tabs, you can press the |new-tab| (new tab) button at the top-right of the screen to open a new tab.
.. image:: images/web/web-tabs2.png
......@@ -186,7 +177,9 @@ When you start browing, the browsing history will be empty. Sites that you visit
.. centered:: |web-history-empty| |web-history|
Select an item to go to that site. Otherwise, press the back button to return to the current page.
You can select an item to open a new tab containing that site, making it the current tab. Press the |copy| (copy) button next to each history item to copy the URL of the site to the clipboard.
Press the back button to return to the current page.
Searching for Sites
~~~~~~~~~~~~~~~~~~~
......@@ -200,10 +193,22 @@ You can search for specific sites by pressing the search button at the top-right
Press the search button again to close the search bar.
Clearing the History
~~~~~~~~~~~~~~~~~~~~
Deleting Sites from the History
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
One or more sites can be deleted from the history by activating selection mode. This is done by pressing the |select| (select) button at the top-right of the screen.
.. |web-history-selection| image:: images/web/web-history-selection.png
:scale: 50%
:alt: Using selection mode to select items for deletion
.. centered:: |web-history| |web-history-selection|
You can discard individual sites from the history by pressing the trashcan button next to the relevant item in the list. To discard all items in the history, press the red trashcan icon at the top-left of the screen.
Once in selection mode, you can select items for deletion. Selected items will show a ticked box next to them, and you can press the **Delete** button at the bottom of the screen to delete them. Press **Cancel** if you want to leave selection mode.
The search button in selection mode can be used to filter the selection before you start choosing items.
To discard all items in the history, press the red **Clear All** button at the bottom-left of the screen.
.. image:: images/web/web-history-clear-all.png
:align: center
......@@ -219,8 +224,7 @@ You can open an *incognito window* to enter private browsing mode. To do this, o
.. image:: images/web/web-menu-incognito.png
:align: center
:scale: 50%
:alt: The main application menu
:alt: The New Incognito Window option is in the main application menu
This browsing mode is useful when you want to visit sites without recording them in your browsing history.
......@@ -274,7 +278,14 @@ Managing Web Applications
Web sites that are installed as web applications appear as launcher icons in the phone's app drawer. These applications are not managed like normal applications. Instead, they are managed by **Web** itself, using its application manager.
Open the application menu and select **Open Application Manager**.
Open the application menu and select **Open Application Manager**. By default, no applications are installed.
.. image:: images/web/web-app-manager-empty.png
:align: center
:scale: 50%
:alt: The Web Application manager with no apps installed
If web applications have been installed, they will appear in a list.
.. image:: images/web/web-app-manager.png
:align: center
......@@ -291,27 +302,27 @@ The browser can be customized via the **Preferences** dialog which can be opened
.. |web-preferences-general-top| image:: images/web/web-preferences-general-top.png
:scale: 50%
:alt: The General preferences tab (top)
.. |web-preferences-general-middle| image:: images/web/web-preferences-general-middle.png
:scale: 50%
:alt: The General preferences tab (top)
.. |web-preferences-general-bottom| image:: images/web/web-preferences-general-bottom.png
:scale: 50%
:alt: The General preferences tab (bottom)
.. centered:: |web-preferences-general-top| |web-preferences-general-bottom|
.. centered:: |web-preferences-general-top| |web-preferences-general-middle| |web-preferences-general-bottom|
The **Fonts & Style**, **Stored Data**, **Language** and **Sync** tabs contain preferences that are specific to these areas.
The **Privacy**, **Appearance** and **Sync** tabs contain preferences that are specific to these areas.
.. |web-preferences-fonts| image:: images/web/web-preferences-fonts.png
:scale: 50%
:alt: The Fonts & Style preferences tab
.. |web-preferences-storage| image:: images/web/web-preferences-storage.png
.. |web-preferences-privacy| image:: images/web/web-preferences-privacy.png
:scale: 50%
:alt: The Stored Data preferences tab
.. |web-preferences-language| image:: images/web/web-preferences-language.png
:alt: The Privacy preferences tab
.. |web-preferences-appearance| image:: images/web/web-preferences-appearance.png
:scale: 50%
:alt: The Language preferences tab
:alt: The Appearance preferences tab
.. |web-preferences-sync| image:: images/web/web-preferences-sync.png
:scale: 50%
:alt: The Sync preferences tab
.. centered:: |web-preferences-fonts| |web-preferences-storage| |web-preferences-language|
.. centered:: |web-preferences-privacy| |web-preferences-appearance| |web-preferences-sync|
When you have finished updating your preferences, press the back button at the top-left of the screen to return to the current page.
......@@ -17,132 +17,3 @@
.. |br| raw:: html
<br />
.. Image substitutions
.. |menu| image:: images/icons/open-menu-symbolic.svg
:width: 20
.. |new-tab| image:: images/icons/tab-new-symbolic.svg
:width: 20
.. |close| image:: images/icons/window-close-symbolic.svg
:width: 20
.. |back| image:: images/icons/go-previous-symbolic.svg
:width: 20
.. |bookmarks| image:: images/icons/ephy-bookmarks-symbolic.svg
:width: 20
.. |reader| image:: images/icons/ephy-reader-mode-symbolic.svg
:width: 20
.. |add| image:: images/icons/list-add-symbolic.svg
:width: 20
.. |remove| image:: images/icons/list-remove-symbolic.svg
:width: 20
.. |enter| image:: images/icons/key-enter.svg
:width: 20
.. |shift| image:: images/icons/key-shift.svg
:width: 20
.. |delete| image:: images/icons/edit-delete-symbolic.svg
:width: 20
.. |backspace| image:: images/icons/edit-clear-symbolic.svg
:width: 20
.. |view-more| image:: images/icons/view-more-symbolic.svg
:width: 20
.. |keyboard| image:: images/icons/input-keyboard-symbolic.svg
:width: 20
.. |mode| image:: images/icons/keyboard-mode-symbolic.svg
:width: 20
.. Larger icons for inline use in tables
.. Networking
.. |network-txrx| image:: images/icons/network-transmit-receive-symbolic.svg
:width: 40
.. |network-offline| image:: images/icons/network-offline-symbolic.svg
:width: 40
.. |network-no-route| image:: images/icons/network-no-route-symbolic.svg
:width: 40
.. Cellular
.. |cell-dis| image:: images/icons/network-cellular-disabled-symbolic.svg
:width: 40
.. |cell-excellent| image:: images/icons/network-cellular-signal-excellent-symbolic.svg
:width: 40
.. |cell-good| image:: images/icons/network-cellular-signal-good-symbolic.svg
:width: 40
.. |cell-ok| image:: images/icons/network-cellular-signal-ok-symbolic.svg
:width: 40
.. |cell-weak| image:: images/icons/network-cellular-signal-weak-symbolic.svg
:width: 40
.. |cell-none| image:: images/icons/network-cellular-signal-none-symbolic.svg
:width: 40
.. WLAN
.. |wlan-excellent| image:: images/icons/network-wireless-signal-excellent-symbolic.svg
:width: 40
.. |wlan-good| image:: images/icons/network-wireless-signal-good-symbolic.svg
:width: 40
.. |wlan-ok| image:: images/icons/network-wireless-signal-ok-symbolic.svg
:width: 40
.. |wlan-weak| image:: images/icons/network-wireless-signal-weak-symbolic.svg
:width: 40
.. |wlan-none| image:: images/icons/network-wireless-signal-none-symbolic.svg
:width: 40
.. |wlan-dis| image:: images/icons/network-wireless-disabled-symbolic.svg
:width: 40
.. |wlan-offline| image:: images/icons/network-wireless-offline-symbolic.svg
:width: 40
.. |wlan-acquire| image:: images/icons/network-wireless-acquiring-symbolic.svg
:width: 40
.. |wlan-connect| image:: images/icons/network-wireless-connected-symbolic.svg
:width: 40
.. Battery
.. |battery-empty| image:: images/icons/battery-empty-symbolic.svg
:width: 40
.. |charging-empty| image:: images/icons/battery-empty-charging-symbolic.svg
:width: 40
.. |battery-low| image:: images/icons/battery-low-symbolic.svg
:width: 40
.. |charging-low| image:: images/icons/battery-low-charging-symbolic.svg
:width: 40
.. |battery-full| image:: images/icons/battery-full-symbolic.svg
:width: 40
.. |charging-full| image:: images/icons/battery-full-charging-symbolic.svg
:width: 40
.. Image substitutions
.. |add| image:: images/icons/list-add-symbolic.svg
:width: 20
.. |back| image:: images/icons/go-previous-symbolic.svg
:width: 20
.. |bookmarks| image:: images/icons/ephy-bookmarks-symbolic.svg
:width: 20
.. |close| image:: images/icons/window-close-symbolic.svg
:width: 20
.. |copy| image:: images/icons/edit-copy-symbolic.svg
:width: 20
.. |delete| image:: images/icons/edit-delete-symbolic.svg
:width: 20
.. |enter| image:: images/icons/key-enter.svg
:width: 20
.. |keyboard| image:: images/icons/input-keyboard-symbolic.svg
:width: 20
.. |menu| image:: images/icons/open-menu-symbolic.svg
:width: 20
.. |new-tab| image:: images/icons/tab-new-symbolic.svg
:width: 20
.. |reader| image:: images/icons/ephy-reader-mode-symbolic.svg
:width: 20
.. |remove| image:: images/icons/list-remove-symbolic.svg
:width: 20
.. |select| image:: images/icons/object-select-symbolic.svg
:width: 20
.. |view-more| image:: images/icons/view-more-symbolic.svg
:width: 20