如何在 phabricator 中添加或更新 js 或 CSS 文件资源?

栏目: 前端 · 发布时间: 6年前

内容简介:参考资料:目前这篇 wiki 文档还没有中文翻译,大家可以权当是我对此的翻译加自己的实践总结吧。解释如何向 Phabricator 添加新的 CSS 和 JS 文件。

参考资料: Adding New CSS and JS

目前这篇 wiki 文档还没有中文翻译,大家可以权当是我对此的翻译加自己的实践总结吧。

给 phabricator 添加新的 CSS 和 JS 文件

解释如何向 Phabricator 添加新的 CSS 和 JS 文件。

概述

Phabricator 使用一个名为 Celerity 的系统来管理静态资源。 如果你是现任或前任Facebook员工,Celerity 基于 Facebook 使用的 Haste 系统,通常表现相似。

本文档适用于 Phabricator 开发人员和贡献者。 对于第三方代码,插件或扩展,此过程无法正常运行。

添加新文件

要添加新的 CSS 或 JS 文件,请在 phabricator/ 中的 webroot/rsrc/css/webroot/rsrc/js/ 中的适当位置创建。

每个文件必须 @provides 自己作为组件,在标题注释中声明:

/**
 * @provides duck-styles-css
 */

.duck-header {
  font-size: 9001px;
}

请注意,此注释必须是 Javadoc 样式的注释,而不仅仅是任何注释。

如果你的组件依赖于其他组件(这在 JS 中很常见但在 CSS 中很少见且不可取),那么请使用 @requires 声明:

/**
 * @requires javelin-stratcom
 * @provides duck
 */

/**
 * Put class documentation here, NOT in the header block.
 */
JX.install('Duck', {
  ...
});

然后重建 Celerity 映射(参见下一节)。

改变现有文件

添加,移动或删除文件或更改现有 JS 或 CSS 文件的内容时,应重建 Celerity 映射:

phabricator/$ ./bin/celerity map

如果您只更改了文件内容,即使您没有更改文件内容,但如果您跳过此步骤,它们将来也可能无法正常工作。

生成的文件资源 /celerity/map.php 经常导致合并冲突。可以通过运行 Celerity 映射器来解决它们。您可以通过运行以下命令自动执行此过程:

phabricator/$ ./scripts/celerity/install_merge.sh

这将安装 Git merge 驱动,该驱动将在此文件发生冲突时运行。

包含文件

要在页面中包含 CSS 或 JS 文件,请使用 require_celerity_resource()

require_celerity_resource('duck-style-css');
require_celerity_resource('duck');

如果您的映射是最新的,则现在应该在呈现页面时正确包含资源。

您应该将此调用尽可能靠近实际使用资源的代码,即不在 Controller 的顶部。 我们的想法是,只有当您在页面的特定呈现中实际使用资源时,才应该 require_celerity_resource() 资源,而不仅仅是因为页面的某些视图可能需要它。

解决问题

为什么我修改资源文件,还是不生效呢?

如果你使用的是 bitnami docker-compose 版本,则,你可以直接通过 docker exec -it phabricator /bin/bash 进入容器,然后 cd /opt/bitnami/phabricator/webroot/rsrc/ 进入到指定文件夹,修改你所需要修改的 js 或者 css 文件。

然后你需要执行:

$ celerity map
Rebuilding 1 resource source(s).
Rebuilding resource source "phabricator" (CelerityPhabricatorResources)...
Found 111 binary resources.
Found 383 text resources.
Found 10 packages.
Writing map "/opt/bitnami/phabricator/resources/celerity/map.php".
Done.

看到此内容即表示更新映射成功,你只需要重启你的容器服务即可。

$ docker-compose restart phabricator

参考资料

  1. Adding New CSS and JS

茶歇驿站

一个可以让你停下来看一看,在茶歇之余给你帮助的小站,这里的内容主要是后端技术,个人管理,团队管理,以及其他个人杂想。

如何在 phabricator 中添加或更新 js 或 CSS 文件资源?


以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

网络营销实战密码

网络营销实战密码

昝辉Zac / 电子工业出版社 / 2009.1 / 56.00元

本书是作者几年来网络营销实战的总结,与其他网络营销书籍最大不同之处是:只专注于实战,不谈理论。本书分三部分详细介绍了网络营销实用策略和技巧,并分析了大量实战案例。第一部分介绍市场与产品研究,包括用户、市场和竞争对手的调查;产品、目标市场的确定;价格策略;赢利模式等。第二部分讨论以网络营销为导向的网站设计,包括怎样在网站上卖东西、提高转化率,以及网站目标设定等。第三部分研究怎样给网站带来流量,详细讨......一起来看看 《网络营销实战密码》 这本书的介绍吧!

HTML 编码/解码
HTML 编码/解码

HTML 编码/解码

URL 编码/解码
URL 编码/解码

URL 编码/解码

html转js在线工具
html转js在线工具

html转js在线工具