33.다국어 지원 및 로컬라이제이션, 다국어 URL 설정 및 다국어 블로그 포스트 관리

서론

현대 웹 애플리케이션은 점점 더 많은 사용자의 접근성을 고려해야 합니다. 그 중 가장 중요한 요소 중 하나가 바로 다국어 지원입니다. 많은 기업들이 글로벌 시장에서 경쟁력을 갖추기 위해 다국어 웹사이트를 구축하고 있으며, 이를 통해 다양한 언어를 사용하는 사용자들에게 맞춤형 서비스를 제공할 수 있습니다. 이 글에서는 Nest.js와 Next.js를 활용하여 다국어 지원과 로컬라이제이션, 다국어 URL 설정, 그리고 다국어 블로그 포스트 관리에 대한 구체적인 방법을 탐구하겠습니다.

1. 다국어 지원의 중요성

다국어 지원은 단순히 다양한 언어를 제공하는 것을 넘어서, 사용자 경험을 극대화하는 과정입니다. 예를 들어, 사용자가 자신의 모국어로 콘텐츠를 소비할 수 있다면, 정보의 이해도와 만족도가 증가합니다. 이는 브랜드 충성도와 사용자 참여를 높이는 중요한 요소입니다.

2. 로컬라이제이션의 이해

로컬라이제이션(Localization)이라는 용어는 단순히 언어 번역을 의미하지 않습니다. 문화적 요소, 언어적 차이, 지역적 관습 등을 고려하여 콘텐츠를 조정하는 과정을 포함합니다. 따라서 웹 애플리케이션에서 로컬라이제이션을 구현할 때, 각 지역의 사용자들이 선호하는 형식으로 정보를 제공해야 합니다.

3. Next.js를 통한 다국어 지원 구현

Next.js는 React 기반의 프레임워크로, 서버 사이드 렌더링, 정적 사이트 생성, API 라우팅 등 다양한 기능을 제공합니다. Next.js에서 다국어 지원을 구현하는 과정은 다소 간단하므로 다음 단계를 통해 설명하겠습니다.

3.1. i18next 라이브러리 설치

Next.js에서 다국어 지원을 위해 i18next와 함께 react-i18next 라이브러리를 쉽게 사용할 수 있습니다. 다음 명령어로 라이브러리를 설치합니다.

npm install i18next react-i18next

3.2. i18next 설정

프로젝트 루트에 ‘i18n.js’ 파일을 생성하고 기본적인 설정을 추가합니다.


import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';

i18n
  .use(initReactI18next)
  .init({
    resources: {
      ko: {
        translation: {
          welcome: '환영합니다',
          description: '다국어 지원 예제입니다',
        },
      },
      en: {
        translation: {
          welcome: 'Welcome',
          description: 'This is a multilingual support example',
        },
      },
    },
    lng: 'ko', // 기본 언어
    fallbackLng: 'en',
    interpolation: {
      escapeValue: false, // React는 HTML을 자동으로 이스케이프 처리를 수행
    },
  });

export default i18n;

3.3. 설정 적용하기

설정한 i18n을 애플리케이션 전체에 적용하기 위해 ‘_app.js’ 파일에서 Provider로 감싸줍니다.


import { AppProps } from 'next/app';
import { I18nextProvider } from 'react-i18next';
import i18n from '../i18n';

function MyApp({ Component, pageProps }: AppProps) {
  return (
    
      
    
  );
}

export default MyApp;

3.4. 다국어 적용하기

이제 컴포넌트에서 다국어 기능을 사용할 수 있습니다. useTranslation 훅을 사용하여 다음과 같이 다국어 콘텐츠를 표시할 수 있습니다.


import { useTranslation } from 'react-i18next';

const WelcomeComponent = () => {
  const { t } = useTranslation();

  return (
    
      {t('welcome')}
      {t('description')}
    
  );
};

4. Nest.js와 다국어 API 구축

Nest.js는 Node.js를 기반으로 한 프레임워크로, 엔터프라이즈급 애플리케이션을 구축하는 데 적합합니다. 다국어 API를 구축하기 위해 필요한 설정 내용을 살펴보겠습니다.

4.1. 패키지 설치

Nest.js에서 다국어 지원을 구현하기 위해 ‘nestjs-i18n’ 라이브러리를 사용할 수 있습니다. 다음 명령어로 패키지를 설치합니다.

npm install @nestjs/i18n

4.2. 모듈 설정

‘app.module.ts’ 파일에서 I18nModule을 imports 배열에 추가하여 설정합니다.


import { Module } from '@nestjs/common';
import { I18nModule } from 'nestjs-i18n';

@Module({
  imports: [
    I18nModule.forRoot({
      fallbackLanguage: 'en',
      loaderOptions: {
        path: __dirname + '/i18n/', // 언어 파일 위치
        watch: true,
      },
    }),
  ],
})
export class AppModule {}

4.3. 언어 파일 작성

언어 파일을 ‘i18n’ 폴더에 ‘ko.json’과 ‘en.json’ 파일로 작성합니다.


// ko.json
{
  "welcome": "환영합니다",
  "description": "다국어 지원 예제입니다"
}

// en.json
{
  "welcome": "Welcome",
  "description": "This is a multilingual support example"
}

4.4. 컨트롤러에서 사용하기

컨트롤러에서 I18nService를 주입하여 다국어 메시지를 반환합니다.


import { Controller, Get, Req } from '@nestjs/common';
import { I18nService } from 'nestjs-i18n';

@Controller('hello')
export class HelloController {
  constructor(private readonly i18n: I18nService) {}

  @Get()
  getHello(@Req() req: Request) {
    const lang = req.headers['accept-language'] || 'en';
    const message = this.i18n.translate('welcome', { lang });
    return { message };
  }
}

5. 다국어 URL 설정

다국어 웹사이트에서 URL 구조는 사용자 경험에 중요한 요소입니다. 사용자가 원하는 언어로 접근할 수 있도록 URL 라우팅을 설정해야 합니다. Next.js에서는 dynamic routing을 활용하여 URL에 언어 코드를 추가할 수 있습니다.

5.1. 페이지 파일 구조

pages 폴더에 각 언어별로 별도의 폴더를 생성합니다. 예를 들어, ‘ko’와 ‘en’ 폴더를 생성하고 각 언어별 index.js 파일을 생성합니다.


/pages
  /ko
    index.js // 한국어 페이지
  /en
    index.js // 영어 페이지

5.2. 지역화된 URL 생성하기

각 페이지 파일에서 i18n의 다국어 지원 기능을 사용하여 URL을 지역화할 수 있습니다. 예를 들어, ‘ko/index.js’ 파일에 다음과 같이 작성합니다.


import { useTranslation } from 'react-i18next';

const HomeKorean = () => {
  const { t } = useTranslation();

  return (
    
      {t('welcome')}
      {t('description')}
    
  );
};

export default HomeKorean;

6. 다국어 블로그 포스트 관리

블로그를 운영하면서 여러 언어로 포스트를 관리하는 것은 까다로울 수 있지만, 올바른 구조와 전략을 사용하면 효율적으로 관리할 수 있습니다.

6.1. 포스트 데이터 구조

포스트 데이터를 다음과 같은 형식으로 구조화할 수 있습니다.


const posts = [
  {
    id: 1,
    title: {
      ko: '첫 번째 포스트',
      en: 'First Post',
    },
    content: {
      ko: '이것은 첫 번째 포스트입니다.',
      en: 'This is the first post.',
    },
  },
  {
    id: 2,
    title: {
      ko: '두 번째 포스트',
      en: 'Second Post',
    },
    content: {
      ko: '이것은 두 번째 포스트입니다.',
      en: 'This is the second post.',
    },
  },
];

6.2. 다국어 포스트 렌더링

컴포넌트에서 현재 언어에 맞는 제목과 내용을 표시할 수 있습니다. 예를 들어, 포스트의 내용을 동적으로 렌더링하는 방법은 다음과 같습니다.


const Post = ({ post, lang }) => {
  return (
    
      {post.title[lang]}
      {post.content[lang]}
    
  );
};

6.3. 포스트 작성 및 관리

블로그 포스트를 작성할 때 언어별로 제목과 내용을 입력할 수 있는 폼을 제공하여 관리할 수 있습니다. 이를 통해 관리자는 쉽게 여러 언어의 포스트를 작성하고 수정할 수 있습니다.

7. 결론

다국어 지원과 로컬라이제이션은 글로벌 시장에서 경쟁력을 유지하는 데 매우 중요한 요소입니다. Nest.js와 Next.js를 활용하면 효과적으로 다국어 웹 애플리케이션을 구축할 수 있으며, 사용자에게 더 나은 경험을 제공할 수 있습니다. 이번 포스트에서는 다국어 지원의 중요성과 Next.js 및 Nest.js를 사용한 다국어 지원 구현 방법, 다국어 URL 설정 및 블로그 포스트 관리에 대해 살펴보았습니다. 이 지식을 바탕으로 자신만의 다국어 웹 애플리케이션을 구축해 보세요.