如何定制DSpace主题？

Question

我已在我的电脑上安装了DSpace。我使用Mirage作为默认主题，现在我想要为我的DSpace自定义它。我想要改变CSS文件（重新设计它），但是我不知道正确的步骤来设置我的自定义样式。我可以编辑我的CSS文件在[dspace]/webapps/themes/Mirage/lib/css/文件夹中，但在重建DSpace之后它们将被删除。那么，修改已经安装的主题的正确方法是什么呢？我应该编辑CSS文件并将它们添加到[dspace-source]/dspace/modules/src/main/文件夹中，然后重建我的webapps吗？我已经阅读了官方文档，但是没有找到适当的答案来回答我的问题。

- Ziyaddin Sadigov

Answer 1

1. 在 [dspace-src]/dspace/modules/xmlui/src/main/webapps/theme/[yourTheme] 中创建你的主题文件夹。
2. 将你想要修改的 CSS（或 js 或 xsl）文件复制到该目录中，你可以在 [dspace-install] 中找到源文件的副本，或者在项目的 github 页面上找到它们。
3. 编辑你的修改。
4. 在 [dspace-src]/dspace 中运行 "dspace package" 命令进行 maven 构建，该命令将获取主题的源文件并覆盖你的自定义。结果构建在 "target" 文件夹中。
5. 进入 [dspace-src]/dspace/target/dspace-installer 目录。
6. 运行 "ant update" 命令，该命令将把构建好的文件安装到 [dspace-install] 中。
7. 重新启动 tomcat。

以下页面可能有一些有用的资源。

https://wiki.duraspace.org/display/DSDOC5x/XMLUI+Configuration+and+Customization

- terrywb

---

谢谢您的回答！这是否意味着当我想要修改DSpace中的某些文件时，我应该在[dspace-source]中进行操作？这个过程适用于所有类型的文件吗？因为除了主题文件之外，我还有必要有时修改配置.cfg文件、.xconf文件和.xml文件。 - Ziyaddin Sadigov

是的，你应该在 [dspace-source] 中进行更改，将这些更改保存到像 git 这样的源代码仓库中，并重新构建。如果您一直在安装目录中进行更改，请务必在运行构建之前保存这些更改，因为整个安装目录将被重写。 - terrywb

很清楚。还有一个问题：我发现当我修改webapps文件夹中的一个文件并重新构建我的[dspace-source]时，在下一次重建中，即使我不再包含此文件，该文件也会自动重写到我的安装文件夹中。这是正确的观察吗？就像修改过的文件在每次下一次重建时都会被保留在某个地方，即使它们没有被包含在.../modules/...文件夹中进行下一次重建。 - Ziyaddin Sadigov

有些文件可能仍然存在于构建目录中。如果您运行“mvn clean package”，它将清除目标目录并重新构建它。 - terrywb

我为dspace创建了聊天室。https://chat.stackoverflow.com/rooms/227459/dspace-repository-guide-help-room - Stilgar Dragonclaw