WordPress Sage主题框架文档翻译-安装和配置和功能说明

文 / @WordPress主题

Sage WordPress框架介绍

我是一名致力于WordPress主题开发的程序猿,最近学习了一款名为Sage的WordPress框架,觉得非常不错,因此想和大家分享一下关于Sage的学习和使用经验。

Sage是一个出色的WordPress框架,它非常容易上手,而且官方文档写得十分清晰易懂。不过,考虑到有些程序猿的英文阅读能力可能有些棘手,因此我把其中的部分内容翻译成了中文,以便于大家更加轻松地阅读和使用。另外,根据我自身的理解和经验,我也会在翻译中加入一些额外的说明性内容,来帮助大家更好地理解和使用Sage。我水平有限,翻译难免有不当和错误的地方,恳请大家在评论中指正。

Sage WordPress框架的安装

安装Sage WordPress框架非常简单,只需在WordPress主题目录中克隆Sage的git仓库,或从GitHub下载,然后将其解压到主题目录即可。

git clone https://github.com/roots/sage.git theme-name

如果您没有使用Bedrock,还需要在wp-config.php文件中添加以下配置:

define('WP_ENV', 'development');

Sage WordPress框架的配置

Sage WordPress框架的所有配置都在lib/config.php文件中,您可以在这个文件中启用或禁用Sage主题和Soil插件的一些功能。下面是主题默认的一些配置:

启用Soil插件的代码清理功能:

add_theme_support('soil-clean-up');

启用Soil插件的导航walker功能:

add_theme_support('soil-nav-walker');

启用Soil插件的相对URL功能:

add_theme_support('soil-relative-urls');

启用Soil插件的搜索URL:

add_theme_support('soil-nice-search');

启用Soil插件的jQueryCDN功能:

add_theme_support('soil-jquery-cdn');

Sage WordPress框架的功能说明

functions.php文件主要用于包含lib/文件夹中的文件。主题的所有功能基本上都在这个文件夹中定义。请勿在functions.php文件中添加任何功能,而是将功能放在lib/文件夹中,然后通过functions.php文件进行包含,这样可以使主题的结构更加清晰易懂。

Sage是一个基本主题,因此您可以根据自身需求自由修改lib/文件夹中的功能代码,以符合自己的需求。

lib/assets.php
用于将样式和JavaScript插入主题。
lib/conditional-tag-check.php
ConditionalTagCheck应用类,可用于主题侧边栏。
lib/config.php
用于启用/禁用主题的功能。
lib/extras.php
用于添加CSS类到<body>标签上,或者为摘要添加"Read More"链接等主题附加功能。
lib/gallery.php
用于重新创建相册简码,以适应Bootstrap缩略图组件。
lib/init.php
用于初始化主题,包括注册导航菜单、侧边栏,以及定义WordPress主题支持的WordPress核心功能,如文章缩略图、文章格式和HTML5标签。
lib/nav.php
用于清理导航菜单中多余的HTML标记。
lib/titles.php
用于控制页面标题的输出。
lib/utils.php
用于重新定义模板中SearchForm模板的位置,以及其他辅助功能。
lib/wrapper.php
用于封装主题。

这些是Sage WordPress框架的基本说明。掌握了这些,我们将可以轻松安装配置Sage主题,并简单地配置Sage主题的一些功能。在下一篇文章中,我会为大家翻译Sage主题模板的结构以及如何自定义扩展模板。

添加UTHEME为好友
扫码添加UTHEME微信为好友
· 分享WordPress相关技术文章,主题上新与优惠动态早知道。
· 微信端最大WordPress社群,限时免费入群。