Belgeler için yerel git deposu ayarlama

Bu makalede, Microsoft belgelerine katkıda bulunmak amacıyla yerel makinenizde bir Git deposu ayarlama adımları açıklanır. Katkıda bulunanlar yerel olarak kopyalanmış depoyu kullanarak yeni makaleler ekleyebilir, mevcut makalelerde büyük düzenlemeler yapabilir veya resimleri değiştirebilirler.

Katkıda bulunmaya başlamak için şu tek seferlik kurulum etkinliklerini çalıştıracaksınız:

• Uygun depoyu belirleyin.
• Deponun çatalını GitHub hesabınıza oluşturun.
• Kopyalanan dosyalar için yerel bir klasör seçin.
• Depoyu yerel makinenize kopyalayın.
• Yukarı akış uzak değerini yapılandırın.

Önemli

Yalnızca küçük değişiklikler yapıyorsanız, bu makaledeki adımları tamamlamanız gerekmez . Herhangi bir araç yüklemeden hızlı düzenlemeler yapmayı öğrenmek için bkz . Tarayıcıda düzenleme.

Genel bakış

Microsoft Learn belgelerine katkıda bulunmak için ilgili belge deposunu kopyalayarak Markdown dosyalarını yerel olarak oluşturabilir ve düzenleyebilirsiniz. Microsoft, önerilen değişikliklerinizi depolamak için okuma/yazma izinlerine sahip olmak için uygun depoyu kendi GitHub hesabınıza çatal oluşturmanızı gerektirir. Ardından, değişiklikleri salt okunur merkezi paylaşılan depoda birleştirmek için çekme isteklerini (PR) kullanırsınız.

Microsoft deposu yukarı akış deposu olarak adlandırılır. Kullanıcı, GitHub kullanıcı arabirimindeki çatal eylemini kullanarak Microsoft deposunu kendi GitHub hesabına çatallar. Bu çatala Kaynak denir. Kullanıcı git clone kullanarak Origin'i kendi yerel makinesine klonlar. Son olarak kullanıcı, yerel kopyalarını Microsoft yukarı akış deposuna geri bağlamak için git uzaktan ekleme yukarı akışını kullanır.

Depoyu belirleme

Microsoft Learn'de barındırılan belgeler GitHub'daki çeşitli depolarda yer alır.

1. Bir makalenin hangi depoda bulunduğundan emin değilseniz web tarayıcınızı kullanarak makaleyi ziyaret edin. Makalenin sağ üst köşesindeki Düzenle bağlantısını (kalem simgesi) seçin.

   

2. Bu eylem sizi GitHub'da kaynak dosyaya götürür. Depo adı, sayfanın sol üst köşesinde görüntülenir.

   

   Genel katkılar için kullanılabilen bazı popüler depolar şunlardır:

   • Microsoft Learn Topluluk İçeriği https://github.com/MicrosoftDocs/community-content/
   • Azure belgeleri https://github.com/MicrosoftDocs/azure-docs
   • SQL Server belgeleri https://github.com/MicrosoftDocs/sql-docs
   • Visual Studio belgeleri https://github.com/MicrosoftDocs/visualstudio-docs
   • .NET Belgeleri https://github.com/dotnet/docs
   • Azure .NET SDK belgeleri https://github.com/azure/azure-docs-sdk-dotnet
   • ConfigMgr belgeleri https://github.com/MicrosoftDocs/SCCMdocs

Depo çatalı oluşturma

Doğru depoyu belirledikten sonra, bir sonraki adım depoyu kendi GitHub hesabınıza çatal haline getirmektir.

Depo çatalı oluşturmak, GitHub hesabınızda deponun bir kopyasını oluşturmak anlamına gelir. Tüm Microsoft belge depoları salt okunur erişim sağladığından, ancak çatalınız değişikliklerinizi yapmak için yazma erişimi sağladığından kişisel bir çatal gereklidir. Çatal, pr'leri çatalınızdan Microsoft deposuna açmanıza olanak tanır.

1. Ana deponun GitHub sayfasından sağ üst köşedeki Çatal düğmesini seçin.

   

2. Yeni çatal oluştur ekranında Sahip'in kullanıcı adınız olarak ayarlandığından ve Yalnızca ana dalı kopyala seçeneğinin işaretli olduğundan emin olun. İsteğe bağlı olarak, Depo adı ve Açıklama alanlarını değiştirin.

   

Depoyu kopyalama

Clone , yerel makinenizde bir deponun kopyasını oluşturmak anlamına gelir.

Uyarı

1. Yerel depoları OneDrive ile eşitlenmiş klasörlere KOPYALAMAYIN. Depoyu kopyaladığınız klasörü seçerken, OneDrive ile eşitlenen klasörlerden (örneğin, Belgeler klasörünüz) kaçının. OneDrive, değişikliklerinizi ana dala geri birleştirdiğinizde istenmeyen birleştirme çakışmalarına neden olabilir. Bunun yerine, sürücünüzde C:\ kısa bir dosya yolu (örneğin, C:\GitHub) oluşturmak en iyisidir.

2. Windows üzerinde Git: Uzun yol adlarını etkinleştirin. Varsayılan olarak, Windows için Git, hedef yolu 255 karakterden uzun olan tüm dosyaları kopyalanmasını önleyen uzun dosya yolları desteğini devre dışı bırakır. Yönetici olarak aşağıdaki komutu çalıştırarak bu sorundan kaçınmak için uzun dosya yollarını etkinleştirin:
   git config --global core.longpaths true

1. Yerel makinenizde bir GitHub klasör oluşturun. Örneğin, C:\GitHub. (OneDrive eşitleme bir klasöre kopyalama.)

2. Tarayıcıda GitHub.com gidin ve oturum açın.

3. Sağ üstteki GitHub'da, profil açılan listenizden Depolarınız'ı seçin. Depolar sayfası, çatallanmış depolarınızın listesiyle birlikte görüntülenir.

4. Kopyalamak istediğiniz depoyu seçin. Çatalınızın depo sayfası görüntülenir.

   Üretim deposunun değil çatalınızın depo sayfasında olduğunuzdan emin olun. URL'yi denetleyerek, üzerinde olduğunuz deponun çatalınız olduğunu doğrulayabilirsiniz: Microsoft kuruluşu (örneğin, https://github.com/nancydavolio/azure-docs ve DEĞİlhttps://github.com/MicrosoftDocs/azure-docs) yerine GitHub kullanıcı adınızı göstermelidir. Ayrıca, sol üst köşede adınızı ve ardından ana deponun adının çatallandığını belirten bir not görürsünüz.

   

5. <> Sayfanın sol üst kısmındaki Kod sekmesini seçin.

6. Sağ taraftaki Kod açılan listesinden HTTPS seçeneğinin altındaki URL'yi kopyalayın.

   

Önemli

Kopya URL'sini GitHub kullanıcı arabirimi aracılığıyla kopyalamışsınız. Diğer adımlar VS Code Terminali'nde gerçekleştirilmelidir.

Visual Studio Code'dan kopyalamak için

1. Visual Studio Code'u açın.

2. Üst gezinti menüsünden Görünüm'ü ve ardından Terminal'i seçin. Terminal görünümü, Visual Studio Code ekranının en altında görünür.

3. Terminal görünümünde, 1. Adımda Depo kopyalama bölümünde dizini (cd) GitHub sürücünüzdeki depolar için oluşturduğunuz klasörle değiştirmek için komutunu çalıştırın.

   Örnek:

    cd C:\GitHub
   

   Hata alırsanız, dizini bir kerede bir klasör değiştirmeniz gerekebilir.

4. Depoyu kopyalamak için aşağıdaki komutu çalıştırın:

   git clone <paste the clone URL you copied via the GitHub UI>
   

   Örneğin:

   git clone https://github.com/nancydavolio/azure-docs.git
   

5. Tarayıcı üzerinden kimlik doğrulaması yapmanız istendiğinde "Tarayıcınızla oturum açın" düğmesini seçin ve işlemi tamamlayın. Tarayıcı işlevselliği aracılığıyla kimlik doğrulamasını destekleyen en son Git sürümünü indirdiğinizden emin olun. GitHub kişisel erişim belirteci kullanmayı seçerseniz şu yönergeleri izleyerek bir tane oluşturabilirsiniz: Kişisel erişim belirteci oluşturma.

   Clone komutu, depo dosyalarını çatalınızdan 3. Adımda seçtiğiniz konumdaki yeni bir klasöre indirir. Geçerli klasörde yeni bir klasör oluşturulur. Bu, depo boyutuna bağlı olarak birkaç dakika sürebilir. İşlem tamamlandıktan sonra yapısını görmek için klasörü inceleyebilirsiniz.

Uzak ayarları ayarlama

Depoyu kopyaladıktan sonra ana depoya yukarı akış adlı bir salt okunur uzak bağlantı ayarlayın. Uzaklar , uzak depolara başvuran diğer adlardır. Kaynak çatalınızı, yukarı akış ise üretim deposunu ifade eder. Komutu çalıştırdığınızda origin Git uzaktan kumandayı otomatik olarak oluşturmuştur clone . Yukarı akış URL’sini kullanarak yerel deponuzun başkaları tarafından yapılan değişikliklerle her zaman eşit kalmasını sağlarsınız.

Git Bash veya VS Code Terminali'nde aşağıdaki komutları çalıştırın.

1. Dizini (cd) komutun oluşturduğu depo klasörüne clone değiştirin. Örneğin:

   cd repo-name
   

2. Üretim deposuna işaret eden adlı upstream bir uzak sunucu eklemek için aşağıdaki komutu çalıştırın. Örneğin, depo URL'si upstream yerine https://github.com/nancydavolio/azure-docs.gitşeklindedirhttps://github.com/MicrosoftDocs/azure-docs.git.

   git remote add upstream <the clone URL of the main repo>
   

   Örneğin:

   git remote add upstream https://github.com/MicrosoftDocs/azure-docs.git
   

3. Uzaktan kumandalarınızın doğru olduğundan emin olmak için aşağıdaki komutu çalıştırın:

   git remote -v
   

   Çıktı örneği:

   origin  https://github.com/nancydavolio/azure-docs.git (fetch)
   origin  https://github.com/nancydavolio/azure-docs.git (push)
   upstream        https://github.com/MicrosoftDocs/azure-docs.git (fetch)
   upstream        https://github.com/MicrosoftDocs/azure-docs.git (push)
   

4. Hata yaptıysanız uzaktan kumandayı kaldırın ve eklemek için adımı yineleyin. öğesini kaldırmak upstreamiçin komutunu çalıştırın:

   git remote remove upstream
   

Sonraki adımlar

• Artık yerel kopyanızı ayarladığınıza göre, önemli değişiklikler yapma zamanı geldi.