drupal-tome/tome-project

Tome 的入门项目。

dev-master 2023-12-03 21:24 UTC

This package is auto-updated.

Last update: 2024-09-03 22:49:58 UTC


README

这是一个构建全新 Tome 项目的绝佳起点。

目前这里内容不多,请保持关注,如果有任何问题请告诉我!

需求

您还可以在 Docker 容器中运行 Tome - 有关参考,请参阅下面的 Docker 文档。

使用方法

要创建一个新的 Tome 项目,运行

composer create-project drupal-tome/tome-project my_site --stability dev --no-interaction
drush tome:init

要重新安装 Tome,运行

drush tome:install

要启动本地 web 服务器,运行

drush runserver

当您准备好构建静态站点时,运行

drush tome:static

符号链接

当运行 composer install 或 update 时,"modules" 和 "themes" 目录,以及 "settings.php" 文件,都会被符号链接到 "web" 目录。

这样做是为了提高开发体验,但仅限于支持 bash 和符号链接的系统。如果您正在使用 Windows,您可能需要编写一个自定义脚本以替换 symlink.sh,并使用 mklink 命令。欢迎通过 pull request 使此功能默认跨平台。

Docker

Tome 的 Docker 镜像可在 Docker Hub 上找到,名称为 mortenson/tome

您可以使用以下包含的脚本来使用镜像而不是本地的 Drush 和 Composer 版本

  • ./scripts/ddrush.sh - 在当前目录中运行 Drush。
  • ./scripts/drunserver.sh - 运行 drush runserver 并映射端口 8888。
  • ./scripts/dexec.sh - 运行 shell 命令,使用 ./scripts/dexec.sh bash 打开交互式会话。

有关如何使用此镜像的更多说明,请参阅 drupal-tome/tome-docker

包含 Netlify、GitPod 和 GitHub Pages 配置

为了便于使用,已包含 netlify.toml.gitpod.yml 文件,这样您可以在创建项目后立即开始使用这些服务。Netlify 提供免费的静态站点托管并支持 Tome,Gitpod 允许您在不运行本地站点的情况下编辑 Drupal 内容、配置和代码。有关更多信息,请访问 https://netlify.com/https://gitpod.io/

对于 GitHub Pages,您需要将 .example_github 复制到 .github 并启用 GitHub Actions。然后,在提交到 master 时,应将静态站点导出到 gh-pages 分支。您可以在仓库设置中配置用于 GitHub Pages 的分支。

进一步阅读

此项目主要基于 drupal-composer/drupal-project,因此建议您查阅他们的 README.md 获取更多信息。