开始

本节将描述如何安装应用程序、提供更改以及保持最新更改的最新状态。

本指南假设您知道如何运行本地服务器、使用git版本控制和从命令行运行工具。

技术要求＃

要从GitHub存储库运行软件，必须满足以下要求。188金宝搏下载app读了管理指南如果您是从发布包安装。

• PHP 7.3 +
• MySQL 4.1 +或PostgreSQL 9.1.5 +

如果你正在使用Windows，你可能需要安装GNU补丁并将其添加到你的系统中路径环境变量。

安装＃

Fork和克隆橙汁，经济新闻,或运维在GitHub库。(如何分叉并在GitHub上克隆一个存储库．)

从你的终端，导航到应用程序的根目录，并运行以下命令来检查子模块:

Git子模块update——init——recursive

复制默认配置文件。

cp config.TEMPLATE.inc.php config.inc.php

打开config.inc.php文件，找到数据库设置，并更新它们以匹配SQL服务器的凭据。

安装依赖关系作曲家．

编译器——worker -dir=lib/pkp update

如果正在安装OJS，请执行以下命令。

作曲家——working-dir =插件/一般/ citationStyleLanguage更新

安装依赖关系NPM．

安装NPM，运行build

运行以下命令以使用PHP的内置服务器启动应用程序。

php - s localhost: 8000

加载您的浏览器并导航到http://localhost:8000安装应用程序。

分支机构＃

发布的软件版本可以在git存储库的分支中找到。188金宝搏下载app例如，执行如下命令查看该软件的版本为3.3.0。188金宝搏下载app

git checkout stable-3_3_0

遥控器＃

要获取在派生之后对应用程序所做的更改，请添加上游遥远。

橙汁:

Git remote add upstream git@github.com:pkp/ojs.git CD lib/pkp Git remote add upstream git@github.com:pkp/pkp-lib. Git CD ../ui-library git remote add upstream git@github.com:pkp/ui-library.git CD ..

经济新闻:

Git remote add upstream git@github.com:pkp/omp.git CD lib/pkp Git remote add upstream git@github.com:pkp/pkp-lib. Git CD ../ui-library git remote add upstream git@github.com:pkp/ui-library.git CD ..

每当您希望将最新的更改拉入存储库时，请运行以下命令。

# Update the app git checkout main git pull upstream main git push # Update the pdp -lib submodule cd lib/pkp git checkout main git pull upstream main git push # Update the app git checkout main git pull upstream main git push # Update the app git checkout main git pull upstream main git push # Update the app git checkout main git pull upstream main git push #/ui-library git checkout main git pull upstream main git push CD .. .

更新＃

当你从上游远程，运行以下命令同步lib / pkp和lib / ui库子。

Git子模块update——init——recursive

您可能需要更新依赖项并重新构建JavaScript包。

编译器——worker -dir=lib/pkp update NPM install NPM run build

有时，代码更改将修改数据库结构，您将需要运行升级脚本。

php工具/ upgrade.php升级

贡献＃

所有的贡献都应该在一个分支中编写，并推送到你的分支中。然后打开一个把请求PKP的存储库。

对于打算包含在主代码库中的代码:

• 新特性是最好的贡献主要分支以包含在下一个主要版本中。Bug修复最好贡献给最新的稳定分支(例如:stable-3_3_03.3.0)。
• 应该理解和遵循PKP软件中使用的设计模式。188金宝搏下载app这包括:
  • 本地化标准
  • 安全实践(检查数据库id，避免跨站点脚本攻击等)
  • 维护注意事项(请在需要时包括升级和安装脚本)
  • 代码格式、变量命名和风格约定
• 贡献者负责编写与docs/README.md中列出的主要平台兼容的代码。
• 当所提交的更改可能影响多个应用程序时，我们要求考虑所有主要应用程序(OJS、OMP和OPS)。
• 开发团队很乐意审查贡献的补丁，但是我们花在将补丁与代码库集成或修改贡献代码上的时间有限。如果代码的某些方面需要工作，我们宁愿通知作者并让他们执行修改。

对于作为补丁或插件单独发布的贡献:

• 如果贡献者没有满足上述条件，欢迎他们以补丁或插件的形式发布额外的特性。然而，PKP小组在这种情况下无法提供支持。
• 如果选项是可用的，将特性编码为插件是首选方法。

既然你已经开始工作了，了解更多关于应用程序体系结构．