如果您想在 next.js 网站上展示您的 dev.to 博客文章,那么您很幸运! dev.to 提供了一个易于使用的 api,可让您以编程方式获取博客文章。在本指南中,我将向您展示如何将 dev.to 的 api 集成到您的 next.js 应用程序中并动态显示您的博客内容。
让我们开始吧!
首先,如果您还没有设置一个新的 next.js 项目,请运行:
npx create-next-app@latest my-dev-blog cd my-dev-blog
现在我们已经准备好了 next.js 应用程序,让我们继续获取我们的博客文章。
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(); }
现在我们有了 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 = () => { 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) => ( <col md="{4}" key="{post.id}"> <card classname="blog-card" data-aos="fade-up"><card.body><card.title>{post.title.length > 50 ? `${post.title.substring(null, 50)}...` : post.title}</card.title><card.text>{post.description}</card.text><div classname="mb-2"> {post.tag_list.map((tag: string) => ( <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>> ); }; export default blog; </blogpost>
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 = () => { 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 && ( <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>> ); }; export default blogpost;
此页面使用 url 中的 slug 获取各个帖子,并使用angerouslysetinnerhtml 安全地使用 html 内容呈现它们。
您现在可以通过运行以下命令启动 next.js 应用程序:
npm run dev
访问 /blog 路线,您应该会看到显示您的 dev.to 博客文章。单击任何帖子都会将您带到单个博客帖子页面。
您可以随意进一步自定义此设置、添加分页或改进样式以匹配您网站的设计!
如果您有任何问题或建议,请在评论中告诉我。