- 编写文档
- 查找错误并创建问题
- 帮助代码和修复问题
- 本地安装
- HelpHub主题
- 提出设计建议和改进
总是有团队需要帮助编写文档。文档团队可以帮助您联系需要帮助的人。加入我们的讨论#文档松弛通道打开星期四17:00-18:00 UTC并提供您的帮助。
查看位于以下位置的HelpHub网站:wp-helphub.com网站。如果您看到任何错误或问题,请在此处创建GitHub回购的问题:https://github.com/WordPress/HelpHub/issues网站.
- 在本地安装WordPress。
- 重命名
wp含量
文件夹。稍后,您将需要当前的主题文件。
- 将此回购克隆为
wp含量
.
$git克隆https://github.com/WordPress/HelpHub.gitwp含量
- 从上述步骤2中重命名的文件夹中复制回当前的主题文件。
- 运行
npm安装
编译主题的.scs
文件到样式表
(有关详细信息,请参见下文)
- 安装并激活bbPress插件。
- 激活WordPress.org支持主题来自内部
/wp管理员
.
- 激活支持帮助中心从内部插入
/wp管理员
.
- 低于
设置->永久链接
在中/wp管理员
,更改为“Post Name”选项,然后保存更改。
- 确保您的
php.ini公司
文件包含以下行打开
.
allow_url_fopen=开allow_url_include=启用
提示:如果您正在使用VVV,请按照以下步骤查找php.ini公司
.
$cd<您的路径到VVV>/vagrant-local$流浪者ssh$cd/etc/php/7.0/fpm
目前,我们有两种从临时站点导入数据库的方法-通过进口商和通过复印机
临时站点中的数据库位于wp-content/staging数据库
文件夹。在那里你可以找到WordPress导入器、小工具导入器和导出器、复制器和UpdraftPlus的数据库文件。
要使用WordPress导入器从/wp管理员
按照以下步骤操作:
- 去:
工具->导入
然后单击底部WordPress下的“立即安装”。这将安装WordPress导入程序。
- 单击“运行导入程序”
- 选择上述文件,然后单击“上传文件并导入”按钮
- 将所有作者设置为本地站点上的用户帐户。
- 选中“下载并导入文件附件”复选框。
- 单击按钮开始。可能需要一段时间才能完成。如果有一些失败的导入,它应该还可以。
此文件不会从临时站点导入小部件。为此,您可以使用.wie公司
文件,位于wp-content/staging-database/Widget导入器和导出器
文件夹。此文件使用导出小工具导入器和导出器插件,您需要在本地安装中使用此插件,以便从.wie(魏氏)
文件。
在wp-content/staging数据库
你会发现复印机
文件夹包含.zip
档案文件。此存档保存安装程序-备份.php
和数据库.sql
文件,创建于2018年3月13日。你可以用它代替进口商导入数据库的工作流。这里有一个指导用于复制器。
在本地安装并运行HelpHub后,您可以从自己的fork或直接将其添加为此存储库中的贡献者后,通过pull请求进行贡献。我们正在使用特拉维斯CI对每个拉动请求进行测试。您还可以在推送代码之前在本地运行这些测试(稍后详细介绍)。开发包括主题和插件两方面的工作,需要以下内容最佳实践和WordPress编码标准.
HelpHub使用名为格兰特.Grunt包含项目的自动化任务(可以是任何东西——构建svg精灵、缩小css和js文件等)。我们使用来验证和检查此存储库中CSS、JavaScript和Sass文件的完整性,以及将主题Sass文件编译为CSS。
要运行Grunt,您需要净现值。我们假设您已经有npm。
首先,我们需要从安装依赖项package.json包
文件:
在终端中运行此命令后,根目录中会有另一个文件夹,节点_模块
。此文件夹在中被忽略.gitignore(.git忽略)
并包含运行Grunt任务所需的所有工具,这些工具在Gruntfile.js文件
.
HelpHub主题使用萨斯应用样式,因为它提供了打破一个大的可能性样式表
文件分成更小的部分,从而减少了在不同分支中对同一文件进行多次修改可能导致的Git冲突。维护也大大改进了。修改后,Sass(.scss文件
)需要将文件编译到样式表
.
格伦特安全气囊系统
任务编译所有.scss文件
文件到样式表
。这意味着每次运行此任务时样式表
将使用中的新代码覆盖.scs
文件,位于主题中安全气囊系统
文件夹。因此,改为修改样式表
直接将HelpHub主题的所有CSS更改添加到适当的.scss文件
部分,之后应该运行编译器以查看更改。编译是通过在终端中运行以下命令完成的:
然而,如果您添加了大量CSS更改,而不是运行大量安全气囊系统
任务,您可以运行看
任务,如下所示:
此任务告诉编译器监视中创建的所有更改.scss文件
文件并重新生成新的样式表
每次保存文件时。
虽然您可以在中使用常规CSS语法.scss文件
文件(只要Travis测试通过),我们鼓励您学习并尽可能多地使用Sass。这对你和项目都有好处。
加入我们的讨论#文档 松弛,松弛频道打开星期一15:00-16:00 UTC-内容、设计和开发讨论。或者在我们的GitHub回购中提交您的想法在这里.