Aracılığıyla paylaş


Wiki içeriğini çevrimdışı kopyalama ve güncelleştirme

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Wiki'yi çevrimdışı güncelleştirme işlemi, Git deposunda kod geliştirme işlemiyle aynıdır. Wiki sayfalarınızı çevrimdışı olarak güncelleştirmek için tercih ettiğiniz istemciyi ve git komut satırı araçlarını kullanabilirsiniz. Git depolarıyla ve desteklenen araçlarla çalışma hakkında ayrıntılı bilgi için Bkz. Azure Repos Git Belgeleri.

Wiki içeriğini çevrimdışı güncelleştirmenin temel adımları şunlardır:

  1. Wiki Git deponuzu yerel etkileşimli geliştirme ortamınıza (IDE) veya çalışma alanınıza kopyalayın.

  2. Yerel Git depo dalınıza dosya veya klasör ekleyin.

  3. .order dosyalarını sayfalar ve alt sayfalar için sıra değişikliklerini yansıtacak şekilde güncelleyin.

  4. Güncelleştirmeleri işleyin ve yerel Git dalınıza gönderin.

Önkoşullar

Kategori Gereksinimler
Proje erişimi Wiki'lerin bulunduğu projenin üyesi. Gerektiğinde Proje Yöneticinizden erişim isteyebilirsiniz.
İzinler - Katkıda Bulunanlar grubunun üyesi.
- Kodu wiki olarak yayımlamak için Depo Oluştur izni. Varsayılan olarak, bu izin Proje Yöneticileri grubunun üyeleri için ayarlanır.
Erişim Düzeyleri En azında düzeyinde Temel erişimi.
görevleri - Wiki Git deponuzun temel yapısını anlama.
- Sağlanan wiki ile wiki olarak yayımlanan kod arasındaki farkları anlayın.

Wiki'nizi kopyalama

Wiki deponuz sayfaları, resimleri, ekleri ve sayfaların ve alt sayfaların sırasını depolar. Başlamak için wiki'nizi klonla.

  1. Projenize oturum açın (https://dev.azure.com/<Organization>/<Project>).

  2. Viki'nizi ve ardından Diğer eylemler (...) > öğesini seçin Viki'yi kopyala:

    Seçili wiki için Daha fazla seçenek menüsünden Wiki Git klonlama eyleminin nasıl seçileceğini gösteren ekran görüntüsü.

  3. Depoyu kopyala iletişim kutusunda Kopya URL'sini panoya kopyala simgesini seçin:

    Klonlama iletişim kutusunda klonlanacak wiki deposunu gösteren ekran görüntüsü.

  4. URL'yi tarayıcınıza yapıştırın. WikiMain dalı altında tanımlanan dosyaları görüntüleyebileceğiniz Git deposu sayfası açılır. Aşağıdaki örnekte CanaryBuilds projesi için Git deposundaki dosyalar gösterilmektedir:

    wikiMain dalı altında tanımlanan dosyaların bulunduğu Git deposu sayfasını gösteren ekran görüntüsü.

    Önemli

    Git Kimlik Bilgileri Oluştur özelliğinin kaldırılması planlanıyor. Git kopyalama işlemleri için kullanabileceğiniz tüm kimlik doğrulama yöntemleri için Git Kimlik Doğrulaması belgelerini gözden geçirin.

  5. Depoyu tercih ettiğiniz IDE'de kopyalamak için kopyaladığınız URL'yi kullanın. Daha fazla bilgi için aşağıdaki makalelere bakın:

Yerel Git deponuza sayfa ekleme

Git deposu sayfaları Markdown (.md) dosyaları olarak biçimlendirilir. Wiki'nize eklemek istediğiniz her sayfa için yerel dalınızda bir Markdown dosyası oluşturursunuz. Sayfaları ekledikten sonra sayfa sırasını yeni sayfaları içerecek şekilde ayarlamak için .order dosyasını güncelleştirirsiniz.

Sayfa ekleme

Wiki yapısının en üstüne kök (\) klasörüne ve diğer klasörlere sayfalar ekleyebilirsiniz.

  1. Yeni sayfanın içeriğiyle Markdown (.md) dosyasını oluşturun. Çoğu durumda, dosya adı sayfa başlığıyla eşleşir. Dosya adında, başlıktaki boşlukları kısa çizgi (-) ile değiştirin. Sayfa içeriği oluşturma hakkında daha fazla bilgi için bkz. Wiki sayfası ekleme.

  2. Dosyayı, kök klasör gibi yerel dalınızın wiki yapısı içinde istenen klasöre yerleştirin. CanaryBuilds proje örneği kök klasörü:C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

    CanaryBuilds projesi için wiki Git deposunun yerel dalını gösteren ekran görüntüsü.

  3. Yeni sayfa dosyasını yerleştirdiğiniz klasördeki .order dosyasını güncelleştirin. Sayfanın giriş metni, Markdown uzantısı (.md) olmayan dosya adıdır. CanaryBuilds proje örneği, Nasıl katkıda bulunulur giriş metnine karşılık gelen yeni " Katkıda bulunma" sayfasını ekler:

    Welcome
    Roadmap  
    How-to-contribute  
    Home  
    Reference  
    

    .order dosyası hakkında daha fazla bilgi için bkz. Sayfa dizisi ve .order dosyası.

Alt sayfa ekleme

Wiki'nizdeki bir sayfa için alt sayfalar da oluşturabilirsiniz:

  1. Üst sayfa görevi görecek bir klasör oluşturun. Daha fazla bilgi için bkz. Depo dosyaları ve klasör yapısı.

  2. Her alt sayfa için Markdown dosyasını oluşturun ve dosyayı üst sayfa klasörüne yerleştirin. CanaryBuilds proje örneği, Katkıda bulunma yöntemi klasörünü üst sayfa olarak ekler:

    CanaryBuilds projesinde yeni alt sayfalara sahip Katkıda bulunma klasörünü gösteren ekran görüntüsü.

  3. Alt sayfaların sırasını wiki'de görüntülemeleri gerektiği gibi tanımlamak için üst sayfa klasöründe bir .order dosyası oluşturun. Örnek, olası bir alt sayfa sırasını gösterir:

    Request-extensions  
    Licensing  
    Smoke-test  
    Coding-guidelines  
    

Değişikliklerinizi gönderme

Yerel güncelleştirmeleriniz hazır olduğunda , dosyaları Git deposuna gönderin.

Eklenen sayfalar ve alt sayfalar wiki'nizde hemen görünür. Aşağıdaki örnekte CanaryBuilds projesinin güncelleştirmeleri gösterilmektedir:

CanaryBuilds projesi için güncelleştirilmiş wiki yapısını gösteren ekran görüntüsü.

İşlemde herhangi bir hata varsa, sayfa wiki dosya listenizde Uyarı simgesiyle görüntülenir:

Uyarı simgesinde gösterildiği gibi hata içeren bir sayfayı gösteren ekran görüntüsü.