README

Mark-a-Spot是基于Drupal CMS构建的开源公民问题追踪和Open311服务器。此存储库提供Docker设置，以方便运行Mark-a-Spot。

入门指南

以下说明将指导您在本地计算机上获取项目副本并启动，用于开发和测试。

先决条件

• Docker
• Docker Compose

安装

1. 克隆此存储库

   git clone https://github.com/markaspot/mark-a-spot.git
   cd mark-a-spot

2. 运行Docker容器

   docker-compose up -d

3. 运行start.sh脚本（如果出现权限拒绝错误，请使用：chmod a+x ./scripts/start.sh）

   docker exec -it markaspot ./scripts/start.sh -y

   start.sh脚本有两个选项

   • -y 使用预定义值自动安装（纬度：40.73，经度：-73.93，城市：纽约，区域：en_US）
   • -t 从/translations目录导入翻译文件并启用术语翻译

脚本执行后，应用程序应可通过https://访问。请在执行脚本时谨慎操作，因为它将删除数据库并从头开始初始化Mark-a-Spot。此外，熟悉Drupal开发过程，包括配置更改、备份数据库和其他相关程序。

服务

Docker Compose设置包括以下服务

• web：Nginx Web服务器
• markaspot：Mark-a-Spot Drupal应用程序
• db：MariaDB数据库
• phpmyadmin：PHPMyAdmin数据库管理

配置

您可以通过编辑docker-compose.yml文件来调整Docker服务的配置。例如，您可以修改数据库用户名和密码、PHP内存限制和其他设置。

使用方法

在https://访问Drupal应用程序。

PHPMyAdmin可通过https://:8080用于数据库管理。

开发

对于本地开发，我们建议使用基于Docker的开发环境Docksal。

先决条件

• Docksal
• Docker
• Docker Compose

安装

1. 按照Docksal网站上的说明在您的机器上安装Docksal。

2. 克隆此存储库

   git clone https://github.com/markaspot/mark-a-spot.git
   cd mark-a-spot

3. 初始化Docksal项目

   fin up

4. 将本地设置文件复制到网站默认目录并更改您的settings.php

   cp web/sites/example.settings.local.php web/sites/default/settings.local.php

5. 在docksal/docksal#1783问题解决之前，请将drush版本交换

   fin bash
   echo -e "\n"'export PATH="${PROJECT_ROOT:-/var/www}/vendor/bin:$PATH"' >> $HOME/.profile;
   source $HOME/.profile

6. 在docksal CLI中运行scripts/start.sh（见上面）

配置

您可以通过编辑docksal.yml文件来调整Docker服务的配置。例如，您可以修改数据库用户名和密码、PHP内存限制和其他设置。

使用方法

您可以通过http://mark-a-spot.docksal.site访问Drupal应用程序。

许可

Mark-a-Spot在GNU通用公共许可证，版本2或任何后续版本下免费提供。