使用 DEVto API 在 Nextjs 中获取博客文章

php中文网 2024-10-15 11:46:24

如果您想在 next.js 网站上展示您的 dev.to 博客文章，那么您很幸运！ dev.to 提供了一个易于使用的 api，可让您以编程方式获取博客文章。在本指南中，我将向您展示如何将 dev.to 的 api 集成到您的 next.js 应用程序中并动态显示您的博客内容。

让我们开始吧！

1. 设置 next.js 项目

首先，如果您还没有设置一个新的 next.js 项目，请运行：

npx create-next-app@latest my-dev-blog
cd my-dev-blog

现在我们已经准备好了 next.js 应用程序，让我们继续获取我们的博客文章。

2. 从 dev.to api 获取博客文章

dev.to api 通过简单的 http 请求提供对您发布的文章的访问。您可以通过点击端点来按用户获取文章：

https://dev.to/api/articles?username=yourusername

为了获取 next.js 应用中的博客文章，我们将使用 swr 库。 swr 是一个流行的数据获取库，旨在让您在 react/next.js 应用程序中轻松获取、缓存和更新数据。

安装 swr：

npm install swr

现在，让我们创建一个实用函数来处理 api 请求：

// src/lib/fetcher.ts
export default async function fetcher(url: string) {
  const response = await fetch(url);
  if (!response.ok) {
    throw new error("failed to fetch data");
  }
  return response.json();
}

3. 创建博客页面

现在我们有了 fetcher 实用程序，让我们创建一个博客页面来显示您的 dev.to 帖子。

在pages/blog/index.tsx中，使用swr获取并显示博客文章：

import { container, row, col, card, button, badge } from 'react-bootstrap';
import head from 'next/head';
import useswr from 'swr';
import fetcher from '../../lib/fetcher';
import link from 'next/link';
import { formatdistancetonow, parseiso } from 'date-fns';

interface blogpost {
  id: number;
  title: string;
  description: string;
  slug: string;
  cover_image: string;
  tag_list: string[];
  reading_time_minutes: number;
  published_timestamp: string;
  positive_reactions_count: number;
}

const blog = () =&gt; {
  const { data, error } = useswr<blogpost>('https://dev.to/api/articles?username=yourusername', fetcher);

  if (error) return <div>failed to load posts</div>;
  if (!data) return <div>loading...</div>;

  return (
    
      
        <title>blog | your name</title>
<container><row><col>
<h1>blog</h1>
            <row classname="g-4">
              {data.map((post: blogpost) =&gt; (
                <col md="{4}" key="{post.id}">
<card classname="blog-card" data-aos="fade-up"><card.body><card.title>{post.title.length &gt; 50 ? `${post.title.substring(0, 50)}...` : post.title}</card.title><card.text>{post.description}</card.text><div classname="mb-2">
                        {post.tag_list.map((tag: string) =&gt; (
                          <badge pill bg="secondary" classname="me-1" key="{tag}">
                            {tag}
                          </badge>
                        ))}
                      </div>
                      <div classname="text-muted">
                        <small><i classname="fa-solid fa-clock"></i> {post.reading_time_minutes} min read</small><br><small><i classname="fa-solid fa-calendar-day"></i> {formatdistancetonow(parseiso(post.published_timestamp), { addsuffix: true })}</small><br><small><i classname="fa-solid fa-thumbs-up"></i> {post.positive_reactions_count} likes</small>
                      </div>
                      <link href="%7B%60/blog/%24%7Bpost.slug%7D%60%7D" passhref>
<button variant="outline-primary" classname="mt-3">read more</button>
                      
                    </card.body></card>
              ))}
            </row></row></container>&gt;
  );
};

export default blog;
</blogpost>

4. 添加动态博客页面

next.js 提供动态路由，允许您为每个博客文章生成单独的页面。让我们创建一个动态路由来显示每个帖子。

创建一个名为pages/blog/[slug].tsx的文件：

import { userouter } from 'next/router';
import useswr from 'swr';
import { container, row, col, card, button } from 'react-bootstrap';
import head from 'next/head';
import image from "next/image";
import fetcher from '../../lib/fetcher';

const blogpost = () =&gt; {
  const router = userouter();
  const { slug } = router.query;

  const { data, error } = useswr(slug ? `https://dev.to/api/articles/yourusername/${slug}` : null, fetcher);

  if (error) return <div>failed to load the post</div>;
  if (!data) return <div>loading...</div>;

  return (
    
      
        <title>{data.title} | your name</title><container><row><col>
<div classname="section-title">
              <h1>{data.title}</h1>
              <p>{data.readable_publish_date}</p>
            </div>
            <section>
              {data.cover_image &amp;&amp; (
                <image src="%7Bdata.cover_image%7D" alt="{data.title}" classname="img-fluid mb-3" width="{1000}" height="{420}" layout="responsive"></image>
              )}
              <div dangerouslysetinnerhtml="{{" __html: data.body_html></div>
            </section><button variant="outline-dark" href="/blog">
              back to blog
            </button>
          
        </row></container>&gt;
  );
};

export default blogpost;

此页面使用 url 中的 slug 获取各个帖子，并使用angerouslysetinnerhtml 安全地使用 html 内容呈现它们。