Jekyll一个简单的支持博客的静态站点生成器

　　《开源精选》是我们分享Github、Gitee等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的Jekyll是一个简单的、支持博客的、静态站点生成器，非常适合个人、项目或组织站点。
　　把它想象成一个基于文件的CMS，没有那么复杂。Jekyll获取您的内容，呈现Markdown和Liquid模板，并吐出一个完整的静态网站，准备好由Apache、Nginx或其他Web服务器提供服务。快速开始
　　先决条件Permalink
　　Jekyll需要以下内容：Rubyversion2。5。0orhigherRubyGemsGCCandMake
　　安装指示
　　1安装所有先决条件。
　　2安装jekyll和bundlergems。geminstalljekyllbundler
　　3创建一个新的Jekyll站点在。myblog。jekyllnewmyblog
　　4切换到新目录。cdmyblog
　　5构建站点并使其在本地服务器上可用。bundleexecjekyllserve
　　6浏览到http：localhost：4000命令行用法
　　Jekyllgem使jekyll您可以在终端中使用可执行文件。
　　该jekyll程序有几个命令，但结构始终是：jekyllcommand〔argument〕〔option〕〔argumenttooption〕Examples：jekyllnewsiteblankjekyllserveconfigalternativeconfig。yml
　　通常，您将jekyllserve在本地开发以及jekyllbuild需要生成站点以进行生产时使用。
　　以下是一些最常见的命令：jekyllnewPATH在指定路径创建一个新的Jekyll站点，该站点具有默认的基于gem的主题。将根据需要创建目录。jekyllnewPATHblank在指定路径创建一个新的空白Jekyll站点脚手架。jekyllbuild或jekyllb一次性构建您的网站。site（默认情况下）。jekyllserve或jekylls每当源文件更改并在本地提供它时构建您的站点。jekyllclean删除所有生成的文件：目标文件夹、元数据文件、Sass和Jekyll缓存。jekyllhelp显示帮助，可选地用于给定的子命令，例如jekyllhelpbuild。jekyllnewtheme创建一个新的Jekyll主题脚手架。jekylldoctor输出任何弃用或配置问题。渲染过程
　　对于任何Jekyll站点，构建会话由以下顺序的离散阶段组成设置插件、读取源文件、运行生成器、渲染模板，最后将文件写入磁盘。
　　虽然上述阶段是不言自明的，但值得剖析的一个阶段是渲染阶段。
　　渲染阶段可进一步分为三个可选阶段。渲染的每个文件都会通过这些阶段中的一个或多个，具体取决于文件的内容字符串、前端内容和扩展名。这些阶段类似于装配线，一个阶段的输出是后续阶段的输入：解释文件中的Liquid表达式
　　此阶段计算当前文件中的Liquid表达式。默认情况下，解释很浅因为结果输出中的任何Liquid表达式都不会被进一步解释。此外，文件前面的任何Liquid表达式都保持不变。释放转换器
　　此阶段调用映射到当前文件扩展名的转换器并转换输入字符串。这是Markdown转换为HTML和SassScss转换为CSS或CoffeeScript转换为JavaScript等的时候。由于这个阶段是由文件的扩展名决定的，所以文件中的Markdown或Sass。html将保持不变。填充布局
　　到这个阶段，源文件被认为是渲染的，它不会被重新访问。但是，根据文件的扩展名，因此根据前面的内容，确定是否从前一阶段获取输出字符串并放入布局中。虽然Sass文件或CoffeeScript文件的输出永远不会放入布局中，但常规文本输出可以根据布局是否已通过前端分配而采用任何一种方式。页面
　　页面是内容的最基本构建块。它们对于独立内容（不是基于日期的内容或不是一组内容，如工作人员或食谱）很有用。
　　添加页面的最简单方法是在根目录中添加一个具有合适文件名的HTML文件。您还可以使用。md在构建时转换为HTML的扩展在Markdown中编写页面。对于具有主页、关于页面和联系页面的站点，根目录和关联的URL可能如下所示：。about。mdhttp：example。comabout。htmlindex。htmlhttp：example。comcontact。htmlhttp：example。comcontact。html
　　如果您有很多页面，您可以将它们组织到子文件夹中。site当您的站点构建时，用于对项目源中的页面进行分组的相同子文件夹将存在于该文件夹中。但是，当页面在前端设置了不同的永久链接时，子文件夹atsite会相应更改。。about。mdhttp：example。comabout。htmldocumentationfoldercontainingpagesdoc1。mdhttp：example。comdocumentationdoc1。htmldesignfoldercontainingpagesdraft。mdhttp：example。comdesigndraft。html主题
　　Jekyll有一个广泛的主题系统，允许您利用社区维护的模板和样式来自定义您的站点的演示文稿。Jekyll主题以一种可以被您网站内容覆盖的方式指定插件并打包资产、布局、包含和样式表。
　　了解基于gem的主题
　　当您创建一个新的Jekyll站点（通过运行jekyllnew命令）时，Jekyll会安装一个站点，该站点使用一个名为Minima的基于gem的主题。
　　对于基于gem的主题，网站的某些目录（例如assets、data、layouts、includes和sass目录）存储在主题的gem中，从您的直接视图中隐藏。然而，在Jekyll的构建过程中，所有必要的目录都将被读取和处理。
　　对于Minima，您只能在Jekyll站点目录中看到以下文件：。GemfileGemfile。lockconfig。ymlposts20161204welcometojekyll。markdownabout。markdownindex。markdown
　　Bundler使用Gemfile和Gemfile。lock文件来跟踪构建Jekyll站点所需的gem和gem版本。
　　基于Gem的主题使主题开发人员可以更轻松地向拥有主题gem的任何人提供更新。当有更新时，主题开发人员会将更新推送到RubyGems。
　　如果您有主题gem，您可以（如果您愿意）运行bundleupdate以更新项目中的所有gem。或者您可以运行bundleupdate，替换为主题名称，例如minima，仅更新主题gem。主题开发人员所做的任何新文件或更新（例如样式表或包含）都将自动拉入您的项目中。
　　基于gem的主题的目标是让您获得强大的、不断更新的主题的所有好处，而不会让所有主题文件妨碍您，并使您的主要关注点过于复杂：创建内容。
　　覆盖主题默认值
　　Jekyll主题设置默认数据、布局、包含和样式表。但是，您可以使用自己的站点内容覆盖任何主题默认值。
　　要替换主题中的布局或包含，请在您的layouts或includes您要修改的特定文件的目录中制作副本，或者从头开始创建文件，并为其指定与您要覆盖的文件相同的名称。
　　例如，如果您选择的主题具有page布局，您可以通过在目录中创建自己的page布局layouts（即layoutspage。html）来覆盖主题的布局。
　　要在您的计算机上找到某个主题的文件：Runbundleinfopath后跟主题gem的名称，例如bundleinfopathminimaJekyll的默认主题。这将返回基于gem的主题文件的位置。例如，Minima主题的文件可能位于usrlocallibrubygems2。6。0gemsminima2。5。1macOS上。在Finder或Explorer中打开主题的目录：OnMacOSopen（bundleinfopathminima）OnWindowsFirstgetthegemsinstallationpath：bundleinfopathminimaC：Ruby26x64librubygems3。1。1gemsminima2。5。1theninvokeexplorerwithabovepath，substitutingwithexplorerC：Ruby26x64librubygems3。1。1gemsminima2。5。1OnLinuxxdgopen（bundleinfopathminima）
　　将打开一个Finder或Explorer窗口，显示主题的文件和目录。Minima主题gem包含以下文件：。LICENSE。txtREADME。mdincludesdisquscomments。htmlfooter。htmlgoogleanalytics。htmlhead。htmlheader。htmlicongithub。htmlicongithub。svgicontwitter。htmlicontwitter。svglayoutsdefault。htmlhome。htmlpage。htmlpost。htmlsassminimabase。scsslayout。scsssyntaxhighlighting。scssminima。scssassetsmain。scss
　　清楚地了解主题文件后，您现在可以通过在Jekyll站点目录中创建一个类似名称的文件来覆盖任何主题文件。
　　END
　　开源协议：Apache2。0
　　开源地址：https：github。comjekylljekyll