首页 > 科技周边 > IT业界 > 使用普尔(Poole)在5分钟内建立一个Jekyll博客

使用普尔(Poole)在5分钟内建立一个Jekyll博客

Joseph Gordon-Levitt
发布: 2025-02-20 11:06:11
原创
375 人浏览过

Set Up a Jekyll Blog in 5 Minutes with Poole

使用普尔(Poole)在5分钟内建立一个Jekyll博客

钥匙要点

    Jekyll是用Ruby编写的静态站点生成器,可用于创建简单,易于管理的网站或博客,而无需复杂的数据库。它可以在github页面上免费托管。
  • > Poole被描述为Jekyll站点的“基础设置”,可用于简化设置Jekyll网站的过程。它带有示例模板,页面,帖子和样式以快速入门。
  • >
  • >将新帖子添加到jekyll博客中,涉及将标记文件放置在_posts文件夹中,并确保其在顶部包含适当的YAML前面物质。然后可以通过GitHub页面发布博客,该页面需要对Git的基本了解。
  • >最近,与复杂的,数据库驱动的网站相距甚远,回到了更简单,更静态的站点,当然可行,例如一个简单的投资组合网站或博客。
  • 不过,这并不是说人们正在返回过去的.html网站。您仍然希望能够有效地管理模板和范围的代码,这就是静态站点生成器的所在地。
静态站点生成器旨在将您的各种静态文件带入网站。他们有很多可供选择的地方,并且在Sitepoint上有有关它们的最新文章,涵盖了它们所使用的不同语言,基于节点的选项,它们的潜在优势比WordPress,甚至如何用Grunt滚动。

在本文中,我们将研究Jekyll,这是最受欢迎和广泛使用的。我将描述如何使用最少的编码来构建博客,然后在GitHub页面上免费托管。我们还将利用Poole(一种或“基础设置”)来构建Jekyll网站。 简而言之

Jekyll用Ruby编写。它以红宝石宝石的形式安装在计算机上。它不是CMS,不是博客软件,也不包含模板,内容等。这要简单得多。将其视为一个简单的程序,提供方便的处理文件的方法。

>

>安装了Jekyll后,您可以将其从命令行中使用。它可以执行诸如Process Markdown之类的事情,并且由于它会生成静态站点,因此您可以轻松地在本地查看进度,并在静态网络服务器上托管您的网站。

>安装jekyll

首先,您需要在系统上安装Jekyll。对于Mac,在终端中运行以下命令以安装jekyll:

>这将自动安装Jekyll的所有宝石依赖性。如果您在安装过程中被卡住,请在Jekyll的官方网站上查看故障排除页面,或在Github上提交问题。

>虽然Jekyll在Windows上没有正式支持,但您仍然可以通过一些调整来运行它。请在jekyll网站上的Windows页面上或朱利安·蒂洛(Julian Thilo)的Jekyll。

获得Poole和您的第一台服务器

>不是以原始的jekyll主题开始,让我们使用普尔。它是由马克·奥托(Mark Otto)创建的,这就是他描述的方式:

>

Poole是静态站点生成器Jekyll的管家。它是由@MDO设计和开发的,目的是为任何Jekyll网站提供清晰简洁的基础设置。它通过提供完整的香草jekyll安装示例,页面,帖子和样式来做到这一点。
>

>您可以在此处看到基本版本。尽管它对最小博客来说非常好,但我喜欢在其中建立的两个主题:Hyde和Lanyon。让我们使用Hyde来构建我们的演示博客。

>要获得Hyde的设置,请转到其GitHub页面并下载存储库。将其放入您选择的文件夹中,然后转到终端。假设您将其放在桌面上。运行以下命令移动到该目录并启动服务器:

jekyll服务命令将启动开发服务器,该服务器将允许您在本地浏览器中预览生成的网站。
$ gem install jekyll
登录后复制

要理解我的意思,请在浏览器中打开一个新标签,然后输入:http:// localhost:4000。如果您正确地遵循了所有内容,您会在那里找到新生的博客。

添加新帖子

您刚刚下载的Hyde-Master存储库中包含许多文件夹,例如_layouts,_posts和_includes。但是,如果您想管理博客的帖子:_ posts,您只需要关心一个文件夹。它包含您的所有帖子以降级格式。

>要添加新的博客文章,只需将您的Markdown文件放在_posts文件夹中即可。确保您的Markdown文件在顶部包含以下(称为YAML Front Matters):>

这将告诉Jekyll您正在添加帖子。 (如果您有任何疑问,请检查_ posts文件夹中的示例帖子。)

>

>运行jekyll再次在您的终端服务,如果您打开http:// localhost:4000。

要确保正确构建博客,jekyll需要此命名约定:
$ cd Desktop/hyde-master/

$ jekyll serve
登录后复制

年是一个四位数的数字,月和一天都是两位数的数字,标记是代表文件中使用的格式的文件扩展名(在我们的情况下为MD)。例如,您的第一篇帖子可以命名为2015-03-29-my-First post.md。

>

发布您的博客

>遵循上述步骤并添加了一些自己的帖子后,您就可以向世界展示新博客。您可以将文件发布到许多Web主机上,但是GitHub使通过GitHub页面托管静态Jekyll网站变得非常简单(免费!)。您需要拥有的只是一个github帐户。
---
layout: post
title: Your Post Title
---
登录后复制

将其推向github之前,让我们进行一些更改:>

在config.yml文件中:

  • 更改标题,标语,描述GitHub和作者的个人详细信息。
  • >将URL更改为your_github_username.github.io。
在cname中,提及your_github_username.github.io而不是hyde.getpoole.com。并编辑大约为md包含您的详细信息。

> 您已经进行了上述更改,创建一个存储库your_github_username.github.io,然后将所有文件从桌面移动到该存储库。

>尝试在浏览器中打开out_github_username.github.io,您会在那里找到新博客。

>

要注意的一个重要点:您需要了解一些git,以便能够将新帖子添加到存储库中。如果您不是命令行,那么有很多工具,例如Mac的Github,它们可以轻松使用GIT。无论哪种方式,一旦将帖子添加到存储库后,GitHub页面都会照顾其余的。

进一步阅读

>这篇文章是要让您开始使用Jekyll,但是如果您愿意花一些时间学习,您可以做很多事情。您会发现以下资源可用于理解jekyll并更好地git:

>

jekyll文档 - 非常整洁,点文档

    杰基尔的简介 - 约翰·罗森(Johan Ronsee)的好解释
  • Git和GitHub的基础知识 - 从官方GitHub YouTube频道
  • 在15分钟内学习GIT基础知识 - 代码学校的互动教程。
  • >希望您发现这篇文章有用。如果您试图使用上述步骤构建博客并将其卡住在任何地方,请在下面的评论中询问一个问题。我会在那里活跃。
  • >常见问题(常见问题解答)关于在5分钟内使用POOLE
  • 建立Jekyll博客
什么是jekyll,为什么我应该将其用于博客?它采用一个模板目录,其中包含各种格式的原始文本文件,通过转换器和渲染器运行它,并吐出一个完整的,即将发布的静态网站。使用Jekyll的主要优点是它的简单性。它不需要数据库或更新,从而使其安全易于维护。另外,您可以免费在Github上直接托管您的网站。

什么是poole,它如何补充jekyll?

poole是jekyll项目的基础设置。它为任何Jekyll站点提供了清晰简洁的基础设置。它通过提供完整的香草Jekyll安装示例,页面,帖子和样式来做到这一点。这可以帮助您立即与Jekyll一起启动和跑步。

>

>如何安装je​​kyll和poole?

要安装jekyll,您需要在系统上安装Ruby。拥有Ruby后,您可以通过运行命令GEM安装Jekyll Bundler来安装Jekyll。对于Poole,您只需要从Github下载或克隆Poole存储库,就可以了。杰基尔很简单。您只需要在_posts目录中添加一个文件,该目录遵循公约yyyy-mm-dd-name of-post.ext.ext。并感觉到我的jekyll博客?

>您可以通过在_layouts中编辑样式表和布局文件来自定义jekyll博客的外观和_ sass目录。您还可以在CSS目录中添加自己的样式表。

>如何在Github上托管我的Jekyll博客?

>在Github上托管您的Jekyll博客很容易。您只需要创建一个新的存储库,将您的jekyll站点推向它,然后配置存储库设置以将GH-pages分支用于github页面。

>

>如何更新我的jekyll博客?

更新您的jekyll博客就像对文件进行更改并将其推向GitHub存储库一样简单。每当您推更改时,Jekyll都会自动重建您的网站。

我可以将jekyll与其他语言一起使用吗?您可以在_config.yml文件中配置网站的语言,而jekyll将处理其余的内容。

>

如何将图像添加到我的jekyll博客?

>您可以将图像添加到Jekyll中通过将它们放置在图像目录中,并使用适当的Markdown或HTML语法将其放置在图像目录中。 Jekyll?

是的,Jekyll支持可以扩展其功能的广泛插件。您可以通过将插件添加到gemfile和_config.yml文件中来安装插件,然后运行Bundle install command。

以上是使用普尔(Poole)在5分钟内建立一个Jekyll博客的详细内容。更多信息请关注PHP中文网其他相关文章!

本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
作者最新文章
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板