基于开源工具快速搭建轻量带竖排手写批注的民国档案管理系统

前置准备

本次搭建使用免费开源的Omeka S+竖排插件+批注插件组合，无需编程基础，Windows/macOS/Linux通用。

环境与软件包

• Windows用户：下载XAMPP 8.2.12（PHP7.4-8.2兼容Omeka S 4.1.2），地址：https://sourceforge.net/projects/xampp/files/XAMPP%20Windows/8.2.12/xampp-windows-x64-8.2.12-0-VS16-installer.exe/download
• macOS/Linux用户：同XAMPP对应版本，或已配置Apache/Nginx+MySQL/MariaDB+PHP7.4-8.2环境（需开启PHP扩展：mbstring、gd、curl、pdo_mysql、xml、zip）
• Omeka S 4.1.2核心包：https://omeka.org/s/download/
• Omeka S竖排插件Vertical Writing：https://omeka.org/s/modules/VerticalWriting/
• Omeka S手写/文本批注插件CommentPress（轻量易用版）：https://github.com/omeka-s-modules/CommentPress/releases/download/v1.2.0/CommentPress.zip

环境搭建（Windows用户专属XAMPP步骤）

安装XAMPP

双击下载的XAMPP安装包，默认全选Apache、MySQL、PHP、phpMyAdmin，安装路径选C:\xampp（或其他纯英文路径），安装完成后启动XAMPP Control Panel，点击Apache和MySQL的Start按钮，状态灯变绿即可。

创建Omeka S数据库

打开浏览器输入http://localhost/phpmyadmin，默认账号root，密码留空。

1. 点击左侧新建，数据库名输入omeka_minguo，排序规则选utf8mb4_unicode_ci（兼容民国生僻字、异体字），点击创建。
2. 点击左侧刚创建的omeka_minguo数据库，再点击顶部权限→新增用户账户。
3. 用户名输入omeka_user，主机名选本地，密码输入自定义强密码（记牢，后续要用），勾选授予与数据库omeka_minguo相同的权限，点击右下角执行。

Omeka S核心系统部署

解压与上传文件

将下载的Omeka S 4.1.2压缩包解压，得到omeka-s文件夹，Windows用户直接将文件夹内所有内容（不是文件夹本身）复制到C:\xampp\htdocs\minguo_archive目录（需手动新建minguo_archive纯英文子目录）；macOS用户复制到/Applications/XAMPP/htdocs/minguo_archive；Linux用户根据环境复制到Apache/Nginx的web根目录下minguo_archive子目录。

配置数据库连接

打开minguo_archive目录下的config/local.config.php.dist，复制一份重命名为local.config.php，用记事本（Windows）或TextEdit（macOS纯文本模式）/vim（Linux）打开，找到以下内容并修改：

```php [ 'user' => 'omeka_user', // 替换为刚才创建的数据库用户名 'password' => '你的自定义强密码', // 替换为刚才设置的数据库密码 'dbname' => 'omeka_minguo', // 替换为刚才创建的数据库名 'host' => 'localhost', // 本地环境默认不用改 'port' => '3306', // XAMPP默认3306不用改 'unix_socket' => null, // Windows/macOS XAMPP默认不用改 'charset' => 'utf8mb4', // 必须保持utf8mb4 'collation' => 'utf8mb4_unicode_ci', // 必须保持这个排序规则 ], ]; ```

完成系统安装

打开浏览器输入http://localhost/minguo_archive，首次访问会跳转到安装页面：

1. 系统验证环境，全绿才能继续（如有红色报错，按照提示检查PHP扩展开启情况）。
2. 输入管理员信息：用户名、邮箱、密码（密码需含大小写字母、数字、特殊字符，长度≥8），网站标题输入“民国档案管理系统”，点击安装Omeka S。
3. 安装成功后，点击登录后台，用刚才的管理员账号密码登录。

民国专属功能插件安装与配置

安装插件

1. 后台左侧菜单点击模块→添加模块。
2. 点击选择文件，分别选择下载好的VerticalWriting.zip和CommentPress.zip，点击上传。
3. 上传完成后，在模块列表找到Vertical Writing和CommentPress，点击右侧安装按钮，状态变为“已激活”即可。

Vertical Writing竖排配置

1. 后台左侧菜单点击设置→站点设置，找到Vertical Writing部分。
2. 勾选默认启用竖排显示，可选择从右到左排列（传统民国排版），文字方向选垂直（从上到下），点击保存更改。

CommentPress批注配置

1. 后台左侧菜单点击模块→CommentPress→配置。
2. 启用允许手写批注（需上传图片）和允许文本批注，权限设置为所有登录用户可添加，管理员可审核/删除，点击保存设置。

民国档案资源录入实操

创建“民国文书”资源模板

1. 后台左侧菜单点击资源模板→添加资源模板，模板名称输入“民国文书”，点击创建。
2. 点击右侧属性标签，添加以下民国专属属性（其他通用属性按需保留）：
   • dc:title（文书标题，必填）
   • dc:creator（撰拟者/机关，必填）
   • dc:date（撰拟/发布日期，建议用民国纪年格式：民国XX年XX月XX日，必填）
   • dcterms:medium（载体形式：如纸质、油印、毛笔手抄）
   • dcterms:provenance（来源：如档案馆藏编号、私人捐赠）
3. 勾选刚添加的每个民国属性的竖排显示选项（在属性列表每行右侧），点击保存资源模板。

上传并标注单份民国档案

1. 后台左侧菜单点击项目→添加项目，项目名称输入“XX馆民国档案试录入”，点击创建。
2. 进入项目后点击添加项目资源→单个资源，资源模板选“民国文书”。
3. 填写必填属性：标题输入“民国XX县公署关于XX的训令”，撰拟者输入“XX县公署县长XXX”，日期输入“民国三十七年八月十五日”。
4. 点击左侧媒体标签，点击添加媒体，选择上传文件，上传档案的高清扫描件（PNG/JPG/TIFF均可，建议单页≤5MB，多页可分多次上传）。
5. 每上传一页，可在右侧媒体属性的dc:title输入“训令第X页”，方便检索。
6. 填写完成后点击保存并公开。

前台访问与民国特色展示验证

创建前台站点

1. 后台左侧菜单点击站点→添加站点，站点标题输入“XX馆民国档案数字平台”，URL段输入“minguo”，点击创建。
2. 进入站点编辑页面，点击左侧资源池，把刚才创建的“XX馆民国档案试录入”项目拖到右侧，点击保存。
3. 点击左侧导航，添加“资源浏览”导航项，点击保存。
4. 点击顶部访问站点，验证竖排显示和批注功能：
   • 资源浏览页面标题、属性默认从右到左垂直排列。
   • 点击单份资源进入详情页，右侧可添加文本/手写批注图片。