Chapter 2.1.1: Firefox
==============================

Description
---------------
Firefox is a highly-rated, and secure web browser that is installed by default in Ubuntu.
It is a decent choice if one wants a secure, fast, yet relatively less resource-heavy browser. 

Firefox has features of other web browsers and its own ones, such as:
 - Tab browsing
 - Scroll through tabs
 - Great plugins and add-ons
 - Favorites, bookmarks, pocket
 - Firefox account sync
 - Master password
 - UI customization with themes and toolbars
 - Advanced customization with about:config
 - Open source

Screenshot
--------------
.. image:: firefox-screenshot.png
   :width: 80%

Usage
------
To open a new tab in Firefox press the plus button on the right of the tab bar or press :kbd:`Control + t`. To close a tab press the button with an :guilabel:`x` on the right side of the tab or press :kbd:`Control +W`.  To Open a new window in browsing press :kbd:`Control +N`. To view your browsing history press the hamburger menu :menuselection:`Library --> History` or press :kbd:`Control +H`. When you have the history sidebar you can search through your history where it says :guilabel:`Search History`. To view your downloaded files press the button that looks like three stacked books with a fourth leaning over :menuselection:`--> Downloads`.

To go back to a previous page in Firefox press the button pointing to the left or press :kbd:`Alt + Left arrow`. To open the page you were previously at in a new tab middle click the back button. To go forward to a page you have visited before but have now gone back from press the button with the arrow pointing to the right or :kbd:`Alt + Right arrow`. Middle click on the forward button to open the page you went back from in a new tab. To download a file directly to your local disk right click :menuselection:`Save Link As` file as and then you will get a dialog box to show where to save it. 

To open a window with all of your downloads on it press :kbd:`Control+Shift+Y`. To open pcmanfm-qt in the folder where you downloaded things right click and select on the download and select :menuselection:`Open Containing Folder`. To get a link for someone else to download something right click on the downloaded content right click and select :menuselection:`Copy Download Link`.

.. image:: firefox-downloads.png


To have a list of all of your tabs press the downward pointing arrowhead button however this only appears if you have more tabs than fit on your screen normally. To switch the view of your tabs if you have more than on the screen press the right ward pointed arrowhead to move the visible part of the tab bar to the right. To move the visible part of the tab bar to the left press the leftward pointed arrowhead. To open a new tab press the :guilabel:`+` button. To search through all your tabs you can click on the downward pointed arrow and select :menuselection:`Search Tabs`. 

To scroll down using the keyboard press :kbd:`Page Down`. To scroll up the page with the keyboard press :kbd:`Page Up`. To scroll all the way back up to the top press the :kbd:`Home` key. To move all the way to the bottom of the page press the :kbd:`End` key.

To go to a specific URL in the address bar you can type it in the main bar in the middle. If you have a URL in your clipboard you can paste it here or into the address bar right click :menuselection:`Paste & Go`. Or if you right click into the clipboard and not immediately go to the page and type in a sub page right click :menuselection:`Paste` and then type to go a specific sub page of the same site and then press :kbd:`Enter` to go to the page. If you press :kbd:`F6` the cursor will select the address bar. If you want to search through the tabs you have open type % and then what you want to type in the address bar.

To bookmark a page press :kbd:`Control +D` or Press the button with three vertical lines and slanted one and then the submenu of bookmarks and bookmark this page. To access the bookmark again press that looks like three vertical lines and a slanted one and bookmarks and then select the bookmark you want. If you want a toolbar with your bookmarks on it right click on the address bar and select :menuselection:`Bookmarks Toolbar`.

To copy text in Firefox select it with the mouse and press :kbd:`Control +C` or right click on it and select :menuselection:`Copy`. To paste text into Firefox press :kbd:`Control+ V` or right click  and select :menuselection:`Paste`. To cut text in Firefox select the text and press :kbd:`Control+X` or right click and select :menuselection:`Cut`.

To view info on your webpage press :kbd:`Control+ I`.

To zoom in if you find the text on a web page to small press :kbd:`control + +`. If you want to zoom out on the text or pictures press :kbd:`control + -`. To reset to the original zoom press :kbd:`control + 0`. To make Firefox fullscreen press :kbd:`F11` to leave fullscreen simply press :kbd:`F11` again. You can also type your zoom into Firefox from the hamburger menu :menuselection:`Zoom` field and press the :guilabel:`+` and :guilabel:`-`.

To print a webpage such as directions you can click the button with horizontal bars and select :menuselection:`Print` from the menu. You can also print by pressing :kbd:`Control+P`. 

If you want a menubar for Firefox right click the main toolbar and click the checkbox for :menuselection:`Menu Bar`. To reload a tab even one you are not on right click on the tab bar :menuselection:`Reload Tab`, press :kbd:`F5`, :kbd:`Control+R`. To mute a tab even when you are not on it you can right click on the tab and then select :menuselection:`Mute Tab` or by pressing :kbd:`Control+m`. To open a new copy of a tab right click on the tab bar and then select :menuselection:`Duplicate Tab`. To move a tab all the way to the left right click on the tab :menuselection:`Move tab --> Move to start`. To move a tab all the way to the right right click on tab :menuselection:`Move tab --> Move to end`. To move a tab to a new window right click on the tab and :menuselection:`Move tab --> Move to new Window`. To open a new private window press :kbd:`Control+Shift+P`. If you want to bookmark a tab right click the tab and :menuselection:`Bookmark tab`. To close tabs to the right of the current tab right click on the tab and :menuselection:`Close tabs to the right`. To undo closing a tab right click on a tab and :menuselection:`Undo Close Tab`.  

.. image:: firefox-tab-context.png

If you want to view your Firefox preferences you can type about:preferences into the address bar. To have your session restored each time you restart Firefox is on the general tab of Firefox preferences is to press restore previous session. The checkbox for :guilabel:`Restore previous session` checkbox restores your tab when you close Firefox. The tabs section has a checkbox to :guilabel:`Open links in new tabs` instead of new windows which is checked by default. The checkbox for :guilabel:`When you open a link a new tab switch to it immediately` switches to new tabs when you open them. The radio button group for :guilabel:`Downloads` lets you have a static location to save downloads or always ask to save files. 

To tab on the left :guilabel:`Home` has settings for your home and opening of new tabs. The :guilabel:`Homepage and new windows` drop down lets you select the Firefox home or a blank page when you first open the browser. The :guilabel:`New Tabs` menu lets you choose Firefox home or blank page when you open a new tab. The checkbox :guilabel:`Web Search` lets you toggle whether to show a web search on the Firefox homepage. The checkbox :guilabel:`Top Sites` shows the sites you visit the most. The checkbox :guilabel:`Recommend by Pocket` toggles links recommend by pocket. Uncheck the :guilabel:`Sponsored stories` checkbox to not have sponsored stories from pocket. The :guilabel:`Highlights` checkbox allows site that you have saved or visited recently.  

.. image:: prefrenceshome.png

To manage your search settings use the :guilabel:`Search` tab on preferences. The radio button for :guilabel:`Search Bar` changes whether you want a separate search bar or and integrated search bar for search and navigation. The :guilabel:`Default Search Engine` lets you change your default search engine. To toggle whether to search suggestions check/uncheck the :guilabel:`Provide search suggestions`.

Version
----------
Lubuntu currently ships with the latest version of Firefox, Firefox 69.

How to Launch
----------------
To open Firefox, click on the Firefox icon (red/orange fox covering a blue sphere) in :menuselection:`Internet --> Firefox` Menu.
You can also type and run 

.. code:: 

   firefox

from the terminal to run Firefox. You can also from the command line have Firefox directly open this manual with 

.. code:: 

   firefox https://manual.lubuntu.me
   
You can also launch Firefox from the quick launch by default by left clicking on it. The icon for firefox looks like a globe with a red fox circling around it.
