Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


Dokumentacja platformy Xamarin jest teraz dostępna w witrynie docs.microsoft.com

Ten wpis zapisał napisany przez Craiga Dunna, głównego menedżera programu na platformie Xamarin.

Uwaga

Ten anons jest wpisem pochodzącym z blogu dotyczącego środowiska Xamarin.

Dzisiaj zaczynamy nowy rozdział w dokumentacji dla deweloperów mobilnych — dokumentacja platformy Xamarin jest teraz aktywna na docs.microsoft.com/xamarin! Oto niektóre z najważniejszych funkcji nowego środowiska dokumentacji:

Centrum dokumentacji środowiska Xamarin

Wszystkie opcje dotyczące naszej dokumentacji są dostępne z poziomu witryny docs.microsoft.com/xamarin. Kliknij pozycję Xamarin w nagłówku, aby wrócić tutaj z dowolnej strony. Użyj linków do platform, aby zobaczyć naszą dokumentację dla deweloperów aplikacji mobilnych. Karty Grafika i gry oraz Narzędzia zawierają informacje o tematach pokrewnych, takich jak SkiaSharp, Workbooks i Xamarin Live Player.

Centrum platformy Xamarin w witrynie docs.microsoft.com

Nowa nawigacja

Witryna docs.microsoft.com oferuje niektóre nowe opcje do nawigowania po dokumentacji platformy Xamarin:

Strona dokumentacji platformy Xamarin w witrynie docs.microsoft.com

  1. Strona główna platformy — omówienie i krótki opis dokumentacji dostępnej dla poszczególnych platform. Użyj linków na niebieskim pasku nagłówka, aby odwiedzić stronę odpowiedniej platformy: Android, iOS, Mac lub Xamarin.Forms.
  2. Wyszukiwanie — kliknij przycisk lupy w prawym rogu nagłówka, aby wyszukać zawartość dotyczącą platformy Xamarin.
  3. Obszar nawigacji — poniżej nagłówka znajduje się obszar nawigacji ułatwiający znalezienie odpowiednich dokumentów.
  4. Drzewo nawigacji — szybko przechodź do szczegółów, korzystając z widoku drzewa.
  5. Filtr nawigacji — filtruj drzewo nawigacji, aby znaleźć nagłówek tematu.
  6. W tym artykule — każdy artykuł zawiera wygenerowany spis treści ze wskaźnikiem lokalizacji przydatnym podczas przewijania dokumentu.
  7. Powiększenie obrazu — obrazy z ikoną lupy w prawym dolnym rogu można kliknąć, aby wyświetlić więcej szczegółów.

Wideo

Prezentacje i lekcje pochodzące od propagatorów oraz z platformy Xamarin University są teraz dostępne w tekście, na przykład w temacie Układy platformy Xamarin.Forms:

Wideo zintegrowane ze stroną dokumentacji w witrynie docs.microsoft.com

Oprogramowanie open source

Na każdej stronie znajduje się link Edytuj umożliwiający członkom społeczności umieszczanie poprawek i aktualizacji. Komentarze dotyczące dokumentów stają się problemami w usłudze GitHub, dzięki czemu można śledzić postęp przetwarzania opinii o dokumentacji. Przeczytaj wytyczne dotyczące zamieszczania treści, aby uzyskać instrukcje przesyłania zmian.

W Twoim języku

Dzięki wykorzystaniu kombinacji różnych metod tłumaczenia dokumentacja dla deweloperów platformy Xamarin jest teraz dostępna w 13 językach (oprócz języka angielskiego): chińskim (uproszczonym), chińskim (tradycyjnym), czeskim, francuskim, włoskim, koreańskim, niemieckim, japońskim, polskim, portugalskim (Brazylia), rosyjskim, hiszpańskim i tureckim. Odwiedź blog dotyczący dokumentacji, aby uzyskać więcej informacji na temat funkcji międzynarodowych.

Przełącznik edytora

Czasami przydatne mogą się okazać instrukcje specyficzne dla określonego edytora kodu — programu Visual Studio 2017 lub Visual Studio dla komputerów Mac. Znajdują się one teraz na kartach na poszczególnych stronach:

Karty z koncepcyjną zawartością w witrynie docs.microsoft.com

Doskonały kod

Fragmenty kodu są wyróżnione składnią i jest dostępny przycisk Kopiuj , który ułatwia pobieranie fragmentów kodu dla aplikacji:

Fragmenty kodu w witrynie docs.microsoft.com

Przeglądarka interfejsu API

Dokumentacja interfejsu API BCL platformy Xamarin jest już dostępna w przeglądarce interfejsu API platformy .NET, a wkrótce dostępne też będą interfejsy API specyficzne dla platform.

Elastyczne środowisko

Niezależnie od tego, czy czytasz na telefonie, tablecie, czy na pulpicie, witryna docs.microsoft.com skaluje się, aby upewnić się, że zawartość jest jasna i łatwa do odczytania, przy jednoczesnym zachowaniu dostępnej nawigacji:

Elastyczny układ w witrynie docs.microsoft.com

Motyw ciemny

Istnieje nawet opcja przeczytania dokumentacji z motywem ciemnym!

Ciemny motyw w witrynie docs.microsoft.com

Co dalej?

Zauważysz, że część zawartości jest nadal hostowana w naszej starej witrynie, w tym dokumentacji interfejsu API, skoroszytów i przykładów. Członkowie zespołu ciężko pracują nad zmigrowaniem tych elementów i utworzeniem ujednoliconego środowiska.

To z ciężkim sercem, że pożegnamy się z naszą starą witryną w developer.xamarin.com, ale jestem podekscytowany nowymi funkcjami dostępnymi na docs.microsoft.com/xamarin i czekamy na utworzenie jeszcze większego, lepszego środowiska dokumentacji dla deweloperów platformy Xamarin. Daj nam znać na forach, co o tym myślisz.

P.S.: Jeśli masz linki do zakładek lub blogowane do starej witryny dewelopera, nie martw się: zostaną one automatycznie przekierowane do równoważnej strony w nowej witrynie!