README

Omeka S 是一个针对大学、画廊、图书馆、档案馆和博物馆的网络发布系统。它由一个本地网络组成，该网络由独立策展的展览组成，共享一个共同构建的项目、媒体及其元数据。

有关更多信息，请参阅用户手册。

安装

要求

• Linux
• Apache （将 AllowOverride 设置为 "All" 并启用 mod_rewrite）
• MySQL 5.7.9+ （或 MariaDB 10.2.6+）
• PHP 7.4+ （建议使用最新稳定版本，已安装 PDO、pdo_mysql 和 xml 扩展）

生成缩略图

• 生成缩略图的默认库是 ImageMagick，至少版本 6.7.5。旧版本将无法正确生成缩略图。有关替代缩略图选项，请参阅用户手册。

从 GitHub 安装

1. 确保已安装 Node.js 和 npm
2. 在您的 Apache 网络目录中克隆此存储库
   • $ git clone https://github.com/omeka/omeka-s.git
3. 切换到 Omeka S 目录
   • $ cd omeka-s
4. 执行首次设置
   • $ npm install
   • $ npx gulp init
5. 打开 config/database.ini 并添加您的 MySQL 用户名、密码、数据库名和主机名。在下一步之前必须创建用户和数据库。
6. 确保 files/ 目录可由 Apache 写入。
7. 在您的网络浏览器中，导航到 omeka-s 目录，在那里您可以完成安装。

从发布的 zip 文件安装

1. 从 发布页面 下载最新版本（下载列出的第一个资产）
2. 打开 config/database.ini 并添加您的 MySQL 用户名、密码、数据库名和主机名。在下一步之前必须创建用户和数据库。
3. 确保 files/ 目录可由 Apache 写入。
4. 在您的网络浏览器中，导航到 omeka-s 目录，在那里您可以完成安装。

您可以在 application/ 下找到与 Omeka 相关的代码。

更新

备份您的整个网站及其数据库！

从 GitHub 更新

1. 按常规执行 git pull。使用 master 分支获取最新版本。
2. 从 Omeka S 根目录运行 npx gulp deps 以确保依赖项是最新的。
3. 比较 /config/local.config.php 和 /config/local.config.php.dist 中的更改。某些默认配置可能已更改，因此您可能需要将分布式配置与本地配置（例如，针对您的服务器的特定 PHP 路径、开发模式设置等）中的更改进行协调。
4. 在您的网络浏览器中，访问您的网站并运行所需的任何迁移。

从发布版 zip 文件更新

1. 从发布页面下载最新版本
2. 复制您的 /config 目录。您需要从该副本恢复您的 local.config.php 和 database.ini 文件。
3. 复制您的 /modules 和 /themes 目录。
4. 复制您的 /files 目录。
5. 删除所有 Omeka S 文件，并用更新 zip 文件中的文件替换。
6. 替换您的原始 /config/local.config.php 文件，以及您复制的 /modules、/themes 和 /files 目录。
7. 在您的网络浏览器中，访问您的网站并运行所需的任何迁移。

创建 zip 版本的发布

运行 npx gulp zip 以创建 Omeka S 的压缩版本，并将其存储在 /build 中。使用 --no-dev 标志省略 Composer 开发依赖项，以创建适合最终用户的小型软件包。官方发布遵循从新、干净的检出相同的流程。

库

Omeka 使用以下库，以及其他库

• Laminas
• Doctrine 2
• EasyRdf
• PHPUnit
• jQuery

开发标准

Omeka 开发遵循 Laminas 编码风格指南，并使用 git-flow 分支模型和 语义版本控制 2.0.0 版本方案。

有关更多信息，请参阅开发者文档。

版权

Omeka 版权所有 © 2015-至今 美国弗吉尼亚州维也纳数字奖学金公司 http://digitalscholar.org

数字奖学金公司根据 GNU 通用公共许可证（GPLv3）版本分发 Omeka 源代码。本许可证的完整文本在许可证文件中给出。

Omeka 名称是数字奖学金公司的注册商标。

在本分发中，适用处注明第三方版权。

保留所有未明确授予的权利。