에피소드 위대한 사전 렌더링 임무 – 맞춤형 SSR 및 SSG 마스터리를 위한 Arin의 탐구

에피소드 10: 위대한 사전 렌더링 임무 - 커스텀 SSR 및 SSG 마스터리를 향한 아린의 탐구

---

코덱스의 정적 금고가 조용한 기대감으로 빛나고 있었습니다. 이 금고는 지식의 조용한 수호자였으며, 그 벽에는 사용자의 소환을 기다리는 데이터 두루마리와 빛나는 페이지가 늘어서 있었습니다. 오늘날 Arin은 Codex가 이전보다 더 빠르게 사용자에게 서비스를 제공하는 데 도움이 되는 사전 렌더링된 정적 페이지를 만드는 새롭고 필수적인 기술을 마스터하는 임무를 맡아 이러한 저장소의 문턱에 서 있었습니다.

“아린” 라이프사이클 선장의 목소리가 아치형 방에 울려퍼져 그녀의 시선을 집중시켰다. “오늘은 정적 렌더링의 강력한 기능을 활용하는 방법을 배우게 됩니다. 이는 단지 지식에 관한 것이 아니라 사용자의 요구가 발생하기도 전에 이를 충족할 수 있도록 Codex를 준비하는 것입니다.”

진정한 수비수다운 도전이라 생각한 아린은 결의가 눈빛을 빛냈다. Codex가 페이지를 사전 렌더링하여 요청 시 즉각적인 응답을 보장할 수 있는 시스템을 제작할 때였습니다.

---

1. 아카이브 제작 – MDX를 사용하여 맞춤형 SSG 구축

Captain Lifecycle은 Arin과 함께 Vaults 깊숙한 곳으로 이동했습니다. 데이터로 빛나는 스크롤을 통해 사용자가 필요로 하기 훨씬 전에 렌더링된 스크립트와 페이지를 드러냅니다. “Codex를 준비하려면 지식을 포착하고 이 페이지에 저장하는 방법을 배워야 합니다.” 그는 말했습니다.

Arin의 임무는 분명했습니다. 과거의 이야기와 교훈을 즉시 불러올 수 있는 Codex 블로그용 SSG(정적 사이트 생성) 시스템을 구축하는 것입니다.

1단계: 도구 수집
첫 번째 단계는 Codex에 두루마리(MDX 파일)를 읽고 컴파일할 수 있는 수단을 제공하는 것이었습니다.

npm install fs-extra react react-dom react-dom/server @mdx-js/react @mdx-js/mdx

Arin이 구성 요소를 활성화하자 챔버가 부드럽게 윙윙거렸습니다. 각 설치는 금고의 기반 시설에 새겨진 룬과 같았으며, 고대 문서를 해석하고 렌더링할 준비를 했습니다.

2단계: 첫 번째 MDX 스크롤 작성
Arin은 깃펜을 집어 대화형 React 구성 요소로 엮은 Codex의 첫 번째 블로그를 작성하기 시작했습니다.

// blogs/hello-world.mdx
# Hello, World!

Welcome to Codex’s first blog post. This content is rendered from an MDX file, combining the simplicity of Markdown with the power of React components.

<specialnote>This is a special React component embedded within MDX!</specialnote>

획을 긋을 때마다 페이지가 빛나고 이제 내용은 단순한 텍스트와 복잡한 구성 요소가 혼합되어 있습니다.

3단계: 스크롤 렌더링을 위한 스크립트 생성
Arin은 두루마리를 읽고 이를 React 구성 요소로 컴파일하고 정적 HTML로 렌더링하는 스크립트인 주문을 만들었습니다.

// generateStaticBlogs.js
const fs = require('fs-extra');
const path = require('path');
const React = require('react');
const ReactDOMServer = require('react-dom/server');
const { MDXProvider } = require('@mdx-js/react');
const mdx = require('@mdx-js/mdx');

const outputPath = './static-blogs';
const blogPath = './blogs';

(async () => {
  try {
    // Ensure the output directory exists
    await fs.ensureDir(outputPath);

    const blogFiles = await fs.readdir(blogPath);
    for (const file of blogFiles) {
      if (path.extname(file) === '.mdx') {
        const filePath = path.join(blogPath, file);
        const content = await fs.readFile(filePath, 'utf8');
        const compiledMdx = await mdx(content);
        const Component = new Function('React', compiledMdx)(React);

        // Render the component to a static HTML string
        const renderedBlog = ReactDOMServer.renderToString(
          <mdxprovider>
            <component></component>
          </mdxprovider>
        );

        const htmlTemplate = `
          
          
            
              <meta charset="UTF-8">
              <meta name="viewport" content="width=device-width, initial-scale=1.0">
              <title>${path.basename(file, '.mdx')}</title>
            
            
              <div>



<p><strong>Step 4: Running the Spell</strong><br>
Arin murmured the incantation to invoke the script.<br>
</p>

<pre class="brush:php;toolbar:false">node generateStaticBlogs.js

그녀는 정적 저장소가 살아 움직이는 것을 지켜보았습니다. 각 블로그는 사용자에게 제공할 준비가 된 정적 페이지로 변하면서 부드럽게 빛났습니다.

아린의 반성:
“이 정적인 페이지는 단순한 메아리 그 이상입니다.” 금고가 지식으로 반짝이는 것을 보면서 그녀는 생각했습니다. “즉각적이고 흔들리지 않는 서비스를 제공할 준비가 되어 있는 Codex입니다.”

---

2. 정적 대비의 장점과 단점

Captain Lifecycle의 목소리가 공기를 가르며 들립니다. “기억하세요, Arin, 정적 페이지는 강력하지만 그에 따른 절충점이 있습니다.”

장점:

• 매우 빠른 로드 시간: 사전 렌더링된 페이지가 즉시 제공되어 사용자에게 원활한 속도를 선사합니다.
• SEO 숙달: 완전히 렌더링된 HTML은 Codex의 스토리가 잘 색인화되어 가시성을 확보하도록 보장합니다.
• 개발자 친화적: MDX를 사용하면 풍부한 React 구성 요소가 Markdown과 나란히 작동하여 단순성과 상호 작용성을 혼합할 수 있습니다.

단점:

• 재구축: 업데이트를 위해 Codex의 페이지를 재구축해야 하므로 동적 콘텐츠를 관리하기가 더 어렵습니다.
• 초기 구축 시간: 대용량 콘텐츠 아카이브는 생성하는 데 시간이 걸릴 수 있습니다.

"아린, 아카이브를 만드는 것과 같다" 캡틴 라이프사이클은 "새로운 이야기가 쓰여질 때마다 관리하고 업데이트해야 하는 것"이라고 말했습니다.

---

3. 증분 정적 재생 – 적응형 키퍼

“하지만 캡틴” 아린은 “만약 Codex가 모든 것을 다시 쓰지 않고 스토리를 새로 고쳐야 한다면 어떨까?”

라고 생각하면서 미간을 찌푸렸습니다.

Captain Lifecycle은 고개를 끄덕였습니다. "여기서 증분 정적 재생이 사용됩니다. 필요에 따라 콘텐츠를 업데이트하여 전체 아카이브를 다시 만들지 않고도 페이지를 최신 상태로 유지하는 키퍼입니다."

Node-Cron을 사용한 예약된 ISR의 예:
페이지를 최신 상태로 유지하기 위해 Arin은 설정된 간격으로 실행되는 수호 주문을 도입했습니다.

npm install fs-extra react react-dom react-dom/server @mdx-js/react @mdx-js/mdx

// blogs/hello-world.mdx
# Hello, World!

Welcome to Codex’s first blog post. This content is rendered from an MDX file, combining the simplicity of Markdown with the power of React components.

<specialnote>This is a special React component embedded within MDX!</specialnote>

아린의 인사이트:
“ISR을 사용하면 Codex는 단순히 반응하는 것이 아니라 적응합니다.” 그녀는 준비가 되어 있다고 생각했습니다. “사용자는 항상 최신 버전의 Codex를 찾을 수 있으며 안내할 준비가 되어 있습니다.”

---

결론: 사명을 넘어서

Vaults는 아린이 엮은 지식으로 고요하고 빛나고 있었습니다. 라이프사이클 선장은 그녀의 어깨에 손을 얹었고 그의 눈에는 자부심이 뚜렷했습니다. “Codex의 본질을 미리 렌더링하는 방법을 배웠습니다. 하지만 이를 더욱 쉽게 만들어주는 우리의 영역 너머에 있는 도구가 있다는 것을 기억하세요.”

아린은 앞으로 나아갈 길을 이해하며 고개를 끄덕였습니다. “Codex를 위해, 사용자를 위해 준비하고 적응하며 항상 봉사합니다.”

---

독자를 위한 중요 참고사항:

여기에 제공된 예는 맞춤형 SSR 및 SSG를 이해하기 위한 기본적인 접근 방식입니다. 프로덕션 수준 애플리케이션의 경우 사전 렌더링을 위한 최적화되고 안전하며 확장 가능한 솔루션을 제공하는 Next.js, Remix 및 Astro와 같은 프레임워크를 살펴보세요.