페이지 간 콘텐츠 재사용

이 가이드에는 DevSite의 여러 도움말에서 콘텐츠를 공유하는 방법에 관한 정보가 있습니다.

여러 페이지에서 콘텐츠를 재사용하려면 변수와 포함을 사용하면 됩니다. 이는 Composer에서 여러 도움말에 스니펫을 사용하는 DevSite 버전입니다.

참고: support.google.com의 고객센터와 공유 콘텐츠를 교차 게시할 수는 없습니다. 탐색에서 모든 도메인의 페이지로 연결할 수 있지만 DevSite가 아닌 도메인으로 도움말이나 섹션을 단일 소싱할 수는 없습니다.

포함 및 변수를 사용해야 하는 경우

  • 짧은 단일 소스 텍스트 문자열을 재사용하려면 변수를 사용하세요. 예를 들어 제품 이름과 기능 이름이 있습니다.

  • 단일 소스 형식 텍스트 또는 HTML을 재사용하려면 include를 사용합니다. 예를 들어 기능 비교 표 또는 중요한 참고사항이 있습니다.

변수 만들기

  1. google3/third_party/devsite/workspace/en/_globalvars.html을 엽니다.
    1. 오른쪽 상단에서 Cider에서 수정을 클릭합니다.

  2. 새 변수 정의를 추가합니다.

    {% setvar YOUR_VARIABLE_NAME %}TEXT_TO_DISPLAY{% endsetvar %}
    • YOUR_VARIABLE_NAME을 사용하려는 변수로 바꿉니다.
    • TEXT_TO_DISPLAY을 사용자에게 표시되어야 하는 텍스트로 바꿉니다.

  3. 변경사항을 저장하고 검토 및 승인을 위해 workspace-content-configs에 CL을 보냅니다.

  4. CL을 제출한 후에는 새 변수 이름을 사용하여 콘텐츠를 게시할 수 있습니다.

콘텐츠에 변수 추가

페이지에 변수를 추가하려면 Jinja 변수를 사용하세요. 이 간단한 {{ ... }} 구조는 페이지의 태그 위치에 지정된 변수의 콘텐츠를 삽입합니다.

예


**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>

렌더링됨

참고: 리셀러를 통해 Google Workspace를 구매할 수 있습니다.

버전 비용
Business Plus $50 / 월
Business Standard $20 / 월
Business Starter 추가 비용 없음

포함 파일 만들기

중요: 포함 파일은 항상 HTML 형식이어야 합니다. HTML 형식은 HTML 및 마크다운 코드 블록 컨텍스트에서 모두 작동하지만 마크다운은 마크다운 코드 블록 컨텍스트에서만 작동하기 때문입니다.

동영상 가이드 보기

포함 파일을 만들려면 다음 단계를 따르세요.

  1. Cider를 엽니다.

  2. 코드 검색 또는 파일 탐색기를 사용하여 third_party/devsite/workspace/en/_shared/includes/ 폴더를 찾습니다.

  3. includes 폴더를 마우스 오른쪽 버튼으로 클릭하고 새 파일을 클릭합니다(스크린샷).

    • 인클루드가 콘텐츠 세트에만 관련이 있는 경우 /includes 폴더 내에 콘텐츠 세트의 하위 폴더를 만들고 인클루드 파일을 여기에 추가하면 됩니다. 예: …/workspace/en/shared/includes/cloud-search/_my-niche-snippet.html

  4. 파일 이름을 지정하고 콘텐츠를 추가합니다. 다음 가이드라인을 준수하세요.

    • 파일 이름을 밑줄로 시작합니다. 예를 들면 _my-new-include.html입니다. 이렇게 하면 포함 파일이 외부에서 자체 페이지가 되지 않습니다.
    • 파일 이름에 설명을 포함하세요. 이렇게 하면 모든 사람이 더 쉽게 찾고 사용할 수 있습니다.
    • 모든 인클루드는 HTML 파일이어야 합니다. 파일 확장자는 .html이어야 하며 파일에 마크다운으로 작성된 요소가 포함되어서는 안 됩니다. 이렇게 하면 콘텐츠가 마크다운 파일, HTML 파일 또는 마크다운 파일 내의 HTML 요소에 포함되어 있더라도 콘텐츠가 올바르게 렌더링됩니다.
    • 다양한 용도로 사용할 수 있는 콘텐츠 만들기 포함의 목표는 여러 페이지에 맞게 하는 것이므로 콘텐츠는 최대한 재사용 가능해야 합니다. * 이상적인 포함 콘텐츠: 한도, 주의사항, 작동 방식 등 구현 세부정보가 포함된 단계 및 관련 메모 또는 팁 * 피해야 할 사항: 제목 또는 개요 (비즈니스 사용 사례를 위해 Google에서 직접 서식을 지정하고 작성하고자 함)

예: 다음은 Google Cloud 프로젝트의 프로젝트 번호를 복사하는 방법에 관한 단계의 예시 include 파일입니다.

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

자세한 내용은 DevSite 게시 문서의 파일 포함을 참고하세요.

콘텐츠에 인클루드 추가

페이지에 인클루드를 추가하려면 include 태그를 사용합니다. include 태그는 지정된 파일의 콘텐츠를 페이지의 태그 위치에 삽입합니다.

다음은 이전 섹션의 예시 파일에 대한 include 태그의 예입니다.

예


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

렌더링됨

  1. Google Cloud 콘솔에서 메뉴 다음 IAM 및 관리자 다음 설정으로 이동합니다.

    IAM & 관리자 설정으로 이동

  2. 프로젝트 번호 필드에서 값을 복사합니다.

이전된 스니펫 파일

Composer의 스니펫이 third_party/devsite/workspace/en/_shared/snippets 폴더로 이전되었습니다. 콘텐츠가 DevSite로 이전되기 전에 Composer에서 스니펫을 사용한 경우 콘텐츠에 다음 예와 유사한 include 태그가 표시됩니다.

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

_shared/snippets 폴더에 새 include 파일을 추가하지 마세요.

교차 게시

DevSite에서 각 페이지는 하나의 콘텐츠 세트에 속합니다. Devsite는 한 페이지를 여러 도움말 센터에 게시할 수 있는 Composer의 교차 게시를 지원하지 않습니다. 대신 목차에서 다른 콘텐츠 세트의 페이지로 연결할 수 있습니다.

다른 콘텐츠 세트의 페이지를 탐색에 추가하기

탐색에서 다른 콘텐츠 세트의 페이지로 연결하려면 다음 단계를 따르세요.

  1. 콘텐츠 세트의 _book.yaml 파일을 엽니다. _book.yaml 파일은 사이트 탐색을 관리하는 곳입니다.
  2. 링크로 연결할 페이지에 페이지 제목과 루트 경로를 추가합니다.

다음 예시에서 Cloud Search의 _book.yaml 파일은 비즈니스 연속성 콘텐츠 세트의 도움말로 연결됩니다.

    - 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

사용자가 Cloud Search 탐색에서 2단계 인증 배포 링크를 클릭하면 비즈니스 연속성 문서의 페이지로 이동합니다.

사이트 탐색 업데이트에 대해 자세히 알아보려면 탐색 업데이트를 참고하세요.