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

  • Makale

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

Wiki sayfalarınızı, Git deposunda kodlama yaparken olduğu gibi çevrimdışı olarak güncelleştirebilirsiniz.

Wiki'nizi çevrimdışı güncelleştirmek için istediğiniz herhangi bir istemciyi veya git komut satırı araçlarını kullanabilirsiniz. Git depoları ve desteklenen araçlarla çalışma hakkında ayrıntılı bilgi için bkz. Git Depoları.

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

  1. Wiki Git deponuzu yerel IDE'nize veya çalışma alanınıza kopyalayın.
  2. Yerel git dalınıza dosya veya klasör ekleyin.
  3. .order dosyalarını sayfalarınızı ve alt sayfalarınızı yansıtacak şekilde güncelleştirin.
  4. Yaptığınız güncelleştirmeleri işleyin ve yerel git dalınıza gönderin.

Önkoşullar

Markdown sayfalarını başka bir wiki'den ekip projesi wiki'nize veya bir wiki'de kod olarak yayımladığınız içeriğe geçirmek için aşağıdaki adımları uygulayı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. Projenizde (https://dev.azure.com/{Your_Organization/Your_Project}) oturum açın ve wiki'nizi seçin.

  2. Diğer eylemler bağlam menüsünü açın ve Wiki'yi kopyala'yı seçin.

    Wiki Git deposunu kopyalama

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

    Wiki url'sini kopyalama

    wikiMaster dalı altında tanımlanan dosyaları görüntülemek için tarayıcınıza girin.

    Wiki ana dosyaları

  4. Kullandığınız IDE'deki depoyu kopyalamak için kopyaladığınız URL'yi kullanın. Daha fazla bilgi edinmek için aşağıdaki makalelerden birine bakın:

Yerel Git deponuza sayfa ekleme

Markdown biçimini kullanarak sayfalar yazarız. Wiki'nize eklemek istediğiniz her sayfa ve alt sayfa için yerel dalınıza bir Markdown dosyası ekleyin.

Sayfa ekleme

Wiki ağacının köküne sayfa eklemek için Git deposunun köküne bir Markdown dosyası ekleyin.

  1. Eklemek istediğiniz her sayfa için, sayfa içeriğini içeren bir Markdown dosyası oluşturun ve deponuzun kök klasörünün altına ekleyin.

    CanaryBuilds ekip projesi aşağıdaki klasördedir:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Wiki ağacının köküne sayfa eklemek için Git deposunun kökündeki her sayfa için bir Markdown dosyası ekleyin.

    Yerel dal wiki Git deposu

  3. Köke eklemek istediğiniz tüm sayfaları ekledikten sonra kökte .order dosyasını güncelleştirin. Kökte tanımlanan her Markdown dosyası için bir girdisi olmalıdır. Her girdi, boşluklar tireyle değiştirilen dosya başlığıyla eşleşmelidir.

    Örneğin:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Alt sayfa ekleme

  1. Üst sayfa için bir klasör oluşturun ve ardından klasördeki her alt sayfa için Markdown dosyaları ekleyin.

    Örneğin, aşağıdaki dosyaları Katkıda bulunma klasörüne ekledik. Bu alt sayfalar wiki'deki Katkıda bulunma sayfası altında görünür.

    Alt sayfaların ekran görüntüsü.

  2. Wiki'de görünmeleri gereken alt sayfaların sırasını içeren klasöre bir .order dosyası ekleyin. Sayfaları sıralamak için .order dosyasının kullanımını anlamak için bkz. Wiki Git depo dosyaları ve dosya yapısı.

    Örneğin, dosya aşağıdaki alt sayfalara sahiptir:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Değişikliklerinizi gönderme

Tüm güncelleştirmelerinizi tamamladığınızda, dosyaları Git deposuna gönderin.

Eklenen sayfalar ve alt sayfalar wiki'nizde hemen görünür.

Wiki ağacı güncelleştirildi

İşlemde herhangi bir hata varsa, sayfalar wiki'nizde bir uyarı işaretiyle gösterilir.

.order dosyası düzgün güncelleştirilmezse uyarı.