本系列的前几部分中,我谈到了动作和过滤器 ,但Genesis的优势之处远不止于此。Genesis内含的辅助函数是它的又一个巨大优点。今天我们先快速总览一下全貌,然后我将带你深入研究每个函数的细节。
首先,还是看看文件结构。照例,通过文件夹的名字和文件的名字可以帮助我们快速找到需要的内容,请查看 genesis/lib/functions/
文件夹。
注
斜体部分为原文中没有的内容,译者丘壑根据最新版Genesis 2.8添加
好的,现在你已经大致了解了文件中的内容。我们将在本系列的后续文章中讨论其中的大多数文件和函数,现在让我们先从一些最常用的函数开始介绍一下。更详细的内容将在稍后发布,现在先大致的看几个函数:
此函数和 genesis_image()
用于获取特色图像。实际上它还可以做得更多。如果你没有设置特色图像,它还会取出文中的第一张图片。稍后将详细讨论可以传递给它的参数。genesis_image()
会把 genesis_get_image()
取到的图片显示出来,这是它们的不同之处。这意味着你在使用该函数时不必输入“echo
”。由于这种特性,你可以使用很多巧妙的技巧。
同样的,genesis_custom_field()
函数会把 genesis_get_custom_field(
)获取到的值打印出来。它会自动使用 $post-> ID
,只需要传入字段名即可。
get_the_content_limit()
函数使用 get_the_content()
来获取完整内容,然后对其进行长度限制。the_content_limit()
可以直接用来显示限制过长度的部分文章。这类似于the_excerpt()
,但有几个高级参数可以设置,可以更轻易的调整要显示的内容长度,甚至更精确的(字符数、字数),并且自动内置好了“read more”的链接。
这些只是想激起你的兴趣而已,很快就会深入研究这些函数的具体功能,可选参数以及怎样用过滤器来调整输出。
这是最短的一篇没想到却是最费时的,因为太久远了。。作者写的日期距离现在已经快8年了。。。里面写到的好多都和现在不一样了,有的没了,有的移走了,有的新添加了,估计博客上也懒得更新了,但愿书中应该更新了吧。。
由于手边还是没有书,只好一个个文件打开看看里面是啥内容,人肉确认一下。不过也正好借此机会一窥Genesis的内部代码组织,确实井然有序的,而且也是在不断迭代更新的,是一个有生命力的框架,值得好好研究一下。
ps:本文文件树的样式参考了这里:https://codepen.io/khoama/pen/hpljA
See the Pen Pure CSS Directory Tree by Khoa Ma (@khoama) on CodePen.