Olvasás angol nyelven

Megosztás a következőn keresztül:


A Xamarin dokumentációja már elérhető a docs.microsoft.com webhelyen

Ezt a bejegyzést Craig Dunn, a Xamarin fő programmenedzsere írta.

Megjegyzés

Ez a közleményt a Xamarin blogjáról vettük át.

Ma egy új fejezetet kezdünk a mobilfejlesztői dokumentációban – A Xamarin-dokumentumok mostantól docs.microsoft.com/xamarin! Íme néhány részlet a dokumentáció új felhasználói élményéről:

Xamarin Docs Hub

A docs.microsoft.com/xamarin webhelyről minden dokumentációs lehetőségünk néhány kattintással elérhető. Ha a fejlécben lévő Xamarin szóra kattint, bármelyik oldalról visszatérhet ide. A platformhivatkozásokkal megtekintheti mobilfejlesztői dokumentációinkat, és átválthat a Grafika és játékok vagy az Eszközök lapra, ahol további információt talál a kapcsolódó témakörökről, például a SkiaSharpról, a Workbooksról és a Xamarin Live Playerről.

Xamarin-központ a docs.microsoft.com webhelyen

Új navigáció

A docs.microsoft.com új lehetőségeket kínál a Xamarin dokumentációjában való navigáláshoz:

Xamarin dokumentációs oldal a docs.microsoft.com webhelyen

  1. Platformok kezdőlapjai – Áttekintés és rövid összefoglaló az egyes platformokon elérhető dokumentációról. Az egyes platformok oldalát a kék fejlécen szereplő hivatkozásokkal látogathatja meg: Android, iOS, Mac és Xamarin.Forms.
  2. Keresés – Xamarin-tartalmak kereséséhez kattintson a fejléc jobb oldalán található nagyító ikonra.
  3. Webhely-navigációs eszközök – A fejléc alatt található webhely-navigációs eszközök segítséget nyújtanak a kapcsolódó dokumentumok megkereséséhez.
  4. Navigációs fa – Gyors leásás a fanézetben.
  5. Navigációs szűrő – A navigációs fa szűrése a kívánt témakör fejlécének kereséséhez.
  6. A cikk tartalma – Minden cikk rendelkezik tartalomjegyzékkel, amely azt is jelzi, hogy éppen a dokumentum melyik részét látja.
  7. Képek nagyítása – A jobb alsó sarokban nagyítót ábrázoló ikonnal ellátott képek részletesebben megtekinthetők, ha rájuk kattint.

Videó

A szakértők és a Xamarin University előadóinak bemutatói és leckéi már beágyazva is elérhetők, mint például ez a Xamarin.Forms-elrendezésekkel foglalkozó témakör:

Integrált videó egy docs.microsoft.com dokumentációs oldalon

Nyílt forráskód

Minden oldal tartalmaz egy Szerkesztés hivatkozást, így a közösség javításokat és frissítéseket is végrehajthat. A dokumentumokhoz fűzött megjegyzések a visszajelzések követése érdekében GitHub-problémákká alakulnak át. A módosítások elküldéséről a hozzájárulási irányelvekben talál útmutatást.

Az Ön nyelvén

A Xamarin fejlesztői dokumentációja a különböző fordítási technikák kombinációjának köszönhetően az angol mellett jelenleg 13 nyelven érhető el: kínai (egyszerűsített), kínai (hagyományos), cseh, francia, olasz, koreai, német, japán, lengyel, portugál (brazíliai) orosz, spanyol és török. A nemzetközi funkciókról a Docs-blogban talál további információt.

Szerkesztőválasztó

Előfordulhat, hogy pontosan az Ön által használt kódszerkesztőhöz írt útmutatásra van szüksége, legyen az Visual Studio 2017 vagy Visual Studio for Mac. Ezek az utasítások mostantól minden oldalon külön lapon találhatók:

Fogalmi tartalmak lapjai a docs.microsoft.com-on

Esztétikus kódok

A kódrészletek szintaxiskiemeléssel vannak kiemelve, és van egy Másolás gomb, amely megkönnyíti a kódrészletek használatát az alkalmazásokhoz:

Kódrészletek a docs.microsoft.com-on

API-tallózó

A Xamarin BCL API-dokumentumok már elérhetők a .NET API-tallózóban, és hamarosan a platformspecifikus API-k is megjelennek.

Rugalmas kialakítás

Akár telefonján, táblagépén, akár asztali számítógépén olvas, a docs.microsoft.com webhely méretezhető, hogy a tartalom világos és könnyen olvasható legyen, miközben a navigáció elérhető marad:

A docs.microsoft.com rugalmas kialakítása

Sötét téma

A sötét témát tartalmazó dokumentumok olvasására is lehetőség van!

A docs.microsoft.com sötét témája

A következő lépések

Látni fogja, hogy bizonyos tartalmak továbbra is a régi webhelyen vannak tárolva, beleértve az API-dokumentumokat, a munkafüzeteket és a mintákat. Csapatunk keményen dolgozik azon, hogy ezen tartalmak migrálásával egységes felhasználói élményt biztosítsunk.

Nehéz szívvel búcsút mondunk a régi webhelyünknek developer.xamarin.com, de izgatott vagyok a docs.microsoft.com/xamarin elérhető új funkciók miatt, és alig várom, hogy még nagyobb, jobb dokumentációs élményt építsünk a Xamarin-fejlesztők számára. Ossza meg velünk a véleményét a fórumon.

P.S.: Ha a régi fejlesztői webhelyre mutató könyvjelzős vagy blogged hivatkozásokat tartalmaz, ne aggódjon: a rendszer automatikusan átirányítja őket az új webhely megfelelő lapjára!