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

4.0 KiB

markup, title, import
markup title import
occlusion 原始主题属性与显式编译
网页 text
ext/web/网页.mq.md lib/text.mq.md

主题保留原站的四组属性值,控件与容器只引用类名。它没有大段作者 CSS 或页面字符串。服务入口调用编译,将结果通过原生文件写到明确的生成路径,再让布局引用该资源。

顶栏

返回 类型 说明
结果 any 导航背景与底部分隔线

导航内容采用白色背景,并以浅色细线与下方内容分开。返回值保留原有颜色和边框,不负责导航链接或几何布局。它是纯属性数据,调用不加载插件、不写文件;编译阶段才把它映射到原生导航类。

属性 =

属性 值
background #ffffff
border-bottom 1px solid #e7e5e4

属性明确后返回 属性,供主题编译继续使用。

侧栏面板

返回 类型 说明
结果 any 侧栏背景属性

侧栏用浅色背景区分任务跳转与主体内容。这里只保留原有背景值,不重复设置父行宽度或移动端折叠行为。纯属性表可以独立阅读和比较,调用不查询数据,也不生成样式文件;父布局继续拥有侧栏位置。

属性 =

属性 值
background #f5f5f4

属性明确后返回 属性,供主题编译继续使用。

卡片标题

返回 类型 说明
结果 any 文章标题字号与间距属性

请求查询资源生成的文章卡片使用这些标题声明,保留原始字号和下边距。标题内容仍由真实记录提供且经过转义,样式不会注入文章文字或链接。属性构造为纯计算,不运行查询;选择器在编译阶段与原生卡片结构对齐。

属性 =

属性 值
font-size 1.15rem
margin 0 0 0.35rem

属性明确后返回 属性,供主题编译继续使用。

卡片正文

返回 类型 说明
结果 any 文章正文颜色与间距属性

文章正文保留原站的次级文字颜色和零外边距。此表不截断或替换正文,也不改变 Markdown 与数据字段之间的约定。它只提供纯属性数据,布局、渲染和数据库生命周期都在各自模块,编译后再引用共同的主题文件。

属性 =

属性 值
color #57534e
margin 0

属性明确后返回 属性,供主题编译继续使用。

编译

返回 类型 说明
结果 text 四个原始属性表编译成的有序 CSS

调用需要 plugin,按导航、侧栏、卡片标题和正文的顺序编译。选择器直接对应原生组件与查询卡片,避免重复声明一份旧页面绑定布局。所有属性值保留原站定义;通用响应式几何仍由 View 运行时负责。

本函数不写文件或挂载资源,调用者收到文本后通过原生文件能力写入明确目标。编译失败应阻止监听,不能退回旧样式假装本轮成功。修改单块属性只改上面的对应函数,验证编译结果与真实窄屏页面,避免颜色保留却丢失结构作用。生成文件可以重建,原始声明仍以本文件为准。

我们 导航 = 读取原有导航属性、侧栏 = 读取原有侧栏属性、标题 = 读取原有标题属性 和 正文 = 读取原有正文属性。 随后 导航样式 = [编译导航类](网页.编译样式(名称="topnav", 属性=导航))、侧栏样式 = [编译侧栏类](网页.编译样式(名称="side", 属性=侧栏))、标题样式 = [编译实际卡片标题选择器](网页.编译样式(名称="content.cards h2", 属性=标题)) 和 正文样式 = [编译实际卡片正文选择器](网页.编译样式(名称="content.cards p", 属性=正文))。

片段 =

样式
导航样式
侧栏样式
标题样式
正文样式

编译完成后返回 [保留声明顺序](text.str_join(xs=片段, sep="\n"))。