mouse icon indicating copy to clipboard operation
mouse copied to clipboard

a beautiful ghost theme

Mouse, just another ghost theme

总览

Mouse 是一个从 [OneV's Den] (https://github.com/onevcat/vno) 派生出的 Ghost 主题。它遵从简洁和响应式的设计风格,拥有一个独立的封面,易于集成的 Disqus 评论系统,字体图标以及多种颜色。

我在原来的基础上对一些布局配色做了稍微的修改。

特性

封面

主题有一个全屏的带有模糊(和半透明)效果的封面页,您可以选择喜欢的颜色,当然也可以添加您自己喜欢的颜色。您可以在封面页上放置头像,博客名字,简介以及社交网络导航等等。

响应式设计和动画

Mouse 遵循响应式设计,所以应该能在各种设备上都表现良好。很多事件是由动画驱动的,这要感谢 Animate.css 的帮助。

Disqus 评论系统和 Font Awesome 字体

如果您打算使用 Disqus 的话,集成评论系统就只是填一个用户名那么简单。您也可以使用 Font Awesome 的图标字体来获得更好的表现。这些不仅对于个人站点 (比如博客) 来说是很好的选择,对于一些商用的 CMS (内容管理系统) 来说也是不错的解决方案。

使用

安装

您应该已经建立了一个可用的 ghost 博客。如果您还没有准备好,请参考官方的安装页面来配置一个属于您自己的 ghost 博客。

一旦您准备就绪,只需要将这个 repo clone 到您博客的主题文件夹下:content/themes/,然后重启 ghost,您应该就能在博客的设定面板中看到 mouse 了。

封面

图片和颜色

将您的封面图片放到主题的 assets/images/ 下,替换掉原来的 background-cover.jpg 文件即可。您也可以改变封面的颜色。找到 partials/side-panel.hbs 文件,将 <div class="panel-cover--overlay cover-orange"></div> 中的 cover-orange 替换成您需要的颜色即可。默认为您提供了七种选择:

  • cover-blue - #2568A3
  • cover-green - #156F78
  • cover-purple - #493252
  • cover-red - #E25440
  • cover-orange - #FB9C50
  • cover-slate - #3D4260
  • cover-disabled - 透明

头像和简介

头像直接使用了您的博客的 logo。在博客的设定页面中可以进行更改。

您还可以在封面页上写一个简短的介绍。只要您瞄一眼 partials/side-panel.hbs 应该就知道怎么做了 :)

导航按钮

也在 partials/side-panel.hbs 文件中定义。不要忘了把它们换成您自己的链接。您不应该更改或者至少保留 /#blog 链接,因为这个链接将触发一个转场到您的博客主页面的动画。

社交按钮

可以在 partials/social.hbs 中按照例子将社交网络的按钮替换成您需要的链接和图标。图标都来自 Font Awesome,您可以访问它们的网站来查看您能使用的所有图标。

Disqus

为了使用 Disqus 的评论系统,您需要从 Disqus 获取您自己的 short name。将其添加到 comments.hbsdisqus_shortname 中就可以了。然后您还需要将 post.hbs 中的 {{!-- {{> comments}} --}} 替换为 {{> comments}} 来使 Disqus 生效。

代码高亮主题

Mouse 使用经典的 tomorrow 主题作为默认的代码高亮配色。您也可以选择和使用您最喜欢的配色,将配色文件直接放到 assets/css 文件夹下, 然后将 default.hbs 中的 css/tomorrow.css 改为您的文件来使配置生效。想要更多的配色方案的话,可以看看这个站点

开发

为了简单地对主题进行修改和开发,您需要安装 sass 编译器以及 bourbon。如果您在本地有 ghost 环境的话,这些应该已经安装好了,因为 ghost 运行是需要这些部件的。

您可以在终端中进行一些检查,来看看是否已经安装完成。如果没有问题的话,您应该可以在命令行后看到对应的工具的版本号。

SASS

sass -v
> Sass 3.3.6 (Maptastic Maple)

如果 SASS 没有能正确安装的话,请参见 Sass 安装页面进行安装。

Bourbon

bourbon version
> Bourbon 4.0.1

如果 Bourbon 没有能正确安装的话,请参见 Bourbon 的网站进行安装。

开始开发

验证安装后就可以开始开发了。首先我们要将 bourbon 加载到 scss 文件夹里。

在主题文件夹下执行 bourbon install 来加载 bourbon:

bourbon install --path assets/scss
> bourbon files installed to assets/scss/bourbon/
//Or "Bourbon files already installed, doing nothing." if you already installed it.

然后就可以使用 sass 的命令行工具来监视文件夹中的 scss 文件的改动,并自动重新编译了。

pwd
> In the mouse theme root folder: {blog_path}/content/themes/mouse

sass --watch assets/scss/vno.scss:assets/css/vno.css
>>>> Sass is watching for changes. Press Ctrl-C to stop.

现在,任何对于 scss 文件的改动都将自动反映到最终的 /css/vno.css 文件中了。

OSX Maverick

有些人在运行 sass --watch 时可能会遇到如下错误:

> LoadError: cannot load such file -- rb-fsevent
  Use --trace for backtrace.

这是一个 Sass 在 OSX Maverick 下的已知问题,新版本中应该已经修复。请尝试将 Sass 升级到最新版本,或者安装 rb-fsevent 这个gem:

gem install rb-fsevent

祝你好运

玩得开心,也请记得给我反馈。如果您发现了什么 bug (我刚入门 web 开发,这简直是必然的),请直接指出,如果还能附带一个 pull request 修正的话,那真的感激万分!

如果您觉得这个主题还不错的话,欢迎加颗星星或者 follow 我一下以示支持,这将对我和我的项目的发展提供不可估量的帮助。再次感谢。

许可

Mouse 遵循 Uno 的要求按照 Creative Commons Attribution 4.0 International 进行授权。点击上面的链接可以了解到更多信息。

技术支持