README

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

安装

要求

• Linux
• Apache
• MySql 5.5.3+ 及 PDO 的 MySQL 驱动
• PHP 5.6+（建议使用最新稳定版）及 PDO 扩展

注意事项

• 生成缩略图的默认库是 ImageMagick，至少版本 6.7.5。旧版本将无法正确生成缩略图。请参见下面的 local.config.php 选项。

从 GitHub 安装

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

从发布压缩文件安装

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

您可以在 application/ 下找到 Omeka 特定的代码。

更新

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

从 GitHub 更新

1. 像平常一样执行 git pull。在官方发布之前，最新代码将在 'develop' 分支。
2. 从 Omeka S 根目录运行 gulp deps，以确保依赖项是最新的。
3. 比较 /config/local.config.php 和 /config/local.config.php.dist 中的更改。某些默认配置可能已更改，因此您可能需要将分发配置的更改与本地配置（例如，特定于服务器的 PHP 路径、开发模式设置等）进行协调。
4. 在您的网页浏览器中，访问您的网站并运行所需的任何迁移。

从发布压缩文件更新

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

local.config.php 选项

• thumbnailer 默认为 Omeka\File\ImageMagickThumbnailer。还可用的是 Omeka\File\IMagickThumbnailer 和 Omeka\File\GdThumbnailer
• phpcli_path 默认为尝试检测正确的 PHP 路径。如果需要，请使用此选项在服务器配置中指定路径。例如

    'cli' => array(
        'phpcli_path' => '/usr/bin/php55',
    ),

库

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

• Zend Framework 3
• Doctrine 2
• EasyRdf
• PHPUnit
• jQuery

编码标准

Omeka开发遵循Zend Framework 2编码规范，并使用git-flow分支模型。