home *** CD-ROM | disk | FTP | other *** search
/ Freelog 115 / FreelogNo115-MaiJuin2013.iso / Internet / Firefox / FirefoxPortable_20.0_French.paf.exe / Other / Source / Readme.txt < prev    next >
Text File  |  2010-06-22  |  9KB  |  168 lines
  1. ∩╗┐Firefox Portable Launcher
  2. =========================
  3. Copyright 2004-2008 John T. Haller of PortableApps.com
  4.  
  5. Website: http://PortableApps.com/FirefoxPortable
  6.  
  7. This software is OSI Certified Open Source Software.
  8. OSI Certified is a certification mark of the Open Source Initiative.
  9.  
  10. This program is free software; you can redistribute it and/or
  11. modify it under the terms of the GNU General Public License
  12. as published by the Free Software Foundation; either version 2
  13. of the License, or (at your option) any later version.
  14.  
  15. This program is distributed in the hope that it will be useful,
  16. but WITHOUT ANY WARRANTY; without even the implied warranty of
  17. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18. GNU General Public License for more details.
  19.  
  20. You should have received a copy of the GNU General Public License
  21. along with this program; if not, write to the Free Software
  22. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  23.  
  24. ABOUT FIREFOX PORTABLE
  25. ======================
  26. The Firefox Portable Launcher allows you to run Firefox from a removable drive
  27. whose letter changes as you move it to another computer.  The browser and the
  28. profile can be entirely self-contained on the drive and then used on any Windows
  29. computer.  Specific configuration changes are made to the chrome.rdf so that
  30. your extensions will still work as the drive letter changes.
  31.  
  32.  
  33. LICENSE
  34. =======
  35. This code is released under the GPL.  Within the FirefoxPortableSource directory
  36. you will find the code (FirefoxPortable.nsi) as well as the full GPL license
  37. (License.txt).  If you use the launcher or code in your own product, please give
  38. proper and prominent attribution.
  39.  
  40.  
  41. INSTALLATION / DIRECTORY STRUCTURE
  42. ==================================
  43. By default, the program expects the following directory structure:
  44.  
  45. -\ <--- Directory with FirefoxPortable.exe
  46.     +\App\
  47.         +\firefox\
  48.     +\Data\
  49.         +\profile\
  50.         +\settings\
  51.         +\plugins\ (optional)
  52.         
  53. The above files may also be placed in a FirefoxPortable directory with the 
  54. FirefoxPortable.exe launcher a directory above that.
  55.  
  56. It can be used in other directory configurations by including the FirefoxPortable.ini
  57. file in the same directory as FirefoxPortable.exe and configuring it as detailed in
  58. the INI file section below.
  59.  
  60.  
  61. FIREFOXPORTABLE.INI CONFIGURATION
  62. =================================
  63. The Firefox Portable Launcher will look for an ini file called FirefoxPortable.ini
  64. within its directory.  If you are happy with the default options, it is not necessary,
  65. though.  There is an example INI included with this package to get you started.  The
  66. INI file is formatted as follows:
  67.  
  68. [FirefoxPortable]
  69. FirefoxDirectory=App\firefox
  70. ProfileDirectory=Data\profile
  71. SettingsDirectory=Data\settings
  72. PluginsDirectory=Data\plugins
  73. FirefoxExecutable=firefox.exe
  74. AdditionalParameters=
  75. LocalHomepage=
  76. WaitForFirefox=false
  77. DisableSplashScreen=false
  78. AllowMultipleInstances=false
  79. DisableIntelligentStart=false
  80. SkipCompregFix=false
  81. RunLocally=false
  82.  
  83. The FirefoxDirectory, ProfileDrectory, SettingsDirectory and PluginsDirectory entries
  84. should be set to the *relative* path to the directories containing firefox.exe, your
  85. profile, your plugins, etc. from the current directory.  All must be a subdirectory
  86. (or multiple subdirectories) of the directory containing FirefoxPortable.exe.  The
  87. default entries for these are described in the installation section above.
  88.  
  89. The FirefoxExecutable entry allows you to set the Firefox Portable Launcher to use
  90. an alternate EXE call to launch firefox.  This is helpful if you are using a machine
  91. that is set to deny firefox.exe from running.  You'll need to rename the firefox.exe
  92. file and then enter the name you gave it on the firefoxexecutable= line of the INI.
  93.  
  94. The AdditionalParameters entry allows you to pass additional commandline parameter
  95. entries to firefox.exe.  Whatever you enter here will be appended to the call to
  96. firefox.exe.
  97.  
  98. The LocalHomepage entry allows you to set Firefox Portable to use a local file on your
  99. read-only disc (CD/DVD/etc) as your homepage when running in Live mode.  It's not necessary
  100. for use on regular drives (the launcher handles portablizing your homepage path).  The
  101. file must be a path relative to the launcher. If you were to set it to a file in the
  102. same directory as FirefoxPortable.exe, you would use LocalHomepage=homepage.html  If it
  103. was in a subdirectory called homepage, you would enter LocalHomepage=homepage/homepage.html.
  104.  
  105. The WaitForFirefox entry allows you to set the launcher to remain active until Firefox has
  106. closed.  This is useful if you wish to have another process wait until Firefox Portable
  107. has closed.  The launcher will automatically wait for Firefox to close in cases where it
  108. needs to clean up after firefox.exe (for instance, to clean up %APPDATA%\Mozilla\Firefox
  109. when there is no locally-installed Firefox).
  110.  
  111. The DisableSplashScreen entry allows you to run the Firefox Portable Launcher without the
  112. splash screen showing up.  The default is false.
  113.  
  114. The AllowMultipleInstances entry will allow Firefox Portable to run alongside your
  115. regular local copy of Firefox if you set it to true (lowercase).  The default is false.
  116.  
  117. The DisableIntelligentStart entry allows you to to have Firefox Portable run its chrome
  118. and component registry fixes on every start.  Normally, it tracks when you've moved to a
  119. new path (switching PCs for instance) and only processes the chrome and component
  120. registry when you do.  By skipping it when the path is the same, Firefox Portable starts
  121. up faster.  But, if you copy a profile into Firefox Portable between sessions (it handles
  122. a copy in on first run automatically), it won't know to process these.  This usually
  123. happens if you copy a profile into Firefox Portable from your local PC on a regular basis
  124. with a sync utility that doesn't work with Firefox Portable (like Portable Apps Sync
  125. does).  Setting this to true causes Firefox Portable to process each on every start.
  126.  
  127. The SkipCompregFix entry allows you to set Firefox Portable not to adjust the component
  128. registry (compreg.dat) for certain extension compatibility on launch.  It is useful if
  129. you are only using Firefox Portable on computers you control and are able to have the
  130. drive letter set the same each time or if you are not using extensions which make use of
  131. the component registry (like Forecast Fox or the Mozilla Calendar) as Firefox Portable
  132. will launch more quickly.  Set it to true (lowercase) to skip chrome.rdf processing.  The
  133. default is false.
  134.  
  135. The RunLocally entry allows you to set Firefox Portable to copy your profile, plugins and
  136. Firefox binaries to the local machine's temp directory.  This can be useful for instances
  137. where you'd like to run Firefox Portable from a CD (aka Firefox Portable Live) or when
  138. you're working on a machine that may have spyware or viruses and you'd like to keep your
  139. device set to read-only mode.  The only caveat is, of course, that any changes you make
  140. that session (cookies, bookmarks, etc) aren't saved back to your device.  When done
  141. running, the local temp directories used by Firefox Portable are removed. RunLocally does
  142. not currently work with AllowMultipleInstances as it cannot track which version of
  143. Firefox is running.
  144.  
  145.  
  146. PROGRAM HISTORY / ABOUT THE AUTHORS
  147. ===================================
  148. This launcher contains suggestions from multiple sources.  It began as a batch file launcher
  149. written by myself (John T. Haller) and posted to the mozillaZine.org thread about running
  150. Firefox from a USB key.  tracon later released a launcher called fflaunch which I
  151. enhanced and re-released as Firefox Portable.  mai9 later improved on fflaunch's
  152. techniques and released it as Free The Fox.  Multiple suggestions back and forth from mai9,
  153. myself and others lead to the launcher we have today.  This most recent version adds my
  154. methods for allowing the code to be run from anywhere on first launch (as opposed to a
  155. specific directory), pass in commandline options, run without an ini file, allow the use
  156. of profiles from local installations, intelligent startup (the launcher determines whether
  157. paths have changed) and more.
  158.  
  159.  
  160. CURRENT LIMITATIONS
  161. ===================
  162. INCOMPATIBLE EXTENSIONS - Certain extensions use additional local files or prefs.js in a
  163. non-standard way to store information, neither of which are handled by the Firefox Portable
  164. launcher when moving between machines.
  165.  
  166. NO PORTABLE JAVA - Sun's Java VM needs to be installed locally as Firefox looks for specific
  167. registry keys to run Java. There is no way to make it portable at present, so you will only
  168. be able to use Java-enabled sites on machines that have the Sun Java VM installed locally.