首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

Octopress 3:让博客生成异常简单

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 的其他功能!

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20230227A02AGW00?refer=cp_1026
  • 腾讯「腾讯云开发者社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 cloudcommunity@tencent.com 删除。

扫码

添加站长 进交流群

领取专属 10元无门槛券

私享最新 技术干货

扫码加入开发者社群
领券