Octopress 是为 Jekyll 设计的框架,Jekyll 是为 Github Pages 提供支持的静态博客引擎。
自从我接触到 Octopress 以来,我的喜悦是无限的,因为使用它创建博客非常容易。随着Octopress 3的发布,事情变得更加激动人心。Octopress 3 包含旨在解决先前版本缺点的功能。新创建的 Octopress CLI 允许你轻松创建新站点、创建新页面、添加帖子和部署。
在本文中,我们将创建一个简单的博客,添加一个帖子和一个页面。在此过程中,我们还将看到如何启用共享到 Twitter 并将所有内容部署到 Github。
Octopress揭幕
首先,安装 Octopress gem。从你的终端:
这样就安装了 Octopress!我喜欢 Ruby 和 Rubygems!
博客创建
使用新的 Octopress CLI 命令可以轻松启动和运行。导航到你的工作目录并运行以下命令:
这将创建一个名为kinsomicrote的目录,其中包含网站的脚手架。将“kinsomicrote”替换为你想要给博客起的任何名字。导航到新创建的目录并打开文本编辑器以查看你拥有的内容。文件和文件夹应采用以下树格式:
创建帖子
我们可以使用 Octopress CLI 命令之一创建新帖子:
此命令创建一个新的博客文章,标题为Welcome Aboard。显然可以使用你选择的任何标题。帖子创建在_posts目录中。当在文本编辑器中打开这个新的帖子文件时,它应该看起来像我下面的样子:
默认情况下,帖子将被编写为markdown文件。
Front matter 允许使用 YAML 或 JSON 将特定于页面的变量包含在模板的顶部。Front matter 必须位于模板的最顶部,并通过前导和尾随的三重连字符---与其余内容分开。在这些三重虚线之间,你可以设置预定义和自定义变量,例如类别、标签和永久链接。
查看网站
在可以查看站点之前,必须先构建它。由于 Octopress 是 Jekyll 的包装器,我们将使用下面的命令来构建:
这将构建一个可以在_site目录中找到的静态 HTML 网站。这是由页面、帖子、样式表和配置的markdown文件构建的。
要查看站点,可以在终端运行以下命令:
然后,将你的浏览器指向地址localhost:4000。
创建新页面
Octopress 带有一个默认About页面,可以从你的浏览器中看到http://localhost:4000/about/。该页面可以在你站点的主目录中找到。当你使用jekyll build生成网站时,会为该about页面创建一个文件夹。导航到_site/about目录,你将看到生成的页面。
有一个 Octopress CLI 命令可用于创建类似于创建新帖子所用的新页面。
这将在你的应用程序的主目录中创建一个新页面。创建的文件如下所示:
如果愿意,可以输入页面标题。
你可以在 YAML 格式内容下方输入页面内容。与帖子的情况一样,内容以 markdown 格式编写。你还可以选择创建页面的路径。例如:
这将创建一个名为news的新目录,并在其中创建一个index.md文件。当你运行jekyll buildor或jekyll serve时,将创建一个.html文件。当站点重新加载时,页面的链接会自动显示在导航栏中。
配置
Octopress 有一个配置文件,你可以在其中管理网站的设置。这是位于站点主目录中的_config.yml文件。下面是它的一个示例:
从配置文件中,可以添加你的 Twitter 和 Github 用户名。它们将与说明一起显示在页面的底部。通过添加必要的信息,你可以根据需要随意编辑设置。你必须重新启动服务器才能使配置更改显示在浏览器中,通过按 CTRL+C 停止服务器。
如果你想获得大量受众,将你的博客文章分享到 Twitter 等社交媒体非常重要。幸运的是,Octopress 上有一个 gem 可以让这成为可能。出于本文的目的,我们将重点关注 Twitter。
在站点的主目录中创建一个Gemfile 。可以使用你的终端来执行此操作,如下所示:
打开_config.yml并添加以下内容:
其他设置可以保留为默认值。
要使用 Twitter 分享按钮,请导航到你网站的默认布局并将此标签添加到结束标签的正下方。
如果希望 Twitter 共享按钮显示在每个帖子上,请导航至_layouts/post.html并将其添加到content标签下方。
如果需要,对页面执行相同的操作,重新加载浏览器查看按钮。
还有其他可用设置,可以在Octopress Social查看。
部署到 GitHub 页面
我们将在 GitHub 上托管我们的博客。如果还没有帐户,先要创建一个。
打开你的终端并初始化 git。注意将用户名替换为你在 Github 上的用户名:
使用octopress deploy init命令为我们的博客生成部署配置文件。
这会生成一个名为_deploy.yml的文件,其中包含部署配置:
现在开始部署!
完成后,你的网站应该就可以使用了!
结论
现在你知道如何使用 Octopress 3 设置博客了。Octopress 3 带来了很多令人兴奋的东西。你可以更深入地研究 Octopress 的其他功能!
领取专属 10元无门槛券
私享最新 技术干货