Sayfalar arasında içeriği yeniden kullanma

Bu kılavuzda, DevSite'taki makalelerde içerik paylaşma hakkında bilgiler yer almaktadır.

İçeriği birden fazla sayfada yeniden kullanmak için değişkenler ve eklemeler kullanabilirsiniz. Bu, Composer'da snippet'leri birden fazla makalede kullanmanın DevSite sürümüdür.

Not: support.google.com adresindeki Yardım Merkezleri ile paylaşılan içeriklerin çapraz yayınlanması mümkün değildir. Gezinme bölümünde herhangi bir alandaki sayfalara bağlantı verebilirsiniz ancak bir makaleyi veya bölümü DevSite dışı alanlarla tek bir kaynaktan sağlayamazsınız.

Dahil etmeler ve değişkenler ne zaman kullanılır?

  • Kısa ve tek kaynaklı bir metin dizesini yeniden kullanmak istediğinizde değişken kullanın. Örneğin, ürün adları ve özellik adları.

  • Tek kaynaklı biçimlendirilmiş metni veya HTML'yi yeniden kullanmak istediğinizde include (dahil et) ifadesini kullanın. Örneğin, özellik karşılaştırma tablosu veya önemli not.

Değişken oluşturun

  1. google3/third_party/devsite/workspace/en/_globalvars.html dosyasını açın.
    1. Sağ üstte Cider'da düzenle'yi tıklayın.

  2. Yeni bir değişken tanımı ekleyin.

    {% setvar YOUR_VARIABLE_NAME %}TEXT_TO_DISPLAY{% endsetvar %}
    • YOUR_VARIABLE_NAME yerine kullanmak istediğiniz değişkeni girin.
    • TEXT_TO_DISPLAY yerine kullanıcıya gösterilmesi gereken metni girin.

  3. Değişikliklerinizi kaydedin ve inceleme ile onay için workspace-content-configs adresine bir CL gönderin.

  4. CL gönderildikten sonra yeni değişken adınızı kullanarak içerik yayınlayabilirsiniz.

İçeriğinize değişken ekleme

Sayfanıza değişken eklemek için Jinja değişkeni kullanın. Bu basit {{ ... }} yapı, belirtilen değişkenin içeriğini sayfanızdaki etiketin bulunduğu yere ekler.

Örnek


**Note:** You can buy {{ workspace_name }} from a reseller.

<table>
  <tr>
    <th>Edition</th>
    <th>Cost</th>
  </tr>
  <tr>
    <td>{{ business_plus_sku_name }}</td>
    <td>$50 / month</td>
  </tr>
  <tr>
    <td>{{ business_standard_sku_name }}</td>
    <td>$20 / month</td>
  </tr>
  <tr>
    <td>{{ business_starter_sku_name }}</td>
    <td>No additional cost</td>
  </tr>
</table>

Oluşturuldu

Not: Google Workspace'i bir bayiden satın alabilirsiniz.

Sürüm Maliyet
Business Plus 50 ABD doları / ay
Business Standard 20 ABD doları / ay
Business Starter Ek ücret ödemezsiniz.

Dahil etme dosyası oluşturma

Önemli: Dahil edilen dosyalar her zaman HTML biçiminde olmalıdır. Bunun nedeni, HTML biçiminin hem HTML hem de Markdown kod bloğu bağlamlarında çalışabilmesi, ancak Markdown eklemelerinin yalnızca Markdown kod bloğu bağlamlarında çalışabilmesidir.

Eğitim videosunu izleyin

Bir include dosyası oluşturmak için aşağıdaki adımları uygulayın:

  1. Cider'ı açın.

  2. third_party/devsite/workspace/en/_shared/includes/ klasörünü bulmak için Kod Arama Aracı'nı veya Dosya Gezgini'ni kullanın.

  3. includes klasörünü sağ tıklayın ve New File'ı (Yeni Dosya) tıklayın (ekran görüntüsü).

    • Include'unuz yalnızca içerik kümenizle alakalıysa /includes klasöründe içerik kümeniz için bir alt klasör oluşturabilir ve include dosyanızı buraya ekleyebilirsiniz. Örneğin, …/workspace/en/shared/includes/cloud-search/_my-niche-snippet.html

  4. Dosyaya bir ad verin ve içeriğinizi ekleyin. Bunun için aşağıdaki yönergeleri izleyin:

    • Dosya adını alt çizgiyle başlatın. Örneğin, _my-new-include.html. Bu, dahil edilen dosyanın harici olarak kendi sayfası olmasını engeller.
    • Dosya adını açıklayıcı bir şekilde yazın. Bu sayede, herkesin dahil etme işlemini bulup kullanması kolaylaşır.
    • Tüm dahil edilenler HTML dosyası olmalıdır. Dosya uzantısı .html olmalı ve dosya, Markdown ile yazılmış öğeler içermemelidir. Bu, içeriğin bir Markdown dosyasına, bir HTML dosyasına veya bir Markdown dosyasındaki bir HTML öğesine dahil edilip edilmediğine bakılmaksızın doğru şekilde oluşturulmasını sağlar.
    • İçeriği çok yönlü hale getirin. Ekleme işleminin amacı, içeriğin birden fazla sayfaya sığmasıdır. Bu nedenle, içerik mümkün olduğunca yeniden kullanılabilir olmalıdır. * İdeal içerik: Sınırlar, uyarılar veya işleyiş şekli gibi uygulama ayrıntılarını içeren adımlar ve ilgili notlar ya da ipuçları. * Kaçının: Başlıklar veya genel bakışlar (Bunları iş kullanım alanları için kendimiz biçimlendirmek ve yazmak istiyoruz).

Örnek: Aşağıda, Google Cloud projesinin proje numarasının nasıl kopyalanacağıyla ilgili adımları içeren bir örnek include dosyası verilmiştir:

third_party/devsite/workspace/en/_shared/includes/_copy-cloud-project-number-steps.html

Daha fazla bilgi için Dosyaları dahil etme ile ilgili DevSite Publishing belgelerini inceleyin.

İçeriğinize dahil etme ekleme

Sayfanıza bir dahil etme işlemi eklemek için include etiketini kullanın. include etiketi, belirtilen dosyanın içeriğini sayfanızdaki etiketin bulunduğu yere ekler.

Önceki bölümdeki örnek dosya için bir include etiketi örneğini aşağıda bulabilirsiniz:

Örnek


{% include "_shared/includes/_copy-cloud-project-number-steps.html" %}

Oluşturuldu

  1. Google Cloud Console'da Menü ardından IAM ve Yönetici ardından Ayarlar'a gidin.

    IAM ve Yönetici Ayarları'na gitme

  2. Proje numarası alanındaki değeri kopyalayın.

Taşınan snippet dosyaları

Composer'daki snippet'ler, third_party/devsite/workspace/en/_shared/snippets klasörüne taşındı. İçeriğiniz, DevSite'a taşınmadan önce Composer'da snippet'ler kullanıyorsa içeriğinizde aşağıdaki örneğe benzer include etiketleri görürsünüz:

{% include "_shared/snippets/_snippet-9393389.html" %}

_shared/snippets klasörüne yeni include dosyaları eklemeyin.

Çapraz yayınlama

DevSite'ta her sayfa bir içerik kümesine aittir. Devsite, Composer'da kullanılan ve bir sayfanın birden fazla yardım merkezinde yayınlanabildiği çapraz yayınlamayı desteklemez. Bunun yerine, içerik tablonuzdan diğer içerik kümelerindeki sayfalara bağlantı verebilirsiniz.

Gezinme menünüze farklı bir içerik grubundan sayfa ekleme

Gezinme menünüzdeki farklı bir içerik grubundaki bir sayfaya bağlantı vermek için aşağıdaki adımları uygulayın:

  1. İçerik setiniz için _book.yaml dosyasını açın. _book.yaml dosyası, sitenizin gezinme bölümünü yönettiğiniz yerdir.
  2. Bağlantı oluşturmak istediğiniz sayfaya sayfa başlığını ve kök yolu ekleyin.

Aşağıdaki örnekte, Cloud Search için _book.yaml dosyası, İş Sürekliliği içerik setindeki bir makaleye bağlanıyor.

    - name: "Guides"
      contents:
      - heading: "Getting started"
      - title: "What is Google Cloud Search?"
        path: /cloud-search/what-is-google-cloud-search 
      - title: "Deploy 2-Step Verification"
        path: /business-continuity/security-and-monitoring/deploy-2-step-verification

Kullanıcı, Cloud Search gezinme bölümünde 2 Adımlı Doğrulamayı Dağıt bağlantısını tıkladığında Business Continuity dokümanlarındaki sayfaya yönlendirilir.

Sitenizin gezinme bölümünü güncelleme hakkında daha fazla bilgi edinmek için Gezinme bölümünü güncelleme başlıklı makaleyi inceleyin.