{"meta":{"title":"템플릿","intro":"이 문서에는 사용되는 다양한 콘텐츠 형식에 대한 시작 템플릿이 포함되어 있습니다 GitHub Docs.","product":"GitHub Docs에 기여","breadcrumbs":[{"href":"/ko/enterprise-server@3.22/contributing","title":"GitHub Docs에 기여"},{"href":"/ko/enterprise-server@3.22/contributing/writing-for-github-docs","title":"GitHub 문서 작성하기"},{"href":"/ko/enterprise-server@3.22/contributing/writing-for-github-docs/templates","title":"템플릿"}],"documentType":"article"},"body":"# 템플릿\n\n이 문서에는 사용되는 다양한 콘텐츠 형식에 대한 시작 템플릿이 포함되어 있습니다 GitHub Docs.\n\n## 개념 문서 템플릿\n\n개념적 콘텐츠를 작성하는 방법에 대한 전체 지침과 예제를 보려면 콘텐츠 모델을 사용하세요. 자세한 내용은 [개념 콘텐츠 형식](/ko/enterprise-server@3.22/contributing/style-guide-and-content-model/concepts-content-type)을(를) 참조하세요.\n\n<!-- markdownlint-disable search-replace -->\n\n```yaml\n---\ntitle: 'About <subject>'\nshortTitle: '<subject>'\nintro: 'Article intro. See tips for a great intro below.'\nproduct: \"optional product callout\"\ncontentType: concepts\nversions:\n  - version\n---\n\n{% comment %}\n- Follow the guidelines in https://docs.github.com/contributing/writing-for-github-docs/content-model to write this article.\n- Great intros give readers a quick understanding of what's in the article, so they can tell whether it's relevant to them before moving ahead. For more tips, see https://docs.github.com/contributing/writing-for-github-docs/content-model\n- For product callout info, see https://github.com/github/docs/tree/main/content#product\n- For product version instructions, see https://github.com/github/docs/tree/main/content#versioning\n- Remove these comments from your article file when you're done writing.\n{% endcomment %}\n\n## A section here\n\n{% comment %}\nWrite one or two paragraphs about the main idea of your topic, as a summary.\nMake sure you don't have any content that isn't preceded by a header, or it won't be linkable in our table of contents.\n{% endcomment %}\n\n## Another section here\n\n{% comment %}\nWrite one or two paragraphs about another element of your topic.\nKeep adding headers and sections until you've completed your article.\n{% endcomment %}\n\n## Further reading\n\n{% comment %}\nOptionally, include a bulleted list of related articles the user can reference to extend the concepts covered in this article. Consider linking to procedural articles or tutorials that help the user use the information in your article.\n{% endcomment %}\n\n- [Article title](article-URL)\n```\n\n<!-- markdownlint-enable search-replace -->\n\n## 참조 문서 템플릿\n\n참조 콘텐츠를 작성하는 방법에 대한 전체 지침 및 예제는 콘텐츠 모델을 사용합니다. 자세한 내용은 [참조 콘텐츠 형식](/ko/enterprise-server@3.22/contributing/style-guide-and-content-model/reference-content-type)을(를) 참조하세요.\n\n<!-- markdownlint-disable search-replace -->\n\n```yaml\n---\ntitle: Nouns describing your subject\nshortTitle: <subject> # Max 31 characters\nintro: 'Article intro. See tips for a great intro below.'\nproduct: \"{{ optional product callout }}\"\ncontentType: reference\nversions:\n  - <version>\n---\n\n{% comment %}\nFollow the guidelines in https://docs.github.com/contributing/writing-for-github-docs/content-model to write this article.-- >\nGreat intros give readers a quick understanding of what's in the article, so they can tell whether it's relevant to them before moving ahead. For more tips, see https://docs.github.com/en/contributing/style-guide-and-content-model/contents-of-a-github-docs-article#intro\nFor product callout info, see https://github.com/github/docs/tree/main/content#product\nFor product version instructions, see https://github.com/github/docs/tree/main/content#versioning\nRemove these comments from your article file when you're done writing\n{% endcomment %}\n\n## A section here\n\n{% comment %}\nWrite one or two paragraphs about the main idea of your topic, as a summary.\nMake sure you don't have any content that isn't preceded by a header, or it won't be linkable in our table of contents.\n{% endcomment %}\n\n## Another section here\n\n{% comment %}\nWrite one or two paragraphs about another element of your topic.\nKeep adding headers and sections until you've completed your article.\n{% endcomment %}\n\n## Further reading\n\n{% comment %}\nOptionally, include a bulleted list of related articles the user can reference to extend the concepts covered in this article. Consider linking to procedural articles or tutorials that help the user use the information in your article.\n{% endcomment %}\n\n- [Article title](article-URL)\n```\n\n<!-- markdownlint-enable search-replace -->\n\n## 사용 방법 안내서 템플릿\n\n콘텐츠 모델을 사용하여 방법 콘텐츠 작성에 관한 상세한 지침 및 예제를 참조하세요. 자세한 내용은 [방법 콘텐츠 유형](/ko/enterprise-server@3.22/contributing/style-guide-and-content-model/how-to-content-type)을(를) 참조하세요.\n\n<!-- markdownlint-disable search-replace -->\n\n```yaml\n---\ntitle: Start with a present participle\nshortTitle: <subject> # Max 31 characters\nintro: 'Article intro. See tips for a great intro below.'\nproduct: \"{{ optional product callout }}\"\ncontentType: how-tos\nversions:\n  - <version>\n---\n\n{% comment %}\nFollow the guidelines in https://docs.github.com/contributing/writing-for-github-docs/content-model to write this article.\nGreat intros give readers a quick understanding of what's in the article, so they can tell whether it's relevant to them before moving ahead. For more tips, see https://docs.github.com/contributing/writing-for-github-docs/content-model\nFor product callout info, see https://github.com/github/docs/tree/main/content#product\nFor product version instructions, see https://github.com/github/docs/tree/main/content#versioning\nRemove these comments from your article file when you're done writing\n{% endcomment %}\n\n## Procedural section header here\n\n{% comment %}\nInclude prerequisite information or specific permissions information here.\nThen write procedural steps following the instructions in https://docs.github.com/contributing/style-guide-and-content-model/style-guide#procedural-steps.\nCheck if there's already a reusable string for the step you want to write in https://github.com/github/docs/tree/main/data/reusables. Look at the source file for a procedure located in the same area of the user interface to find reusables.\n{% endcomment %}\n\n## Optionally, another procedural section here\n\n{% comment %}\nKeep adding procedures until you've finished writing your article.\n{% endcomment %}\n\n## Further reading\n\n{% comment %}\nOptionally, include a bulleted list of related articles the user can reference to extend the concepts covered in this article. Consider linking to procedural articles or tutorials that help the user use the information in your article.\n{% endcomment %}\n\n- [Article title](article-URL)\n```\n\n<!-- markdownlint-enable search-replace -->\n\n## 빠른 시작 문서 템플릿\n\n콘텐츠 모델을 사용하여 빠른 시작을 작성하는 방법에 대한 전체 지침과 예제를 확인하세요. 자세한 내용은 [빠른 시작 콘텐츠 형식](/ko/enterprise-server@3.22/contributing/style-guide-and-content-model/quickstart-content-type)을(를) 참조하세요.\n\n<!-- markdownlint-disable search-replace -->\n\n```yaml\n---\ntitle: Quickstart title\nshortTitle: <subject> # Max 31 characters\nintro: 'Article intro. Highlight that the guide is quick and to the point.'\ncontentType: get-started\nversions:\n  - <version>\n---\n\n{% comment %}\nFollow the guidelines in https://docs.github.com/contributing/writing-for-github-docs/content-model#quickstart to write this article.\nFor product version instructions, see https://github.com/github/docs/tree/main/content#versions.\nThe entire quickstart should be about 600 words long or take about five minutes to read.\nRemove these comments from your article file when you're done writing\n{% endcomment %}\n\n## Introduction\n\n{% comment %}\nBuild on the quick phrasing above by\n- Clarifying the audience\n- Clearly stating prerequisites and prior knowledge needed\n- Stating what the user will accomplish or build\n{% endcomment %}\n\n## Step one: Action the user will take\n\n{% comment %}\nIn one sentence, describe what the user will do in this step\nSteps should break down the tasks the user will complete in sequential order\nAvoid replicating conceptual information that is covered elsewhere, provide inline links instead. Only include conceptual information unique to this use case.\n{% endcomment %}\n\n### Task chunk\n\n{% comment %}\nA step may require the user to perform several tasks - break those tasks down into chunks, allowing the user to scan quickly to find their place if they navigated away from this screen to perform the task.\nAn example might be creating a personal access token for the action to use and then storing it in secrets\nFor UI based tasks, include the button or options the users should click\nIf the task adds code, include the code in context (don't just show `needs setup` show the entire `setup` and `dependent` jobs)\n{% endcomment %}\n\n### Another task chunk\n\n## Step 2: Do the next thing\n\n{% comment %}\nRinse and repeat, adding steps and tasks until the tutorial is complete\n{% endcomment %}\n\n## Next steps\n\n{% comment %}\nProvide a quick recap of what has been accomplished in the quick start as a means of transitioning to next steps. Include 2-3 actionable next steps that the user take after completing the quickstart. Always link to conceptual content on the feature or product. You can also link off to other related information on docs.github.com or in GitHub Skills.\n{% endcomment %}\n```\n\n<!-- markdownlint-enable search-replace -->\n\n## 튜토리얼 문서 템플릿\n\n튜토리얼 작성 방법에 대한 전체 지침과 예제를 보려면 콘텐츠 모델을 사용하세요. 자세한 내용은 [자습서 콘텐츠 형식](/ko/enterprise-server@3.22/contributing/style-guide-and-content-model/tutorial-content-type)을(를) 참조하세요.\n\n<!-- markdownlint-disable search-replace -->\n\n```yaml\n---\ntitle: Tutorial title\nshortTitle: <subject> # Max 31 characters\nintro: 'Article intro. See tips for a great intro below'\nproduct: \"{{ optional product callout }}\"\ncontentType: tutorials\nversions:\n  - <version>\n---\n\n{% comment %}\nFollow the instructions in https://docs.github.com/contributing/writing-for-github-docs/content-model#quickstart to write this article.\nGreat intros clarify who the tutorial is intended for, state what the user will accomplish, and state the technologies that will be used.\nFor product callout info, see https://github.com/github/docs/tree/main/content#product\nFor product version instructions, see https://github.com/github/docs/tree/main/content#versioning\nRemove these comments from your article file when you're done writing\n{% endcomment %}\n\n## Introduction\n\n{% comment %}\nThe tutorial introduction should include the following in a short paragraph -\n\n- Clarify audience\n- State prerequisites and prior knowledge needed\n- State what the user will accomplish or build and the user problem it solves\n- Link to an example of the project the user will complete\n{% endcomment %}\n\n## Step 1: Action the user will take\n\n{% comment %}\nIn one sentence, describe what the user will do in this step\nSteps should break down the tasks the user will complete in sequential order\nAvoid replicating conceptual information that is covered elsewhere, provide inline links instead. Only include conceptual information unique to this use case.\n{% endcomment %}\n\n### Task chunk\n\n{% comment %}\nA step may require the user to perform several tasks - break those tasks down into chunks, allowing the user to scan quickly to find their place if they navigated away from this screen to perform the task.\nAn example might be creating a personal access token for the action to use and then storing it in secrets\nFor UI based tasks, include the button or options the users should click\nIf the task adds code, include the code in context (don't just show `needs: setup` show the entire `setup` and `dependent` jobs)\n{% endcomment %}\n\n### Another task chunk\n\n## Step 2: Do the next thing\n\n{% comment %}\nRinse and repeat, adding steps and tasks until the tutorial is complete\nRemember to show code snippets in context\n{% endcomment %}\n\n## Further reading\n\n{% comment %}\nInclude a bulleted list of tutorials or articles the user can reference to extend the concepts taught in this tutorial\n{% endcomment %}\n\n- [Article title](article-URL)\n```\n\n<!-- markdownlint-enable search-replace -->\n\n## GitHub Actions 대한 언어 가이드\n\n콘텐츠 모델을 사용하여 GitHub Docs에 대한 작성 방법의 전체 지침 및 예제를 확인하세요. 자세한 내용은 [콘텐츠 모델 정보](/ko/enterprise-server@3.22/contributing/style-guide-and-content-model/about-the-content-model)을(를) 참조하세요.\n\n<!-- markdownlint-disable search-replace -->\n\n```yaml\n---\ntitle: Guide title\nshortTitle: <subject> # Max 31 characters\nintro: 'Article intro. See tips for a great intro below'\nproduct: \"{{ optional product callout }}\"\ncontentType: tutorials\nversions:\n  - <version>\n---\n\n{% comment %}\n- Great intros clarify who the guide is intended for, state what the user will accomplish, and state the technologies that will be used.\n- Intros are typically 1-3 sentence summaries, with a longer \"Introduction\" section that follows.\n- Remove these comments from your article file when you're done writing\n{% endcomment %}\n\n## Introduction\n\n{% comment %}\nThe language guide introduction should include the following in a short paragraph -\n- Clarify audience.\n- State prerequisites and prior knowledge needed.\n- Should the user have read any other articles?\n- State what the user will accomplish or build and the user problem it solves.\n{% endcomment %}\n\n## Starting with the <language> workflow template\n\n{% comment %}\nLanguage guides typically walk through and build upon a workflow template. If that format doesn't work, you can include a boilerplate workflow.\n- Link to the GitHub Actions CI workflow template as the boilerplate reference code and then walk through and build on that code in this guide - https://github.com/actions/starter-workflows/tree/main/ci\n- Provide instructions for adding the workflow template to a repository.\n- Include the starter template workflow code.\n{% endcomment %}\n\n## Running on different operating systems\n\n{% comment %}\nInclude a brief overview of how to choose the runner environment. These should be alternatives to what operating system is presented in the workflow template/boilerplate template.\n{% endcomment %}\n\n## Configuring the <language> version\n\n{% comment %}\n- Describe when and how to use available setup actions that configure the version of the language on the runner (ex. actions/setup-node).\n- How does the setup action configure the version and what happens when the version isn't supported in the environment. What is the default version, when no version is configured.\n- Include any additional features the setup action might provide that are useful to CI.\n- If applicable, provide examples of configuring exact versions or major/minor versions.\n- Include information about software already installed on GitHub-hosted runners or software configuration necessary to build and test the project.\n- Provide examples of configuring matrix strategies.\n- Link out to any docs about available software on the GitHub-hosted runners. (Ex. https://docs.github.com/en/actions/reference/software-installed-on-github-hosted-runners).\n- Include code samples.\n{% endcomment %}\n\n## Installing dependencies\n\n{% comment %}\n- Include example of installing dependencies to prepare for building and testing.\n- Are there any dependencies or scenarios where people might need to install packages globally?\n- Include examples of common package managers.\n- If the language is supported by GitHub Packages, include an example installing dependencies from GitHub.\n- Include code samples.\n{% endcomment %}\n\n## Caching dependencies\n\n{% comment %}\nInclude an example of restoring cached dependencies. We'll want to link out to the article about caching for more information (https://docs.github.com/en/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows).\n{% endcomment %}\n\n## Building your code\n\n{% comment %}\n- Include any compile steps.\n- Include any test commands.\n- Note that you can use the same commands that your repository needs to build and test your code by simply replacing the commands in the `run` keyword.\n- Include any basic examples or commands specific to test frameworks.\n- Include any common databases or services that might be needed. If so, we can link out to the services guides in the docs (https://docs.github.com/en/actions/configuring-and-managing-workflows/using-databases-and-service-containers).\n{% endcomment %}\n\n## Packaging workflow data as artifacts\n\n{% comment %}\nThis section can simply link out to https://docs.github.com/en/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts or provide additional information about which artifacts might be typical to upload for a CI workflow.\n{% endcomment %}\n```"}