Jekyll GDrive插件使用教程

Jekyll GDrive插件使用教程

jekyll-gdriveAccess a Google Drive Spreadsheet from your Jekyll templates项目地址:https://gitcode.com/gh_mirrors/je/jekyll-gdrive

项目介绍

Jekyll GDrive插件允许你在Jekyll静态站点中轻松接入Google Drive中的电子表格数据。这个开源项目实现了与Google Sheets的无缝连接，使你能够利用简化的配置来展示动态内容，如项目进度、团队成员名单、教程大纲或是任意需要实时更新的信息。它具备缓存功能以提高性能，同时确保通过安全的API凭据访问数据。

项目快速启动

步骤一：添加至Gemfile

首先，在你的Jekyll项目的Gemfile中，加入以下行以添加此插件到你的开发环境：

group :jekyll_plugins do
  gem 'jekyll-gdrive'
end

之后，执行安装命令：

bundle install

步骤二：配置API凭证

安装插件后，运行以下命令并遵循提示创建Google开发者控制台的应用程序，以获取刷新令牌：

bundle exec jekyll gdrive

获取到令牌后，将其作为环境变量设置：

export GDRIVE=<client_id>:<client_secret>:<your_gdrive_token>

步骤三：配置Jekyll配置文件

编辑_config.yml，指定你要使用的Google电子表格名称：

gdrive:
  sheet: "你的电子表格标题"

应用案例和最佳实践

• 个人博客：展示项目里程碑和统计数据。
• 团队协作：分享最新团队成员信息、项目状态更新。
• 教育材料：构建动态课程表、习题集。
• 数据公示：实时数据显示，如天气、股市。

在Liquid模板中，你可以这样访问电子表格数据：

<table>
  <thead>
    {% for row in site.data.google_sheet limit:1 %}
      <tr>
        {% for col in row %}
          <th>{{ col }}</th>
        {% endfor %}
      </tr>
    {% endfor %}
  </thead>
  <!-- 表格主体数据可以用类似方式循环遍历 -->
</table>

典型生态项目

虽然本插件是独立的，但可以与其他Jekyll生态系统中的插件结合使用，比如SEO工具或自动化部署服务（如Netlify），以增强你的站点功能和维护流程。结合这些工具，可以创造一个既动态又易于管理的内容发布平台。

---

以上步骤和说明提供了基本的引导，帮助你开始使用Jekyll GDrive插件。记住，对于更复杂的需求或特定场景的应用，参考项目的官方文档总是最好的选择。

jekyll-gdriveAccess a Google Drive Spreadsheet from your Jekyll templates项目地址:https://gitcode.com/gh_mirrors/je/jekyll-gdrive