Hedley

Stay Hungry, Stay Foolish.

Octopress 搭建记录

本文是小站搭建的流水账记录,收集了各种用到的链接地址。

搭建

  • 参照 octopress 官方搭建手册,一步一步来。到 gem install bundler 时候卡壳,网络不通
  • 修改 RubyGems 镜像,连接通了。但是一直报缺少依赖包的异常,按照提示手动一个个安装完依赖包
  • 安装完毕,修改 _config.yml 配置文件

留言系统

  • 参照这篇文章添加多说评论
  • 修改多说样式,样式代码添加在多说系统的管理后台的基本设置里。代码位于 source/downloads/code/duoshuo.css

访问速度

参照这篇文章替换若干 google 源。

ST 书写插件

  • Octopress : 可以在 ST 中快捷新建 Post ,快捷生成、部署
  • Octopress SnippetsCMD + SHIFT + P 接输入 Snippet ,调用语法模板
  • Markdown ExtendedCMD + SHIFT + P 接输入 Set Syntax ,设为 Markdown Extended。代码片段彩色显示
  • Markdown Preview : 主要用到 Preview in browser 来进行静态预览,以及 cheat sheet 来查看语法
  • Monokai NeueColor Scheme 修改, Markdown 颜色显示。修改 Packages/Monokai Neue /Monokai-Neue.tmTheme 文件,在 settings -> settings 代码段下修改 <key>selection</key> <string>#00B2EE</string>,更改选中背景颜色

效果如下

TOC (Table of Contents)

参照这篇文章搭建 TOC 解决方案。遇到几个问题

  • 如果 TOC 的左面有 blockquoteTOClink 无法点击
    • sass/custom/_screen.scss 中加入代码 position:relative; z-index: 99999; ,将 TOC<div> 置顶
  • 自动生成的锚点只对英文标题有效
    • 编辑 source/javascripts/jquery.tableofcontents.min.js ,搜索 text.toLowerCase().replace ,去掉 .replace(/[^a-z0-9 -]/gi,'') 这部分代码,这句代码过滤了中文字符
  • 此方案的 TOC 只能生成 h1 ~ h3 ,它的配置可以在 source/javascripts/jquery.tableofcontents.min.js 中修改。但是为了方便,应用此默认配置,修改标题风格

风格

生成网页的风格个性化都在 sass/custom 中进行定义,参考了 https://github.com/bmc/brizzled ,主要对标题的字体大小进行了调整,其他一些微调待定。标题的字体颜色主要在 source/_includes/custom/header.htmlsass/custom/_fonts.scsssass/custom/_styles.scss 几个地方相应修改。其他样式对应位置参考这里

其他

  • 链接在新窗口打开、列表排版、404ERROR 公益页面,参考这篇文章
  • 文章分类侧边栏、导航栏设置,参考这篇文章
  • 其他配置很全,重点参考

原文链接

参照这篇文章,在每篇文章下面自动生成作者信息,原文信息。

  • 注意:每篇文章最后要有留白行,否者生成的原文信息会有问题。

云标签

  • 参照 Tag Cloud 搭建clone 几个文件到本地目录
  • 使用方法:在文件头添加标识 tags: xxx ,但此时无法添加多个标签
  • 这篇文章给出了解决方案,修改 tags.html 文件去掉 limit 属性,多标签写法 tags: [xx1, xx2]

回到顶部

参考Octopress添加回到顶部功能

数学公式

参考kramdown配置