轻语言网站工程项目结构

文档概述

轻语言网站程序采用标准前端三大件（HTML/CSS/JS）+ 自主设计的中文 WEB 框架设计而成，以轻语言作为第一编程语言，并同时支持可视化界面设计。本章介绍一个标准的轻语言网站程序项目的目录结构、各文件扩展名的含义、以及必备的成对关系（.spl 与 .spldg、.usc 与 .uscdg）。

学习目标

阅读本文档后，你应当能够掌握以下内容：

• 轻语言网站项目的标准目录结构
• 各文件扩展名的含义与编译输出目标（.spl/.spldg/.jsx/.js/.sph/.usc/.uscdg）
• 必须成对出现的文件类型及其原因
• App.spl 作为入口文件的位置与作用
• 程序集 与 资源 目录的作用
• .vsln 项目索引文件与 _build 编译输出目录

项目目录结构

标准的轻语言网站程序项目结构文件夹目录为：

• 程序集 存放页面布局文件、页面逻辑、公用模块代码、脚本、自定义组件、CSS 样式表等文件。

  • .spl 实现页面逻辑交互的文件，采用轻语言语法规则编写代码，例如：登录页面.spl

  • .spldg 页面布局设计文件，文件内容采用 XML 格式编写，例如：登录页面.spldg

  • .jsx 使用轻语言语法编写的中文 JS 脚本文件，编译时转换为标准 JS 脚本文件。

  • .js 原生 JS 代码脚本文件、使用 JavaScript 语言编写代码。

  • .sph 后端服务器运行的脚本文件，编译时转换为标准的 PHP 代码文件。

  • .usc 用户自定义组件逻辑交互文件。

  • .uscdg 用户自定义组件的界面设计布局文件。

• 资源 存放静态资源文件，例如：图片、文本、视频、音频等等

• App.spl 在浏览器中打开网站时的入口文件

• *.vsln 项目索引文件

• _build 项目编译输出目录，新建项目时不存在，仅在编译时创建生成。

文件扩展名速查表

💡 命名记忆：dg 是 design 的缩写，表示该文件是对应逻辑文件的"界面设计文件"。例如 .spldg 是 .spl 的设计文件，.uscdg 是 .usc 的设计文件。

App.spl

该文件为网站的启动入口文件、当网站每次重新打开、或被访问的时候、都会先执行该文件、开发者可以在该文件中添加初始化相关代码。

事件 网站被访问()
    切换页面("首页")
结束 事件

💡 详细的入口文件用法请参考文档轻语言网站：程序入口文件。

特别注意

1. .spl 与 .spldg 必须成对

• .spl 与 .spldg 在项目中必须同时成对出现，例如：登录页面.spl、登录页面.spldg
• 两个文件的名称必须相同（不含扩展名）
• 若只存在其一，IDE 与编译器将无法正确处理

2. .usc 与 .uscdg 必须成对

• .usc 与 .uscdg 在项目中必须同时成对出现，例如：计时器.usc、计时器.uscdg
• 同样要求两个文件的名称相同

3. 静态资源路径前缀

• 静态资源文件（图片、音视频等）必须放在 资源（static）目录中
• 代码引用时需带上 ./static/ 前缀，详见文档轻语言网站：静态资源文件的使用

4. 入口文件 App.spl 唯一

• App.spl 是整个网站的入口文件，文件名固定不可更改
• 其中必须包含 网站被访问 事件，详见文档轻语言网站：程序入口文件

5. 编译输出目录 _build

• _build 目录仅在编译时创建，不要手动修改
• 项目部署时通常部署 _build 目录下的输出文件

学习要点总结

相关文档

• 文档轻语言网站：程序入口文件 —— App.spl 入口文件详解
• 文档轻语言网站：界面XML定义规范 —— .spldg/.uscdg XML 写法
• 文档轻语言网站：静态资源文件的使用 —— 资源目录用法
• 文档轻语言网站：服务端脚本程序API接口 —— .sph 后端脚本写法
• 文档综合演示：公用模块全局变量函数使用演示 —— .jsx 公用模块用法
• 文档轻语言网站：与原生JS混合开发 —— .js 原生脚本用法
• 文档轻语言网站：轻语言语法速查 —— .spl 语法规则
• 文档自定义组件 —— .usc/.uscdg 自定义组件开发