解决方案

Wolfram Mathematica 12.1 文档中心的新内容

Wolfram语言是我们数十年来努力积累出的结晶,可以支持我们所有的产品。Wolfram语言如此易用的其中一个原因是Wolfram语言和系统文档中心的存在——它包含了成百上千个你可以即刻编辑和运行函数范例(也可以将其从网络上复制到你自己的笔记本上)。


我们最近发布了Wolfram语言的12.1版本,也增加了一些新的文档功能和页面类型。每一次发布新版本的时候,你都会发现以一种直观、用户友好的方式展现出的新功能、范例和在不同情况下的应用方法。



一、首页

文档中心的首页是按照主题排序的,展示的内容可以覆盖这个基于知识的语言的绝大部分功能。针对不同需求有三个板块的内容:Wolfram语言参考材料,以任务为导向的称为工作流程的分步解答文档,和追加的语言资源。



二、语言的新功能

在我们深入研究这些板块之前,我们首先来看看Wolfram语言的最新发布里都有哪些新内容。从首页开始有两种方法可以找到这些信息:最新功能板块和新功能脚注链接。


最新功能板块会带你访问最新添加功能导页(https://reference.wolfram.com/language/guide/RecentlyAddedFeatures),这个页面概括了Wolfram语言最近的每一次更新的资源。这个引导页包含了公告页面的链接、新函数列表和历史版本:



这个页面包括了每个发布版本的新功能导览概述页面 (https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn121)的链接——也 可以从文档中心首页的底部链接至此。这个概述页面是一个发现新功能和更新功能的好地方。12.1版本的新功能包括视频计算,机器学习方面的重大更新,地理学可视化方面的主要更新等等。


三、找到你的需求

Wolfram语言文档的主干结构是导览页面。每个导览页面都是一个层次比较松散的与主题相关的页面,包括按照对该主题重要性排序的与主题相关的函数的链接。一方面来说,导览页面是一个内容表格——是关于该主题的快速参考——但也是Wolfram语言文档网络的一个节点,在首页上用不同颜色的板块显示作为主要进入点。在主页上你还能找到更高阶的导览页面的链接,每一个这类导览页面都包含了很多到其他更具体的导览页面的链接。所有页面中,尤其是这些记录特殊函数的页面,我们都会确保用户可以无缝寻找自己所需内容。这包括了可视化差异因子,已建立的内容和一些在互联不同功能网络的情况下值得注意的用户体验选择。


四、快速访问相关内容

访问相关内容的细致且有条理的链接一直是我们的文档中心每一个板块都在贯彻的基本原则。函数的参考页面的顶部和底部有我们精心设计的相关页面的链接。在参考页面的顶部你会看到这些下拉列表的某个组合:

在下面这个截图中,你会注意到页面顶部的灰色选项条。这是我们的文档网页不变的标头。你从网页顶部往下滑的时候这个有下拉菜单的选项条就会出现,可以帮助你跳转到相关内容。

每个链接的板块都有一个设计过的小图标(在页面底部的左手边),让你可以快速通过图片进行判断。同样,相关链接也会显示Wolfram产品图标:



五、开场预览

之前版本的一个普遍的负面反馈就是,在浏览网页的时候通常很难看到那些闭合版块。现在,这些闭合版块通常会显示一个隐藏内容的截图:


这些预览来源于抓取版块内容的截图,竖直分割这些内容,并把得到的图片以行横向排列——这些操作都是由Wolfram语言完成的。


六、链接样式

你可能注意到了导览页面的链接对每个类型的参考页面都有精心设计的链接颜色。你只需要看一眼就可以知道你现在是不是在在看一个内置或打包函数、或实体类型或其他种类的参考页。系统符号链接是蓝色的,而非符号参考页是浅灰色并由引号引起:



实体页面链接也有自己的样式,有点类似于实体的小单元,鼠标悬停或者点击的时候会点亮这个链接:



其他链接样式包括打包符号(浅蓝色)和非Wolfram语言函数,比如WSTP C 语言函数(绿色):




七、工作流程

工作流程与分类的参考材料所使用的方法不同。工作流程是以任务为导向的文档,提供了任务分步解答的演示。工作流程也可用于显示包括用户界面项或其他在语言语义之外的用户操作的任务,比如外部程序设置,包括可以精确描述这些流程的截图或图表。

虽然工作流程应该是独立的文档,但是也可以按照大类话题进行分组,这就形成了工作流程导览。比如说,“在云端工作“ (https://reference.wolfram.com/language/workflowguide/WorkingInTheCloud)这个高级导览页面包括了一下了与Wolfram云互动的工作流程(和流程导览)链接。


八、Wolfram语言的资源

首页中,在每一个版块的开头你都能看见一个Wolfram资源库中相关类别的链接:


在页面底部,在资源标题的下方还有第三组链接,内容是相关的系统外文档和与Wolfram产品使用相关的一般信息。


九、网络上的易用性特点

1.反应快速,对移动端友好

我们的文档页面反应非常快速,无论你在使用什么设备,你都会得到相同的网页内容,至于字号、空格和其他不同的页面数据都会根据你使用的浏览器的窗口大小进行自适应调整。下面就是网页页面水平中断点的范例:


和别的网页不同,我们的文档页面还可以相同方式响应垂直中断点:



如果你把浏览器的窗口缩窄或缩短,在电脑窗口的边缘或上下端浏览文档页面,或者直接就是分屏浏览,我们的网页页面可以响应各种情况。


2.悬停可以预览

我们有两个新的网络功能,可以在点击网页之前预览页面的内容:首页的预览和导览页面的函数模板预览。

在首页上,将鼠标悬停在导览链接上会跳出这个导览本身的预览。该预览是交互式预览,包括相关超链接,用户可以跳过中间的导览页面,直接点击该链接跳转到参考页:


在导览页面上,将鼠标悬停在任何有页眉模板盒子的参考页的链接上,都会给出一个已记录函数样式的预览:



对网络归档文档用户而言,他们只需要Wolfram语言语义中的一个刷新功能即可。这可以与函数模板提示框类似(一个在笔记本内置功能,也是Wolfram预测界面的一部分)。


3.复制到剪贴板

在网络上查看参考页面时,你可以选择任何范例的输入并立即将该内容复制到系统剪贴板上:


在悬停效果中,还有一个提供访问该范例的锚链接的按钮(用于以后的引用参考或便于分享):


便于从网页上复制范例这一特点会比你最初设想得要更有用。不仅仅是因为这个功能可以节省你在笔记本上重新编写范例代码的时间,而且在涉及到范例中含有非文本内容时也会很有用。比如,函数ImageReseze的第一个基本范例是这样的:


这个范例中把内容原封不动复制下来了,在笔记本中粘贴的时候也会显示图片的内部线条,就像你在网页上看到的一样。

另一个有用的功能是可以复制整个使用模板,然后可以(连带占位符)粘贴进笔记本中:


像这样复制模板是Wolfram预测界面提示框中的函数和选项模板的线上模拟。

Wolfram云中的从云端便捷复制内容至笔记本上的功能尤其强大,你可以像在桌面产品中的操作一样快速计算或调整文档范例。


十、更多新内容

1.搜索功能提升

想要找到你需要的内容,一个好的搜索系统非常关键。这就是为什么我们对在产品内部和网络中搜索文档的功能做了大量优化和提升。这些提升是使用我们自己的搜索技术进行构建的。

产品内部的搜索页面与网页上的稍微有些区别,但是不管用何种方法,重点都是放在搜索内容的视觉线索或想要的页面类型上。


和别的网页不同,我们的文档页面还可以相同方式响应垂直中断点:


2.新的页面类型

通常来说,新的功能需要用特殊方法进行记录,我们开发了全新的参考页来适配这个情况。尽管这些新的页面类型会有很多差异,但是总体的设计理念还是很明显的。以下是一些在本次发布中引入的新页面类型:


产品内部的搜索页面与网页上的稍微有些区别,但是不管用何种方法,重点都是放在搜索内容的视觉线索或想要的页面类型上。

• 实体类型(AdministrativeDivision: https://reference.wolfram.com/language/ref/entity/AdministrativeDivision)
• 汇编类型(Interger8: https://reference.wolfram.com/language/ref/compiledtype/Integer8.html)
• 数据结构(DynamicArray: https://reference.wolfram.com/language/ref/datastructure/DynamicArray.html)
• 数据库连接(MySQL: https://reference.wolfram.com/language/ref/databaseconnection/MySQL.html)
• 外部评估系统(Python: https://reference.wolfram.com/language/ref/externalevaluationsystem/Python)
• 分类符(CountryFlag: https://reference.wolfram.com/language/ref/classifier/CountryFlag)
• 预测因子(NameAge: https://reference.wolfram.com/language/ref/predictor/NameAge)
• 网络编码器(Audio: https://reference.wolfram.com/language/ref/netencoder/Audio.html)
• 网络解码器(Characters: https://reference.wolfram.com/language/ref/netdecoder/Characters)
• 命令行程序(WolframScript: https://reference.wolfram.com/language/ref/program/wolframscript.html)
• 工作流程和更多


3.教程文档的发展(短论文和专著)

从12.0版本开始直到12.1版,我们一直在将教程文档重新打包成短论文和专著。专著是不随着版本的变化而改变的长论述文,是你会在教材中可能看到的深入解读某一课题的内容。而短论文则是专注在Wolfram语言给定课题的操作细节的内容。


4.Wolfram函数资源库

Wolfram函数资源库由Stephen Wolfram于去年发布,该资源库也有自己的文档页面。在未来版本中,可以在文档搜索中直接访问这些页面,并会整合进交叉索引的功能。资源库的内容可以由任何一位可以设计资源库中还没有的工具函数的用户进行创建,如果你有自定义的函数,记得访问这个页面(https://resources.wolframcloud.com/FunctionRepository/)并学习如何贡献函数吧。


十一、在文档系统中我们相信

如果用户不能找到或使用自己想要的内容,那么绝不可能算作是一个好的内容。在其他公司还在理解交互和可运行代码范例的时候,我们已经走在他们前面,我们花了三十年的时间来计算和开发这些功能。在开放资源项目不能将重要文件提供给用户的地方,Wolfram在耗费了上千小时的细致语言设计检查后可以做到这一点——而且我们的文档创建过程也直接说明了这个设计检查流程。对我们而言,这三十年来,一个文档中心是一直都是一个好的软件体验的重要组成部分。


浏览我们的文档中心(https://reference.wolfram.com/language/)并试试这些范例,这样可以学习一些新的前沿功能并发现新的内容!