返回

在gitee上使用docsify构建你的个人博客，一键生成静态文档网站

后端

轻松搭建个人博客：使用 Docsify 生成文档网站

作为一名内容创作者，创建一个美观且内容丰富的个人博客至关重要。Docsify，一个轻量且用户友好的文档网站生成器，可以轻松实现这一目标。本文将逐步指导您完成使用 Docsify 搭建个人博客的整个过程。

准备工作

搭建一个 Docsify 博客需要以下准备工作：

  • Gitee 账户
  • 支持 Git 的本地编辑器（例如 Visual Studio Code、Sublime Text）

创建 Docsify 博客

  1. 创建 Gitee 仓库： 创建一个新的 Gitee 仓库，并克隆到您的本地计算机。
  2. 创建 Docsify 文件夹： 在克隆的本地仓库中，新建一个名为“docsify”的文件夹。
  3. 创建 index.html 文件： 在“docsify”文件夹中，新建一个名为“index.html”的 HTML 文件，并粘贴以下代码：
<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <link href="https://unpkg.com/docsify/lib/themes/vue.css" rel="stylesheet" />
  </head>
  <body>
    <div id="app"></div>
    <script src="https://unpkg.com/docsify/lib/docsify.min.js"></script>
    <script>
      var docsify = new Docsify({
        el: '#app',
        repo: '你的gitee仓库地址',
        branch: 'master',
        root: 'docsify'
      })
    </script>
  </body>
</html>
  1. 创建 docs 文件夹和 Markdown 文件： 在“docsify”文件夹中，新建一个名为“docs”的文件夹，并在其中创建 Markdown 文件，作为您的博客文章。

提交代码并访问博客

  1. 提交代码： 将代码提交到您的 Gitee 仓库。
  2. 访问博客： 在 Gitee 上访问您的仓库，即可看到您的博客网站。

自定义主题

Docsify 允许您通过修改 CSS 样式或安装第三方主题来自定义博客的主题。

部署到其他平台

除了 Gitee，您还可以将博客部署到其他支持静态网站的平台，如 GitHub Pages、Vercel 和 Netlify。

常见问题解答

  1. 如何添加新博客文章？
    在“docs”文件夹中创建新的 Markdown 文件，并提交到 Gitee 仓库。
  2. 如何修改博客主题？
    在“index.html”文件中修改 CSS 样式或安装第三方主题。
  3. 如何部署到其他平台？
    按照相关平台的部署说明进行操作。
  4. 如何添加代码示例？
    在 Markdown 文件中，使用 Markdown 的代码块功能来添加代码示例。
  5. 如何添加图片或视频？
    在 Markdown 文件中使用 Markdown 的图片或视频语法来添加图片或视频。

结论

使用 Docsify，您可以轻松、快速地搭建一个美观且内容丰富的个人博客。本文提供的逐步指南将帮助您快速入门，并开始分享您的思想和见解。如果您还有其他问题，请随时访问 Docsify 官方文档或社区论坛以寻求帮助。