Firefox2: Difference between revisions

From OLPC
Jump to navigation Jump to search
(added a note on configuring Firefox to use the Read activity to open PDF files)
m (Reverted edits by 190.112.87.157 (Talk) to last revision by 96.11.102.250)
 
(40 intermediate revisions by 18 users not shown)
Line 1: Line 1:
{{Linux software}}
== Requirements ==
* Development version (devel) of OLPC system


{{RightTOC}}
== Installing Firefox 2.0 ==


== Introduction ==
As simple as:
Firefox is an internet browser, in fact it is the one that we based the [[Browse]] activity on. If you are looking for something with a few more features, (tabbed browsing, bookmarks, etc) then you might want to give Firefox a shot. It runs a little heavy for the XO, but if one doesn't go overboard opening tabs it runs fine, if slow.
yum install firefox


'''There is now a version of Firefox 3 packaged as an activity available from the [[Activities]] page. This may be an easier alternative than the instructions below.''' See the [[Firefox]] page for more information.
== Installing Flash 9 plugin ==

* Open a terminal as root
== Installing Firefox ==
* Download the plugin file:

''wget http://fpdownload.macromedia.com/get/flashplayer/current/install_flash_player_9_linux.tar.gz''
Installing Firefox isn't as complicated as it looks. Take your time and read each instruction carefully. Be sure to note the spaces in the commands, and that the "slashes" slant forwards, not backwards like under Windows.
* Unpack the file:

''tar xzvf install_flash_player_9_linux.tar.gz''
=== Before we start ===
* Run the ''flashplayer-installer'' and follow instructions:

''./flashplayer-installer''
==== Requirements ====
* At least 50 MB of free space
* Patience. Firefox can be a bit sluggish on the XO at times.
* Get the XO's WiFi connected to a wireless access point [[Wifi Connectivity]].

This is a good activity for exploring your XO. If something goes wrong, it is very unlikely you will break your normal Sugar installation.

==== Install ==== <br />( these instructions apply to firefox 2. Firefox 3 does not need the libstdc++ thing.) * <br />Start the [[Terminal Activity]]. <br />* When you see a prompt that looks roughly like "[olpc@xo-NN-NN-NN]$", start typing the following commands, pressing the <enter> key after each one: wget http://ff20012.notlong.com (This command may take a while, but be patient.)<br />
tar -xzf firefox-2.0.0.12.tar.gz<br />
su - yum install compat-libstdc++*<br />
Instalar ==== ==== (estas instrucciones se aplican a Firefox 2. Firefox 3 no tiene la cosa libstdc + +.) * Inicio de la [[Terminal de Actividad]]. * Cuando veas un símbolo que se ve más o menos como "[OLPC @ xo-NN NN NN] $ ", empieza a escribir los siguientes comandos y presione la tecla <enter> después de cada uno: wget http://ff20012.notlong.com (Este comando puede llevar un tiempo, pero sea paciente. ) tar-xzf firefox-2.0.0.12.tar.gz su - yum install compat-libstdc + + *</span>

== Running Firefox ==

When the above is finished you run Firefox from the same [[Terminal Activity]] with the following command:

./firefox/firefox

''Note: if the above fails and says file not found, then type the following command''

cd /home/olpc

It will take quite a while to start for the first time, since it has a lot of setup tasks to perform. So be patient. At this point, FireFox may ask if you want to import any settings. Select "None" and continue.

* FireFox will display this error message:

Firefox can't find the file at /usr/share/doc/HTML/index.html

* You can ignore this error.
* Click on the "Home" icon to go to the "Firefox Start" homepage. You're on your way!

== Common Addons ==

* [[Flash Player]] - Plays Shockwave, and Flash items on a webpage.


== Running the Firefox browser after installation ==
* Get the XO's WiFi connected to a wireless access point so the XO can download Firefox from the internet. Read more about how to do this at [[Wifi_Connectivity]].

* Start the [[Terminal_Activity]].

* When you see a prompt that looks roughly like "[olpc@xo-NN-NN-NN]$", start typing the following commands, pressing the <enter> key after each one:

./firefox/firefox

* Firefox will display a blank (gray) screen by default. Click on the "Home" button to go to the "Firefox Start" page.
* If Firefox displays an error, the XO's WiFi is likely not connected. Check the [[Wifi_Troubleshooting_Guide]].

== Running the Firefox browser outside of the Terminal Activity ==


== Running the browser ==
* In a shell outside X (ctrl+alt+F1, ctrl+alt+F2, ...):
* In a shell outside X (ctrl+alt+F1, ctrl+alt+F2, ...):
**As root, set an environment variable:
**As root, set an environment variable:
*** ''export DISPLAY=127.0.0.1:0.0''
*** ''export DISPLAY=127.0.0.1:0.0''
** Execute the firefox with the user olpc:
** Execute the firefox with the user olpc:
*** ''su olpc -c "firefox &"''
*** ''su olpc -c "/home/olpc/firefox/firefox &"''
* Through a shell in X (alt+=):
* Through a shell in X (alt+=):
** just type firefox from there
** just type firefox from there
Line 27: Line 74:
== Opening PDF using the Read activity ==
== Opening PDF using the Read activity ==
Open the Terminal activity and run:
Open the Terminal activity and run:
wget http://zoehep.xent.com/~bsittler/Read
<s>wget http://zoehep.xent.com/~bsittler/Read</s> (server is dead)
Then when you click on a PDF link tell Firefox to always open with /home/olpc/Read
Then when you click on a PDF link tell Firefox to always open with /home/olpc/Read

<b>Note:</b> this launches the Read activity with full access to your account. Be sure you trust the activity completely before doing this!
<b>Note:</b> this launches the Read activity with full access to your account. Be sure you trust the activity completely before doing this!


Line 49: Line 97:
* Right-clicking in a flash closes the browser window
* Right-clicking in a flash closes the browser window


== Older equipment notes ==
[[Category:Software]]
* Requires A [[B4]] or later XO-1 Laptop

[[Category:Developers]]
[[Category:Developers]]
[[Category:Web browsers]]

{{cleanup}}
{{cleanup}}

Latest revision as of 20:06, 4 November 2011

This command is run in the standard Linux environment via the Terminal Activity. The GUI will probably not integrate comfortably with the XO Laptop's Sugar environment. Your user experience may vary considerably depending on the established environment and the other programs running on the laptop, may need re-installation after an OS Update. See the Linux software category for other commands.


Introduction

Firefox is an internet browser, in fact it is the one that we based the Browse activity on. If you are looking for something with a few more features, (tabbed browsing, bookmarks, etc) then you might want to give Firefox a shot. It runs a little heavy for the XO, but if one doesn't go overboard opening tabs it runs fine, if slow.

There is now a version of Firefox 3 packaged as an activity available from the Activities page. This may be an easier alternative than the instructions below. See the Firefox page for more information.

Installing Firefox

Installing Firefox isn't as complicated as it looks. Take your time and read each instruction carefully. Be sure to note the spaces in the commands, and that the "slashes" slant forwards, not backwards like under Windows.

Before we start

Requirements

  • At least 50 MB of free space
  • Patience. Firefox can be a bit sluggish on the XO at times.
  • Get the XO's WiFi connected to a wireless access point Wifi Connectivity.

This is a good activity for exploring your XO. If something goes wrong, it is very unlikely you will break your normal Sugar installation.

==== Install ====
( these instructions apply to firefox 2. Firefox 3 does not need the libstdc++ thing.) *
Start the Terminal Activity.
* When you see a prompt that looks roughly like "[olpc@xo-NN-NN-NN]$", start typing the following commands, pressing the <enter> key after each one: wget http://ff20012.notlong.com (This command may take a while, but be patient.)
tar -xzf firefox-2.0.0.12.tar.gz
su - yum install compat-libstdc++*
Instalar ==== ==== (estas instrucciones se aplican a Firefox 2. Firefox 3 no tiene la cosa libstdc + +.) * Inicio de la Terminal de Actividad. * Cuando veas un símbolo que se ve más o menos como "[OLPC @ xo-NN NN NN] $ ", empieza a escribir los siguientes comandos y presione la tecla <enter> después de cada uno: wget http://ff20012.notlong.com (Este comando puede llevar un tiempo, pero sea paciente. ) tar-xzf firefox-2.0.0.12.tar.gz su - yum install compat-libstdc + + *

Running Firefox

When the above is finished you run Firefox from the same Terminal Activity with the following command:

./firefox/firefox

Note: if the above fails and says file not found, then type the following command

cd /home/olpc

It will take quite a while to start for the first time, since it has a lot of setup tasks to perform. So be patient. At this point, FireFox may ask if you want to import any settings. Select "None" and continue.

  • FireFox will display this error message:
Firefox can't find the file at /usr/share/doc/HTML/index.html
  • You can ignore this error.
  • Click on the "Home" icon to go to the "Firefox Start" homepage. You're on your way!

Common Addons

  • Flash Player - Plays Shockwave, and Flash items on a webpage.


Running the Firefox browser after installation

  • Get the XO's WiFi connected to a wireless access point so the XO can download Firefox from the internet. Read more about how to do this at Wifi_Connectivity.
  • When you see a prompt that looks roughly like "[olpc@xo-NN-NN-NN]$", start typing the following commands, pressing the <enter> key after each one:
./firefox/firefox
  • Firefox will display a blank (gray) screen by default. Click on the "Home" button to go to the "Firefox Start" page.
  • If Firefox displays an error, the XO's WiFi is likely not connected. Check the Wifi_Troubleshooting_Guide.

Running the Firefox browser outside of the Terminal Activity

  • In a shell outside X (ctrl+alt+F1, ctrl+alt+F2, ...):
    • As root, set an environment variable:
      • export DISPLAY=127.0.0.1:0.0
    • Execute the firefox with the user olpc:
      • su olpc -c "/home/olpc/firefox/firefox &"
  • Through a shell in X (alt+=):
    • just type firefox from there

Opening PDF using the Read activity

Open the Terminal activity and run:

wget http://zoehep.xent.com/~bsittler/Read (server is dead)

Then when you click on a PDF link tell Firefox to always open with /home/olpc/Read

Note: this launches the Read activity with full access to your account. Be sure you trust the activity completely before doing this!

Known Problems

  • firefox is excluded from the repository on G1G1 machines. You must edit (as root) /etc/yum.repos.d/olpc-koji-ship2.repo to remove firefox from exclude list before installing with yum
    • One way to do edit the file is to use the built-in Vi editor as follows (type commands without the quotes):
  1. Start the Terminal activity (this gives you a line like "[olpc@...]$ )
  2. Click in the window
  3. Type "su" and Enter for super user mode
  4. Invoke the Vi(M) editor: "vi" and Enter
  5. (You might find the Vi cheatsheet at: http://www.tuxfiles.org/linuxhelp/vimcheat.html to be of use)
  6. Load the file: ":e /etc/yum.repos.d/olpc-koji-ship2.repo" and Enter
  7. Use the arrow keys to move to the "f" of "firefox"
  8. Use the "x" key repeatedly to delete "firefox" and the following comma
  9. (If you get into a mode like insert that won't let you issue a command, use the circle-x key in the upper left corner of the keyboard to exit that mode.)
  10. Write the file out and quit: ":wq" and Enter
    • Installation of Firefox 2 appears to use about 42 MB. The installation downloads about 35 MB.
  • Performance issues
  • It is not "sugarizable"
  • Right-clicking in a flash closes the browser window

Older equipment notes

  • Requires A B4 or later XO-1 Laptop