Документация по Xamarin на сайте docs.microsoft.com
Автор записи — Крейг Данн (Craig Dunn), главный администратор программы в Xamarin.
Примечание
Это объявление опубликовано перекрестно из блога Xamarin.
Сегодня мы открываем новую главу в своем деле по предоставлению документации для разработчиков мобильных решений — теперь документация по Xamarin доступна в Интернете на странице docs.microsoft.com/xamarin. Ниже описаны некоторые новые особенности по работе с документацией:
Чтобы перейти к нужной документации со страницы docs.microsoft.com/xamarin, достаточно сделать один или два щелчка. Щелкните элемент Xamarin в заголовке, чтобы вернуться сюда с любой страницы. Используйте ссылки на вкладке "Платформа", чтобы просмотреть документы для разработчиков мобильных решений, и перейдите на вкладку Графика и игры или Инструменты, чтобы подробнее узнать о соответствующих вещах, таких как SkiaSharp, книги и Xamarin Live Player.
Сайт docs.microsoft.com предоставляет несколько новых возможностей для навигации по документации Xamarin:
- Домашняя страница "Платформа" — обзор и краткое перечисление документов, доступных для каждой платформы. Используйте ссылки в синей панели заголовка, чтобы посетить страницу каждой из платформ: Android, iOS, Mac и Xamarin.Forms.
- Поиск — значок лупы справа от заголовка обеспечивает поиск по содержимому Xamarin.
- Строка навигации — располагается под заголовком и помогает найти связанные разделы.
- Дерево навигации — представление в виде дерева обеспечивает быструю детализацию.
- Фильтр навигации — позволяет отфильтровать дерево навигации, чтобы найти заголовок раздела.
- В этой статье — каждая статья имеет оглавление, включая удобный указатель вашего расположения в документе.
- Масштабирование изображений — изображения со значком лупы в нижнем правом углу можно щелкнуть для отображения дополнительных сведений.
Презентации и занятия, проводимые специалистами по пропаганде и Xamarin University, теперь доступны во встроенном виде, как в этом разделе Xamarin.Forms Layouts:
Каждая страница содержит ссылку Изменить, позволяющую сообществу участвовать в выпуске исправлений и обновлений. Комментарии к документации становятся вопросами GitHub, чтобы вы могли отслеживать работу по вашим отзывам. Ознакомьтесь с рекомендациями по участию, где приведены инструкции по отправке изменений.
Благодаря использованию комбинации методик перевода сейчас документация по Xamarin для разработчиков доступна на 13 языках, не считая английского: китайский (упрощенное письмо), китайский (традиционное письмо), чешский, французский, итальянский, корейский, немецкий, японский, польский, португальский (Бразилия), русский, испанский и турецкий. Посетите блок по документации для получения дополнительных сведений о международных функциях.
Иногда вам требуются инструкции, касающиеся используемого редактора кода — Visual Studio 2017 или Visual Studio для Mac. Теперь они находятся на вкладках внутри каждой страницы:
Фрагменты кода выделяются с учетом синтаксиса. Кроме того, доступна кнопка Копировать, упрощающая использование фрагментов кода для приложений:
Документация по Xamarin BCL API уже доступна в браузере API .NET, а скоро будут выпущены и наши API для конкретных платформ.
Используете ли вы для чтения телефон, планшет или настольный компьютер, сайт docs.microsoft.com масштабируется для обеспечения удобочитаемости материала и доступа к функциям навигации:
Появилась возможность читать документацию с использованием темной темы.
Вы заметите, что некоторое содержимое все еще размещается на старом сайте, включая документы по API, книги и примеры. Наша команда активно работает над их переносом, чтобы обеспечить единообразную работу.
Мы с грустью прощаемся со старым сайтом developer.xamarin.com, но новые функции на сайте docs.microsoft.com/xamarin кажутся мне крайне интересными, и я надеюсь, что в будущем нам удастся создать более масштабную и удобную систему документации для разработчиков Xamarin. Вы можете поделиться своими мыслями на форумах.
P.S. Если вы добавили в заметки или опубликовали в блоге ссылки на старый сайт для разработчиков, не волнуйтесь, эти ссылки будут автоматически перенаправлять на соответствующую страницу на новом сайте.