littlebot
Published on 2025-04-09 / 0 Visits
0

【源码】基于 Ruby 和 Jekyll 的博客主题及调试插件项目

项目简介

本项目包含两部分。一是 Jekyll-Jacman 主题,它是从 Hexo Jacman 移植而来的 Jekyll 主题,风格清新且具有响应式特点,具备丰富特性并支持众多国内服务。二是 DebugGem 插件,这是专门为 Jekyll 设计的 Ruby 插件,能帮助开发者在 Liquid 模板中便捷地进行调试。

项目的主要特性和功能

Jekyll-Jacman 主题

  • 图片设置:可设置网站图标、logo、作者头像、博客顶部大图等,有多种图片样式。
  • 首页模式:具备两种首页展示模式。
  • 作者信息:在网站右下角展示涵盖微博、豆瓣等多种平台的社交网络链接。
  • 目录显示:文章中和侧边栏均可显示目录。
  • 评论与分享:支持多说和 disqus 评论,可启用内建分享工具或加网分享系统。
  • 网站统计:支持谷歌统计、百度统计和 CNZZ 站长统计。
  • 搜索功能:支持谷歌自定义搜索、百度站内搜索、微搜索和 Simple Jekyll Search。
  • 其他功能:包含回到顶部、RSS 订阅链接、图片查看工具 Fancybox,可设置侧边栏在博文页面不显示。

DebugGem 插件

  • 调试过滤器:提供debug过滤器,用于在 Liquid 模板中打印和返回对象详细信息。
  • 对象重写:重写 Post 和 Page 对象的inspect方法,使输出更直观。
  • 输出格式:使用 Ruby 的 pretty - print 库,以易读方式输出对象,在模板中使用时返回 HTML 格式字符串。

安装使用步骤

Jekyll-Jacman 主题

  1. 确保已安装Ruby 2.1.0或更高版本: sh ruby --version
  2. 安装Bundlersh gem install bundler
  3. 下载 Jacman 主题: sh cd jekyll-jacman
  4. 安装依赖: sh bundle install
  5. 运行 Jekyll: sh bundle exec jekyll server

DebugGem 插件

  1. 下载与安装:复制或下载本项目文件至你的 Jekyll 项目目录。
  2. 配置:在你的 Jekyll 项目的_config.yml文件中添加必要的配置(如有需要)。
  3. 使用:在你的 Liquid 模板中,使用{{ variable | debug }}的形式来调试你的数据结构和变量。

注意:DebugGem 插件主要用于开发和调试阶段,不建议在生产环境中使用,使用时需确保了解所调试的数据结构和变量,避免泄露敏感信息或导致页面显示异常。

下载地址

点击下载 【提取码: 4003】【解压密码: www.makuang.net】