Files
marqdo/examples/web-site-zh/styles/shell.mq.md

278 lines
15 KiB
Markdown

---
markup: occlusion
title: 原始文学主题声明的读取与比较
import:
document: lib/document.mq.md
web: ext/web/web.mq.md
table: lib/table.mq.md
text: lib/text.mq.md
---
本文件保留原始数据读取与 CSS 编译,用于比较迁移前的声明。当前站点从 styles/index.mq.md 编译 View 映射;不要把本文件输出误当成新树已经适配。数据叶子中每条原始声明保持可阅读、可独立调用。
## vars
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
整站色板、字体、间距与阴影令牌。
使用这些自定义属性的规则应在令牌之后编译。选中文字颜色与 :root 一样保持全局,不应被框架映射限制在某张卡片中。修改值会影响整站,需核对实际 CSS 与浏览器颜色,不能只在局部重命名引用。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="vars"))*.
## motion
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
原有入场、漂浮、粒子与辉光关键帧。
关键帧地址、属性和值保持全局及原顺序,时长仍归使用它的规则。读到数据不会启动动画,浏览器加载编译主题后才应用。View 投影不能给这些地址加组件前缀,也不能为了静态截图删除运动能力。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="motion"))*.
## layout
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
文档背景、排版与原有区域网格声明。
旧 body 状态描述过去的页面壳,当前样式入口只把已知地址映射到明确 site-layout 区域,属性值不变。背景和粒子层继续属于文档全局,任何修改都应对照真实宽窄屏几何,而不是只比较声明数量。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="layout"))*.
## responsive
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
原始媒体条件及减少动画偏好的规则。
媒体文本保留为独立列。宽度条件收拢公共网格并调整留白,减少动画偏好关闭指定动画而非删除关键帧。核对时保留行顺序、媒体和值,不能仅因为 CSS 中仍出现选择器名就认定断点有效。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="responsive"))*.
## topnav
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
顶部导航外观的命名属性和值。
原有吸顶、渐变、模糊、间距与分隔线继续作用于原生 topnav 类。目标链接与实际会话条件归导航资源,属性表不能认证用户或注册路由。编译也不意味着样式文件已保存或挂载,服务入口负责这些后续步骤。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="topnav"))*.
## side_panel
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
公共侧栏外观的命名属性和值。
侧栏背景、留白与分隔线区分任务入口和正文,外部网格位置仍归父框架,后台有意不带该区域。这里不维护另一份链接或会话判断。修改外观后应确认窄屏仍在正文之后显示,不能用隐藏侧栏掩盖布局错误。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="side_panel"))*.
## footer
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
结束区域外观的命名属性和值。
颜色、字号、间距、边框与背景保留原站定义。Markdown 叶子拥有真实链接,本表既不创建目的地也不执行退出。公共与后台页脚可共享相同外观,内容仍分别维护,父层继续决定位置。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="footer"))*.
## card_title
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
文章卡片标题的命名排版属性。
当前查询渲染器转义文章标题并保留原生 h2,View 主题直接选择该结构,不恢复旧 front/back 绑定。读取不查询文章、不截断标题或修改持久数据;应结合真实卡片确认属性到达实际标题。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="card_title"))*.
## card_body
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
卡片摘要的命名排版属性。
摘要来自当前查询,完整 Markdown 正文仍留给详情。本表只改变外观,不选择或替换内容。选择器调整后要同时验证转义摘要和完整正文的独立行为,不能用摘要冒充缺失的正文。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="card_body"))*.
## chrome
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
原始引言面板、徽章容器、阅读步骤和全文规则。
当前引言是终端 Markdown,因此映射选择真实标题、项目符号与编号列表;文章规则继续选择原生详情结构。保留明确映射与原值,不应为恢复旧选择器而把整段内容藏回作者 HTML。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="chrome"))*.
## kicker
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
引言分类标签的命名排版属性。
字距、颜色、小字号和漂浮动画选择分类所用的 Markdown 引用块,分类文字仍是内容叶子中直接可读的一行。编译这些属性不会创建文字或下载字体,加载与实际呈现需另外观察。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="kicker"))*.
## intro_title
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
引言主标题的命名字体与响应式属性。
保留展示字体、响应字号、渐变文字与辉光动画,View 主题选择真实 Markdown h1,避免把字号施加到包装层后又被浏览器标题倍乘。验收检查计算字体和尺寸,读到属性不能证明渲染已正确。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="intro_title"))*.
## lede
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
引言解释段落的命名排版属性。
宽度、行高、颜色、间距和字体选择叶子中的解释段落,与特性徽章和编号步骤保持独立。目标应是实际段落,而非依赖包装层与浏览器默认外边距凑出近似效果;内容仍由终端 Markdown 维护。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="lede"))*.
## claim
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
单条简短特性徽章的命名属性。
Markdown 无序列表对应原来的 flex 徽章容器,列表项使用这里的 inline 徽章属性。容器的间距与换行归 chrome 章节。分别保留两层责任,才能同时得到直接可读的列表内容和原来的视觉分组。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="claim"))*.
## step
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
单条阅读步骤原有的外边距。
这里只有一条属性行,原生结果含标量单元格,而不是列式列表,样式编译器支持这个形态。Markdown 编号列表拥有序号和链接,本值只提供条目留白,不改变阅读顺序或在后台替用户执行步骤。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="step"))*.
## widgets
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | 原始 选择器、属性、值及可选媒体 表,保留列式或单行标量形态 |
原始卡片、表单、提示和管理状态声明。
悬停与焦点、字段宽度、操作行和后台选择器保持原顺序。原生表单资源拥有校验与提交,主题只映射结构地址。可见错误外观不能证明服务器已经拒绝输入,仍需实际失败和成功提交验收。
从站点根授权 fs.read;精确章节必须唯一,缺失或格式不支持时保留原生诊断。返回值仍是数据,不写文件、不执行动画或查询业务。
读取完成后返回 *[读取这一章实际原始字面表](document.read_table(path="styles/shell.tables.md", title="widgets"))*.
## _compile
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| name | text | 必填 | shell.tables.md 中精确原始章节 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 按原始选择器编译的单个主题区段 |
使用`name`,从站点根授予 fs.read 与 plugin。原生读取保留原始值与形态,编译器处理选择器、媒体和关键帧。这个内部工具特意保留旧壳的地址,用于比较迁移前 CSS;当前服务使用 styles/index 的明确 View 映射。缺失章节保留诊断,返回文本既不写文件,也不证明新结构已经适配。
我们 **declarations = [读取原始区段的实际声明](document.read_table(path="styles/shell.tables.md", title=`name`))**.
最后返回 *[编译原地址用于保留比较](web.make_style(name=`name`, table=`declarations`))*.
## css
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 保持原六区段地址与级联的基准 CSS |
从站点根授权 fs.read 和 plugin,依次编译令牌、关键帧、布局、断点、引言与控件。这六段地址、顺序和连接方式保持原实现,用于原始数据与散列比较。命名属性仍可分别读取,但不额外加入本基准,以免改变原级联;它们由新的 View 入口恢复到实际目标。
当前站点不直接加载这个旧壳基准,实际样式见 styles/index。散列相同只能证明原始主题编译保留,不能证明新的选择器匹配、字体送达或移动布局正确。用 verify 的逐行比较加上真实浏览器验证,并由服务入口显式保存实际新主题。
`names` =
| name |
|---|
| vars |
| motion |
| layout |
| responsive |
| chrome |
| widgets |
We **parts = [Start the ordered compiled sections](table.empty_list())**.
- [Compile each area in the declared cascade order](for names as name)
We **css = [Compile the selected theme area](_compile(name=`name`))** and **parts = [Preserve its original position](table.append(list=`parts`, item=`css`))**.
Return *[Join the compiled sections without changing separators](text.str_join(xs=`parts`, sep=""))*.