名称

WolframNB — 启动 Wolfram 语言笔记本界面

概要

WolframNB

WolframNB file

说明

WolframNB 在操作系统的图形环境中启动 Wolfram 语言的笔记本界面，通常称为前端. 笔记本界面提供动态交互性和增强的图形功能，通过 WSTP 调用内核来执行计算. 它通常会打开一个可见的笔记本并启动一个 Wolfram 语言内核，尽管它也可以为已经运行的内核提供不可见的服务. WolframNB 可以编辑 Wolfram 语言笔记本 (.nb)、程序包 (.wl) 和脚本 (.wls) 文件.

选项

启动与实用选项

-cleanStart — 忽略存储的缓存并将笔记本界面偏好设置文件恢复为默认值.

-h | --help — 将简短的帮助消息输出到标准输出并退出.

-preferencesDirectory dir — 将 $UserBaseDirectory 初始化为 dir.

-pwfile file — 从 file 读取许可证密码.

-topDirectory dir — 将 $InstallationDirectory 初始化为 dir.

执行模式选项

-nogui — 启动时不显示窗口或用户界面元素.

-server — 在服务器模式下运行，这会禁用用户交互并使所有窗口不可见.

-wstp — 只通过 WSTP 通讯.

Linux 专有选项

-v | --version — 在标准输出上显示当前的版本号并退出.

--platform plat — 指定 Qt 平台抽象插件.

-noSplash | --noSplashScreen — 启动时不显示“启动画面”.

-mesa — 使用内置软件 3D 渲染器而不是系统默认的.

-sl | --singlelaunch — 每个显示器只能显示一个前端.

--stylesheet s — 指定菜单和对话使用 Qt 样式表.

Windows 专有选项

在 Windows 上，可以用类 Unix 操作系统上常见的单个前导破折号 (-) 来指定选项，也可以用 Windows 上常见的前导正斜杠 (/) 来指定 .

-gpu | -preferredgpu gpu — 将全局选项 PreferredGPU 的值初始化为 gpu.

-noSplash | -noSplashScreen — 启动时不显示“启动画面”.

更多信息

启动和关闭

前端会读取环境变量 的值并把它的值追加到任何指令行参数.

如果给出选项 -preferencesDirectory dir，它将覆盖环境变量 variable WOLFRAM_USERBASE 的值.

在 Linux 系统上，初次使用 -sl (--singlelaunch) 时，将设置前端的实例，以便后续调用 WolframNB -sl file 时打开文件. 如果在没有 -sl 的情况下调用 WolframNB，即便使用 -sl 调用的之前的前端仍在运行，也会启动新的前端.

在 macOS 系统上，在命令行上调用 WolframNB 总是会打开一个新的前端，无论另一个前端是否正在运行.

在 Windows 上，如果一个兼容的前端已经在运行，调用 WolframNB file 将在兼容的前端中打开文件，否则将在新前端中打开文件. 在没有文件名的情况下调用 WolframNB 通常会打开一个新的前端.

如果用 -pwfile 指定了密码文件，会先尝试使用其中的密码. 如果未找到有效的密码，则会尝试使用标准的系统特定位置处的密码文件.

执行模式

给出 -wstp 时，可在命令行上给出 WSOpenArgcArgv 理解的任何通用 WSTP 选项.

给出 -nogui 时，一开始任何窗口和用户界面都不可见. 在 Windows 上，系统托盘中的图标表明 WolframNB 正在运行并允许退出. 在 macOS 上，应用程序将在后台打开，但它在 Dock 中可见，并且可以正常激活. 打开一个窗口后，用户就可以正常与其交互. 其他程序通常使用此选项在前端打开文件，以尽量减少额外的混乱.

给出 -server 时，所有操作都在不可见的窗口上执行，并且不可能与用户进行交互. 菜单和其他用户界面元素将不会出现；在 macOS 上，该应用程序将是后台任务，不会出现在 Dock 中. 在服务器模式下启动时，前端通常不会启动任何内核. 通常不需要显式给出该选项，因为独立内核在需要调用 WolframNB 时会自动使用.

Linux 专有选项

默认情况下，笔记本前端会参考环境变量 XDG_SESSION_TYPE，在 X Window 系统和 Wayland 之间进行选择. 使用 -platform xcb 强制使用 X Window 系统，或通过 -platform wayland 强制使用 Wayland. 在服务器模式下运行前端时，通过指定 -platform offscreen，可在没有任何窗口系统的情况下运行.

WolramNB 通常使用物理 GPU 的 OpenGL 驱动程序来初始化基于软件的 OpenGL 3D 渲染引擎和基于硬件的引擎. -mesa 选项则会使 WolframNB 仅初始化基于软件的引擎.

Windows 专有选项

在 Windows 上，可以用类 Unix 操作系统上常见的单个前导破折号 (-) 来指定选项，也可以用 Windows 上常见的前导正斜杠 (/) 来指定.

指定 /preferredGPU Software 会使 WolframNB 使用 Windows 内置的后备适配器.

范例

基本用法

启动笔记本界面或前端：

$ WolframNB

在前端中打开一个笔记本：

$ WolframNB file.nb

启动和实用选项

启动前端，用临时的 $UserBaseDirectory 来侦错：

$ WolframNB -preferencesDirectory /tmp/clean_userbase

丢弃所有前端偏好设置和缓存数据：

$ WolframNB -cleanStart

针对平台的选项

启动前端并将 Linux 上的默认窗口系统改写为 X11：

$ WolframNB --platform xcb

启动一个前端，然后在正在运行的前端中打开一个笔记本：

$ WolframNB --singleLaunch
$ WolframNB --singleLaunch file.nb

获取当前Linux前端的版本并退出：

$ WolframNB --version

{RelatedLinks-NeuralNetRepository.png}

在 Windows 或 Linux 上，启动前端而不显示启动画面：

$ WolframNB -nosplash

在 Linux 上执行相同的操作，使用选项的长名称：

$ WolframNB --noSplashScreen

在 Windows 上执行相同的操作，用 Windows 的方式指定选项：

> WolframNB /noSplashScreen

使用 Windows 内置的后备适配器来代替物理显卡进行显示：

> WolframNB /preferredGPU Software

文件

用户初始化文件的位置：

	$BaseDirectory/Kernel/init.m
	$UserBaseDirectory/Kernel/init.m

密码文件的位置：

	$BaseDirectory/Licensing/mathpass
	$UserBaseDirectory/Licensing/mathpass
	$InstallationDirectory/Configuration/Licensing/mathpass

WOLFRAM 语言变量

$FrontEnd — 内核所连接的 WolframNB 进程的符号表示.

$FrontEndSession — 当前前端会话的符号表示.

环境变量

WOLFRAMNB_INIT — 每次调用 WolframNB 时附加的参数.

WOLFRAM_BASE — $BaseDirectory 使用的路径值.

WOLFRAM_USERBASE — $UserBaseDirectory 使用的路径值.