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

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

内容简介:参考资料:目前这篇 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 文件资源?


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

查看所有标签

猜你喜欢:

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

程序员面试笔试宝典

程序员面试笔试宝典

何昊、叶向阳、窦浩 / 2012-10 / 59.80元

《程序员面试笔试宝典》除了对传统的计算机相关知识(C/C++、数据结构与算法、操作系统、计算机网络与通信、软件工程、数据库、智力题、英语面试等)进行介绍外,还根据当前计算机技术的发展潮流,对面试笔试中常见的海量数据处理进行了详细的分析。同时,为了更具说服力,《程序员面试笔试宝典》特邀多位IT名企面试官现身说法,对面试过程中求职者存在的问题进行了深度剖析,同时《程序员面试笔试宝典》引入了一批来自于名......一起来看看 《程序员面试笔试宝典》 这本书的介绍吧!

RGB转16进制工具
RGB转16进制工具

RGB HEX 互转工具

UNIX 时间戳转换
UNIX 时间戳转换

UNIX 时间戳转换

RGB CMYK 转换工具
RGB CMYK 转换工具

RGB CMYK 互转工具