블로그 Copyright 수정

Material for MkDocs 테마는 화면 하단(Footer)에 기본적으로 "Made with Material for MkDocs"라는 출처 텍스트를 고정으로 렌더링합니다.

본 문서는 이 기본 문구를 완전히 제거하고, 본인만의 커스텀 저작권 문구만 깔끔하게 노출하도록 테마의 HTML 템플릿을 덮어쓰기(Override)하는 방법을 안내합니다.

1. 템플릿 덮어쓰기(Override)의 원리

MkDocs는 정적 HTML을 생성할 때 내부적으로 Jinja2 템플릿 엔진을 사용합니다.

테마 원본 코드를 직접 수정하는 대신, 로컬 프로젝트 내부에 동일한 이름의 폴더와 파일을 구성하여 특정 부분(Partial)의 렌더링만 가로채서(Override) 내가 원하는 코드로 덮어씌우는 방식을 사용합니다.

2. Overrides 디렉터리 및 파일 구성

하단 저작권 영역을 관장하는 파일은 테마 내부의 partials/copyright.html 입니다.

이를 덮어쓰기 위해 동일한 경로를 로컬에 생성합니다.

1) 폴더 및 파일 생성

docs/ 디렉터리 내부에 아래와 같이 overrides 폴더와 하위 구조를 생성합니다.

docs/
└── overrides/
    └── partials/
        └── copyright.html  # 신규 생성

2) copyright.html 코드 작성

생성한 copyright.html 파일에 아래 코드를 작성합니다.

이 코드는 테마의 원래 코드에서 "Made with..." 부분을 제거하고, 우리가 설정 파일에 정의할 copyright 변수값만 렌더링하도록 수정한 코드입니다.

<div class="md-copyright">
  {% if config.copyright %}
    <div class="md-copyright__highlight">
      {{ config.copyright }}
    </div>
  {% endif %}
</div>

3. mkdocs.yml 설정 적용

오버라이드할 파일이 준비되었다면, 시스템(MkDocs)이 해당 디렉터리를 인식할 수 있도록 mkdocs.yml 파일을 수정해야 합니다.

1) custom_dir 선언

theme: 블록 하위에 custom_dir 속성을 추가하여 방금 만든 폴더의 경로를 명시합니다.

theme:
  name: material
  language: ko
  custom_dir: docs/overrides # 템플릿 덮어쓰기를 위한 경로 지정

# 사이트 기본 설정 영역
site_name: 기술 블로그
site_url: https://<본인-도메인>.pages.dev

# 하단 Footer에 표시될 커스텀 문구
copyright: Copyright &copy; 2026 Gyubeom. All rights reserved.

4. 적용 확인

모든 설정이 완료된 후 로컬 서버를 재시작(uv run mkdocs serve)하여 브라우저 하단을 확인합니다.