GitLab 문서의 리디렉션
GitLab 문서에서 페이지를 이동, 이름 변경, 삭제할 때 리디렉션을 추가하는 방법과 유형, 예외 사항, 문제 해결 방법을 설명합니다.
페이지를 이동, 이름 변경, 또는 삭제할 때는 반드시 리디렉션을 추가해야 합니다. 리디렉션은 사용자가 오래된 링크를 통해 문서 사이트를 방문할 때 404 오류가 발생하는 횟수를 줄여줍니다. 다음을 보장하기 위해 리디렉션을 추가하세요: 사용자가 새 페이지를 확인하고 북마크를 업데이트하거나 삭제할 수 있습니다. 외부 사이트, 특히 리디렉션된 링크를 확인하는 자동화 기능이 있는 사이트가 링크를 업데이트할 수 있습니다. 번역된 문서가 항상 영어 콘텐츠의 기존 파일로 폴백(fallback)될 수 있습니다. AI 크롤러가 해당 주제의 관련 컨텍스트를 계속 찾을 수 있습니다. 문서 사이트의 전역 내비게이션이 없어진 페이지로 연결되지 않습니다. 전역 내비게이션의 링크는 이미 docs-gitlab-com 프로젝트에서 테스트됩니다. 페이지를 이동, 이름 변경, 삭제하는 머지 리퀘스트에는 반드시 기술 작가(Technical Writer)를 지정하세요. 기술 작가는 질문에 답하고 변경 사항을 검토할 수 있습니다. 다른 리디렉션으로 리디렉션하지 마세요. 페이지의 파일명을 변경하면 콘텐츠 감사에서 Google Analytics 데이터가 제거되고 페이지 조회수가 처음부터 다시 시작됩니다. 파일명을 변경하려면 먼저 페이지를 편집하여 새 페이지 이름이 최대한 정확한지 확인하세요. 리디렉션 유형 # 리디렉션에는 두 가지 유형이 있습니다: 문서 파일 자체에 추가되는 리디렉션 : GitLab Self-Managed 인스턴스의 /help 에서 문서를 보는 사용자를 위한 것입니다. 예: GitLab.com의 /help . 이 리디렉션은 문서를 이름 변경하거나 이동하는 동일한 MR에 추가해야 합니다. 내부 페이지로의 리디렉션은 3개월 후에 만료되고, 외부 페이지(URL이 https: 로 시작하는 경우)로의 리디렉션은 1년 후에 만료됩니다. GitLab Pages 리디렉션 : 리디렉션 파일이 만료된 후 자동으로 추가됩니다. 기여자가 수동으로 추가해서는 안 되며, 9개월 후에 만료됩니다. 외부 사이트를 가리키는 리디렉션은 GitLab Pages 리디렉션에 추가되지 않습니다. 만료된 리디렉션 파일은 기술 작성팀의 월별 작업 의 일환으로 문서 프로젝트에서 제거됩니다. 이미 존재하는 페이지로 리디렉션하기 # 같은 리포지터리의 다른 페이지로 페이지를 리디렉션하려면: 새 위치로 리디렉션하려는 Markdown 파일에서: 모든 콘텐츠를 삭제합니다. 다음 콘텐츠를 추가합니다: --- redirect_to: '../newpath/to/file/_index.md' remove_date: 'YYYY-MM-DD' --- <!-- markdownlint-disable --> This document was moved to [another location](../newpath/to/file/_index.md). <!-- This redirect file can be deleted after . --> <!-- Redirects that point to other docs in t