npm包 @rrpm/netlify-cms-backend-github 使用教程

阅读时长 5 分钟读完

简介

@rrpm/netlify-cms-backend-github 是一个用于将 Netlify CMS 与 Github 后端进行连接的 npm 包。它可以帮助我们快速的搭建一个可视化编辑的 CMS 系统,并将数据保存在 Github 后端。

在本文中,我们将介绍如何使用 @rrpm/netlify-cms-backend-github 包,在 Github 后端上搭建一个可视化编辑的 CMS。你将学到如何配置和使用 @rrpm/netlify-cms-backend-github 包,以及如何将它与 Github 后端进行连接。

准备工作

在使用 @rrpm/netlify-cms-backend-github 前,我们需要提前准备好以下几个内容:

  • Github 账号,并创建一个空的仓库(例如:my-cms)。
  • 一个可编辑的静态站点,可以使用 create-react-app 创建一个新的 React 应用。

安装和配置

安装

使用 npm 安装 @rrpm/netlify-cms-backend-github

配置

在 React 应用中,我们需要在 index.js 文件中引入 @rrpm/netlify-cms-backend-github 包,并进行基本的配置:

-- -------------------- ---- -------
------ ----- ---- --------
------ -------- ---- ------------
------ --- ---- --------
------ --- ---- -----------------------------------

----------
-------- -
----- ---------
----- -------------------------
------- ---------
--
---
-------------------- --- ---------------------------------

backend.name 参数为 github,表示我们要使用 Github 作为后端存储数据。

backend.repo 参数为 github-username/my-cms,其中 github-username 是你的 Github 用户名,my-cms 是你创建的 Github 仓库名称。通过这个参数,我们将编辑的内容存储在 my-cms 仓库中。

backend.branch 参数为 Github 仓库的分支名称,通常情况下为 master

我们还需要在 public/index.html 文件中引入 Netlify CMS 的 CSS 和 JS 文件:

-- -------------------- ---- -------
--------- -----
----- ----------
------
----- --------------- --
----- --------------- ---------------------------- ------------------ --
--------- -----------
----- ---------------- ------------------------------------------------------------ --
-------
------
---- ----------------
------- --------------------------------------------------------------------
-------
-------

使用

在 React 组件中,我们需要使用 Netlify CMS 的 React 组件,并在需要编辑的组件中添加 withRoute 方法:

-- -------------------- ---- -------
------ ----- ---- --------
------ - --------- - ---- -------------------
------ --- ---- -----------------------------------

----- ---- ------- --------------- -
-------- -
------ -
-----
-------------
------- -- --- ---- ---------
------
--
-
-
------ ------- -----------------------------------------------

在组件中,我们通过 withRoute 方法将路由信息注入到组件中。然后使用 CMS.getWidgetLoader 方法,来添加编辑器组件。在上面的例子中,我们添加了一个 string 类型的编辑器组件。

示例代码

以下是一个完整的示例代码:

-- -------------------- ---- -------
------ ----- ---- --------
------ - --------- - ---- -------------------
------ --- ---- -----------------------------------

----- ---- ------- --------------- -
-------- -
------ -
-----
-------------
------- -- --- ---- ---------
------
--
-
-
------ ------- -----------------------------------------------

----- --- - -- -- -
------ ----- ---
--

------ ------- ----

----------
-------- -
----- ---------
----- -------------------------
------- ---------
--
---

总结

通过本文的介绍,我们学习了如何使用 @rrpm/netlify-cms-backend-github 包,将 Netlify CMS 与 Github 后端进行连接。这个过程中,我们需要进行包的安装和基本配置,并在 React 组件中使用 Netlify CMS 组件进行编辑器的添加。

在实际的开发过程中,我们可以根据自己的需求,使用不同的编辑器组件来满足不同的需求。同时,我们也需要对 Github 后端进行一些基本的权限和配置控制,以保证数据的安全性和稳定性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066efe4c49986ca68d8b38

纠错
反馈