seothemes / genesis-starter-theme
具有现代开发工作流程的 Genesis 开发者主题。
Requires
- php: >=5.6
Requires (Dev)
- php: ^5.6|^7
- brain/monkey: ^2.2
- dealerdirect/phpcodesniffer-composer-installer: v0.5.0
- phpcompatibility/phpcompatibility-wp: 2.0.0
- phpunit/phpunit: ~5.7.9
- squizlabs/php_codesniffer: ^3.4.2
- wp-coding-standards/wpcs: 2.1.0
- wp-phpunit/wp-phpunit: ^5.1
This package is auto-updated.
Last update: 2024-09-18 13:52:26 UTC
README
一个开发者友好的启动主题,用于创建 Genesis 框架的商业子主题。
它使用 Laravel Mix 作为构建工具来自动化编译 SCSS 和压缩图片等日常开发任务。
查看 实时演示
目录
功能
Genesis Starter Theme 旨在使 Genesis 子主题开发现代化、组织化并提升某些方面。看看你将得到什么
- Bourbon 作为轻量级 Sass 工具包
- Laravel Mix 用于自动化开发构建任务
- Browsersync 用于同步浏览器测试
- 基于配置的,OOP 模块化架构
- CLI 设置脚本 用于自动更新信息
- Yarn 或 NPM 用于管理 Node 依赖关系
- Composer 用于管理 PHP 依赖关系和自动加载
- 命名空间化 以避免命名冲突
- AMP 支持 WordPress AMP 插件
- Gutenberg 支持最新的区块和后台编辑器样式
要求
安装
单行命令
使用 Composer 从您的 WordPress 主题目录安装 Genesis Starter Theme 的最新开发版本(以下面的 your-theme-name
替换为您主题的名称)
composer create-project seothemes/genesis-starter-theme your-theme-name dev-master && cd "$(\ls -1dt ./*/ | head -n 1)" && npm install && npm run build
单独命令
使用 Composer 从您的 WordPress 主题目录安装 Genesis Starter Theme 的最新开发版本(以下面的 your-theme-name
替换为您主题的名称)
composer create-project seothemes/genesis-starter-theme your-theme-name dev-master
导航到主题的根目录
cd your-theme-name
安装 Node 依赖关系,构建主题资产并启动 BrowserSync
npm install && npm run build
结构
your-theme-name/ # → Root directory ├── assets/ # → Front-end assets ├── config/ # → Config directory ├── lib/ # → Theme functions │ ├── functions/ # → General functions │ ├── plugins/ # → Plugin functions │ ├── shortcodes/ # → Shortcode functions │ ├── structure/ # → Structural functions │ └── init.php # → File autoloader ├── templates/ # → Page templates ├── tests/ # → PHP Unit tests ├── vendor/ # → Composer packages ├── node_modules/ # → Node.js packages ├── composer.json # → Composer settings ├── package.json # → Node dependencies ├── webpack.mix.js # → Laravel mix config ├── screenshot.png # → Theme screenshot ├── functions.php # → Loads init files └── style.css # → Blank stylesheet
使用
项目详情(如主题名称、作者、版本号等)应仅从 package.json
文件中更改。Laravel Mix 读取此文件并将相关信息自动放置在主题的各个正确位置。
静态资产组织在 assets
目录中。此文件夹包含主题脚本、样式、图片、字体、视图和语言翻译文件。所有主要主题样式均包含在 assets/css/main.css
文件中,主题根目录中的 style.css
文件故意留空,仅包含所需的样式表头注释。
自动加载类和文件
类
Genesis Starter Theme 会自动通过 Composer 自动加载器加载放置在 lib/classes/
目录中的类。一旦您添加了额外的文件,请运行以下命令以重新生成自动加载器
composer dump-autoload --no-dev
文件
文件加载由 lib/init.php
文件处理。只需从目录/文件名数组中添加或删除文件即可。
开发
请参考Laravel Mix文档,以获取有关如何使用webpack.mix.js
文件的更多信息。
所有构建任务都位于主题的package.json
文件中的scripts部分。
贡献
欢迎每个人贡献。我们提供了贡献指南,以帮助您开始。
还可以查看参与此项目的贡献者列表。
特别感谢
向所有在此项目中使用了代码或受到启发的任何人致以敬意
Christoph Herr,Gary Jones,Tonya Mork,Tim Jensen,Justin Tadlock