用途:在 drupal.org 上创建或编辑项目页描述(drupal.org/project/<name> 的模块或主题正文),生成保存为 .html 文件供维护者粘贴到项目描述字段。
主要能力:生成或编辑受 drupal.org 限制的 HTML 正文;使用平台自带特殊 CSS 类,实现方格提示框、提示框、绿色按钮、网格与并排列表等样式。
必要用法与规则:首个元素始终是一个 <p> 说明项目用途,会成为列表和搜索中的预览文本,之前不加标题。只用允许的 HTML:<h2> 到 <h4>、<p>、<strong>、<em>、<i>、<code>、<blockquote>、<img>、<a>、<ul>/<ol>/<li>、<table>、<del>、<hr>,其余保存时会被剥离。新建项目按顺序包含 Features、Installation,相关时再加 Related Modules(用 <h3>,且放在特殊 div 之外)、Requirements/Dependencies(除非要求不寻常,否则不列 Drupal 核心或 PHP 版本)。编辑现有页面先读取线上页面:curl -sL "https://www.drupal.org/project/<dataname>" -o page.html,保留维护者原有结构与语气。特殊组件按资料给定模式使用(note-version、note-tip、warning、action-button、view-view-grid、guide-contents),外部链接加 rel="nofollow"。写入前先确认输出路径,默认模块目录下 PROJECT_DESCRIPTION.html。
写作风格:主动语态,简洁直接,不用破折号(em/en dash),不用对比式或反问式表述,无营销夸张、主观评价、表情符号,陈述可核实事实。
限制:截图仅在可访问站点且有浏览器权限时截取,否则跳过,不编造图片 URL;特殊提示框不宜过度使用;不支持的标签或类会被保存时剥离。