README

by phifa

TLDR

composer create-project phifa/typo3stack=dev-master --prefer-dist .

注意事项

• 安装过程中会安装多个外部扩展。另外，还会安装两个本地扩展 template 和 template_site1。
• template 扩展是基础，不应该做任何更改。
• 页树中的每个根站点都可以获取其自己的子模板 template_site1、template_site2 等。
• 首先执行以下安装。集成后的自定义将在下面进行。
• 对于多域名设置，复制子扩展，并对每个域名重复集成。
• 覆盖：所有覆盖都在子扩展中完成：您可以隐藏标准后端布局、添加自己的或覆盖它们，对于 FLUID 文件也是如此。在 page.typoscript 中，您可以使用自己的文件覆盖 css 和 js 文件等。在覆盖时，请确保遵循命名约定，因为只有同名文件才会被覆盖。

1. 安装

1. 创建您的项目文件夹并进入该文件夹。然后：composer create-project phifa/typo3stack=dev-master --prefer-dist .
2. 从 /presets/ 复制配置模板到其位置，进行自定义，如果需要，则重命名。
3. 运行 ddev start 或首先修改 ddev 配置（例如更改名称）
4. 根据项目根目录中的 .env-example 进行相应修改，并将其重命名为 .env。文件已包含在 .gitignore 中，并且应针对每个上下文创建。
5. 运行 ddev ssh，然后运行 ./post-create-project-cmd.sh。
6. 退出 ssh 会话。
7. 登录到后端并将管理员用户添加到管理员组（页面 UIDs 应在页面刷新后显示在页树中）。
8. 还可以在模块 访问 下进行双重检查，确保所有页面都指向组：[ACCESS] 默认，如果不是这种情况的话。
9. 现在 template_site1 模板已经启动并运行。有关自定义，请参阅以下 集成。

如果未更改 DDEV 容器的名称，以下为 URL

Frontend:
http://template.ddev.local
https://template.ddev.local
http://127.0.0.1:32775

MailHog:
http://template.ddev.local:8025

phpMyAdmin:
http://template.ddev.local:8036

2. 集成

1. 运行 ./renameextension.sh 并在变更日志中检查哪些文件已更改。
2. 现在需要在后端的两个地方再次添加子模板：将 TypoScript 模板和 TSconfig 添加到根页面。您可能需要在根页面再次将后端布局（和子级别）设置为 测试。
3. 根据需要修改子模板的常量。例如 config.name 等。
4. 清除系统缓存并打开您的开发站点，例如 http://mydomain.localhost。恭喜！
5. 首先使用站点模块配置站点。

3. 通过 Bitbucket 管道和 Surf 进行部署

1. 确保 Git 为您的项目正确设置，并将 origin 设置为 Bitbucket 存储库。
2. 应该有一个主分支，它将部署到客户端的实时站点，还有一个预发布分支，它将部署到客户端的预发布子域。
3. 您只需要在 .surf/ 中自定义配置。这些文件在 bitbucket-pipelines.yml 中被调用。