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:
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.
Witryna docs.microsoft.com oferuje niektóre nowe opcje do nawigowania po dokumentacji platformy Xamarin:
- 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.
- Wyszukiwanie — kliknij przycisk lupy w prawym rogu nagłówka, aby wyszukać zawartość dotyczącą platformy Xamarin.
- Obszar nawigacji — poniżej nagłówka znajduje się obszar nawigacji ułatwiający znalezienie odpowiednich dokumentów.
- Drzewo nawigacji — szybko przechodź do szczegółów, korzystając z widoku drzewa.
- Filtr nawigacji — filtruj drzewo nawigacji, aby znaleźć nagłówek tematu.
- W tym artykule — każdy artykuł zawiera wygenerowany spis treści ze wskaźnikiem lokalizacji przydatnym podczas przewijania dokumentu.
- Powiększenie obrazu — obrazy z ikoną lupy w prawym dolnym rogu można kliknąć, aby wyświetlić więcej szczegółów.
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:
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.
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.
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:
Fragmenty kodu są wyróżnione składnią i jest dostępny przycisk Kopiuj , który ułatwia pobieranie fragmentów kodu dla aplikacji:
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.
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:
Istnieje nawet opcja przeczytania dokumentacji z motywem ciemnym!
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!