Discourse 主题(Themes)和主题组件(Theme Components)可用于自定义 Discourse 前端的观感和功能。本开发者指南部分旨在提供您所需的所有参考资料,以便开发简单的单站点主题,直至复杂的开源主题组件。
本介绍旨在提供主题开发所有工具和 API 的概览。如果您更喜欢主题开发的循序渐进教程,请直接跳转至:
主题与主题组件
Discourse 主题 可用于使用 CSS 和 JavaScript 自定义前端用户体验。每个主题都有自己的 Git 仓库,社区管理员通常可以通过 Discourse 管理面板安装和管理它们,即使在共享主机平台上也是如此。
主题组件 是旨在与其他主题组件一起作为整体主题一部分的主题。从开发角度来看,主题组件和主题几乎是相同的。在本指南中,“主题”和“主题组件”一词可互换使用。
先决条件
首先,请确保您了解 如何在 Discourse 中使用现有主题和主题组件。使用现成的(ready-made)主题是定制社区最快、最安全的方法。如果您需要更多功能,那么就该考虑编写自己的主题了。
作为 Discourse 整体架构 的一部分,Discourse 主题是使用标准的 HTML、CSS、JavaScript 技术构建的,并利用 Ember 概念来实现更高级的用户界面。这些参考指南假设您对这些技术有基础了解,并在可能的情况下链接到外部参考资料。
Discourse 是一个快速发展的项目,因此任何自定义主题都需要随着时间的推移进行维护。请确保在规划和开发过程中考虑到这一点。
入门
前端定制
更多!
查看其余的 开发者指南!
本文档受版本控制 - 请在 github 上建议更改。