R browseURL 將 URL 加載到 HTML 瀏覽器中

說明

將給定的 URL 加載到 HTML 瀏覽器中。

用法

browseURL(url, browser = getOption("browser"),
          encodeIfNeeded = FALSE)

參數

url	給出要加載的 URL 的非空字符串。某些平台還接受文件路徑。
browser	一個非空字符串，給出用作 HTML 瀏覽器的程序名稱。它應該位於 PATH 中，或者指定的完整路徑中。或者，一個R調用函數來調用瀏覽器。 在Windows下NULL也是允許的(並且是默認的)，並且意味著將使用文件關聯機製。
encodeIfNeeded	URL 是否應該編碼為URLencode在傳遞給瀏覽器之前？如果以下情況，則不需要(並且可能有害)：browser程序/函數本身進行編碼，並且可能對‘⁠文件://⁠' 某些係統上的 URL 以及“⁠http://⁠’傳遞給某些 CGI 應用程序的 URL。幸運的是，大多數 URL 不需要編碼。

細節

在 Unix 類係統上：

默認瀏覽器由選項設置"browser"，依次由環境變量設置R_BROWSER默認情況下在文件‘中設置base Rhome/etc/Renviron’到手動或自動做出的選擇R已配置。 (看Startup了解在何處覆蓋該默認值。)要完全禁止顯示 URL，請使用該值"false".

在許多平台上，最好將選項 "browser" 設置為通用程序/腳本，並讓它調用用戶選擇的瀏覽器。例如，在 macOS 上使用 open ，在許多其他 Unix 類似係統上使用 xdg-open 。

如果browser支持遠程控製和R知道如何執行它，可以在任何 already-running 瀏覽器或新瀏覽器(如果需要)中打開該 URL。該機製目前可用於支持"-remote openURL(...)"接口(包括 Mozilla 和 Opera)、Galeon、KDE konqueror(通過kfmclient)和 Mozilla 的 GNOME 接口。 (Firefox 已放棄支持，但默認使用 already-running 瀏覽器。)請注意，瀏覽器的類型是根據其名稱確定的，因此僅當瀏覽器以其規範名稱安裝時才會使用此機製。

由於 "-remote" 將使用 X 服務器上顯示的任何瀏覽器(無論它運行在什麽機器上)，因此僅當 DISPLAY 指向本地主機時才使用遠程控製機製。這可能不允許從遠程主機一次顯示多個 URL。

如有必要，調用者有責任對 url 進行編碼(請參閱 URLencode )。

要完全禁止顯示 URL，請設置 browser = "false" 。

非 URL 的參數 url 的行為取決於平台。有些平台接受絕對文件路徑；較少接受相對文件路徑。

在 Windows 上：

默認瀏覽器由選項設置"browser"，依次由環境變量設置R_BROWSER如果已設置，否則NULL。要完全禁止顯示 URL，請使用該值"false".

有些瀏覽器需要‘⁠：⁠' 替換為 '⁠|⁠’ 在文件路徑中：其他人不接受這一點。所有人似乎都接受‘⁠\⁠’ 作為路徑分隔符，盡管 RFC1738 標準要求 ‘⁠/⁠’。

要完全禁止顯示 URL，請設置 browser = "false" 。

URL方案

接受哪些 URL 方案是特定於平台的：expect ‘⁠http://⁠', '⁠https://⁠' 和 '⁠ftp://⁠’去工作，但是‘⁠郵件地址：⁠’可能會也可能不會(如果確實如此，則可能不會使用用戶首選的電子郵件客戶端)。然而，現代瀏覽器不太可能處理‘⁠ftp://⁠’。

為了 '⁠文件://⁠’方案接受的格式(如果有)可能取決於瀏覽器和操作係統。

例子

## Not run: 
## for KDE users who want to open files in a new tab
options(browser = "kfmclient newTab")

browseURL("https://www.r-project.org")

## On Windows-only, something like
browseURL("file://d:/R/R-2.5.1/doc/html/index.html",
          browser = "C:/Program Files/Mozilla Firefox/firefox.exe")

## End(Not run)