宣布新的打字网站

2020-08-05 23:09:20

大家好,我很高兴地宣布,TypeScript网站的下一代版本已经在tyescriptlang.org上推出了。

新版本的网站是出于一种愿望,即用适合现代微软风格的设计,让Tyescript的文档感觉像它的类型系统一样宽泛。

为了了解人们想要什么,我们联系了社区,询问他们希望在哪里看到改进,并根据反馈制定了路线图。

让我们来看看这些要点,并了解一下新的打字网站是如何解决这些问题的。

我们在6年前就决定了打字稿主页的设计和文案,但从那以后事情发生了很大的变化。TypeScript已经成长起来,并且了解它想要成为什么:JavaScript之上的一个提供强大工具支持的类型层。

这一重点意味着解释团队如何使用JavaScript标准体,描述DefinitelyTyped如何允许TypeScript向非类型库提供类型,以及教导采用TypeScript不一定是一个全有或全无的选择。

希望新的主页能让我们更容易理解TypeScript在JavaScript生态系统中的位置。

此外,重新设计的个人亮点是新的打字标识,它更贴近地反映了人们在野外使用的东西:

完全拆分移动站点导航与桌面站点导航,以便他们更专注于自己的域。

将游乐场的代码示例与现有文档交织在一起,使得与想法的交互变得容易,而不仅仅是被动地阅读。

网站地图已经过修改(没有中断任何链接),以允许更多的文档部分,新的网站地图为文档提供了更具层次性的方法,这将使您更容易快速找到您正在查找的内容。

在过去的一年里,游乐场突飞猛进-你可以在即将发布的帖子中找到TypeScript的交互式代码资源管理器的所有功能和更改。

这本新手册有不同的结构。以前的手册是网站的一个单独部分,新网站有更多的文档页面,并将手册分为三个主要部分:

打字入门-帮助您理解基于不同背景的语言。

手册-阅读打字稿中的内容,以更好地理解这门语言

这种分割在开始学习Tyescript时特别有用,因为它提供了一个集中学习的轨道。然后,由于您需要特定的技术,有更深入地探讨主题的参考文档。

我们正在移动越来越多的代码样本,以使用一种名为twoslash的新打字标记格式。两个loslash代码示例使用TypeScript编译器生成准确的错误消息,获取编译器输出,并查询悬停工具提示以获取快速信息。然后可以将此信息呈现在代码示例的静态页面中。

使用此技术,我们可以确保在使用TypeScript编译器时,我们的代码示例保持准确和最新。

需要改进的最大领域之一是我们收集了100多个编译器标志的文档。新的TypeScript网站为每个标志都提供了详细的描述,并且示例都是由编译器支持的。这意味着我们可以确保示例准确地显示了更改特定配置时发生的情况。

新网站从第一天起就考虑到了可访问性。为了让您对支持列表有个了解,下面是我们对每个页面的说明:

任何人都可以学习编程,但是要想掌握一门编程语言,需要增加精通英语的额外障碍,这是一个令人担忧的问题。我们是一个小型的编译团队,并希望提供基础设施,使其他人能够本地化我们的网站。新网站的每个部分都考虑到了多语言支持。

我们已经在中文、日文、葡萄牙文和西班牙文的翻译方面取得了很大进展-你可以通过GitHub的这些问题看到它们的进展情况。如果你有兴趣帮忙,来打招呼吧,请在“打字社区不和谐”一栏中打个招呼。

这个新网站是在整整一年前开始的,到这里来已经提交了1600多条信息,并收到了100多人的贡献。你可以在GitHub的网络基础设施更新中阅读更多关于网站是如何设计和架构的动机。

尽管如此,我们始终对反馈持开放态度,现在每个人都可以提供一些新的观点,因此有很大的改进空间。