docs.microsoft.com 现提供 Xamarin 文档

本文作者为Craig Dunn,Xamarin 首席项目经理。

注意

此公告同时发布在 Xamarin 博客中

今天,我们将开启移动开发人员文档的新篇章 - 现在,docs.microsoft.com/xamarin 上提供了 Xamarin 文档! 新文档体验有以下亮点:

Xamarin 文档中心

docs.microsoft.com/xamarin,经过一两次单击即可访问所有文档选项。 从任意页面单击标题中的 Xamarin 可返回此处。 使用平台链接查看我们的移动开发人员文档,并切换到“图形和游戏”或“工具”选项卡,以详细了解 SkiaSharp、工作簿和 Xamarin Live Player 等相关主题。

docs.microsoft.com 上的 Xamarin 中心

新导航

docs.microsoft.com 提供导航 Xamarin 文档的新选项:

docs.microsoft.com 上的 Xamarin 文档页面

  1. 平台主页 - 每个平台上所提供文档的概述和快速参考。 使用蓝色标题栏中的链接访问每个平台页面:AndroidiOSMacXamarin.Forms
  2. 搜索 - 单击标题右侧的放大镜以搜索 Xamarin 内容。
  3. 痕迹导航 - 痕迹导航收纳在标题下方,可帮助查找相关文档。
  4. 导航树 - 使用树视图快速向下钻取。
  5. 导航筛选器 - 筛选导航树以查找主题标题。
  6. 本文内容 - 每篇文章都生成了目录,包括方便指示器,可指示在文档中的滚动位置。
  7. 图像缩放 - 对于右下角带有放大镜图标的图像,可单击放大镜以显示详细信息。

视频

现在以内联方式显示宣传员和 Xamarin 大学提供的演示文稿和课程,例如这一 Xamarin.Forms 布局主题:

docs.microsoft.com 文档页面中集成的视频

开放源

每页都包含“编辑”链接,方便社区成员参与订正和更新。 对文档的注释会成为 GitHub 问题,因此可以跟踪文档反馈的进度。 请参阅投稿准则,了解有关提交更改的说明。

以你的语言提供

使用翻译技术组合,除英语外,Xamarin 开发人员文档现更以 13 种语言提供:中文(简体)、中文(繁体)、捷克语、法语、意大利语、朝鲜语、德语、日语、波兰语、葡萄牙语(巴西)、俄语、西班牙语和土耳其语。 请访问文档博客详细了解国际化功能。

编辑器切换器

有时,你会需要特定于代码编辑器(Visual Studio 2017 或 Visual Studio for Mac)的说明。 现在,每个页面中的选项卡内都提供这些说明:

docs.microsoft.com 上概念性内容中的选项卡

美观代码

代码片段进行了语法突出显示,且包含“复制”按钮,可以轻松复制适用于你的应用的代码片段:

Docs.microsoft.com 上的代码片段

API 浏览器

现已可通过 .NET API 浏览器查看 Xamarin BCL API 文档,即将推出特定于平台的 API。

响应式设计

无论是在手机、平板电脑还是台式机上阅读,docs.microsoft.com 站点都会进行缩放,确保内容清晰且方便阅读,且导航始终易于访问:

docs.microsoft.com 上的响应式设计

深色主题

还可选择使用深色主题阅读文档!

docs.microsoft.com 上的深色主题

接下来该做什么?

可以注意到,某些内容(包括 API 文档、工作簿和示例)仍位于旧站点上。 我们的团队正在努力完成迁移,以打造统一的体验。

我们怀着沉重的心情与旧站点 developer.xamarin.com 道别,但我个人对于 docs.microsoft.com/xamarin 上提供的新增功能也感到很兴奋,并期待为 Xamarin 开发人员提供更完善、更优秀的文档体验。 在论坛中将你的想法告诉我们。

注:如果你已将旧开发人员网站的链接加入书签或发布到博客,请不要担心:它们将自动重定向到新站点上的等效页!