Portugol Webstudio 使用指南

Portugol Webstudio 使用指南

Portugol-WebstudioIDE online para o Portugol项目地址:https://gitcode.com/gh_mirrors/po/Portugol-Webstudio

1. 项目目录结构及介绍

Portugol Webstudio 是一个基于Angular构建的在线IDE，专为葡萄牙语编程爱好者设计，模拟了传统的Portugol Studio环境。项目采用模块化管理，主要由以下七个核心包组成：

• @portugol-webstudio/antlr: 包含Portugol语言的语法规则，以及解析器(lexer和parser)的生成。
• @portugol-webstudio/parser: 新的解析器包，处理由ANTLR预处理的抽象语法树，并转换成语义树。
• @portugol-webstudio/resources: 存储Portugol的相关资源，如示例代码和帮助文档。
• @portugol-webstudio/runner: 负责在Web Workers中执行编译后的代码，处理输入输出、错误和事件。
• @portugol-webstudio/runtime: 包含Portugol到JavaScript的转译器及其运行时所需的代码，比如变量、库等。
• @portugol-webstudio/worker: 包含将在Web Workers内执行的代码，负责接收Portugol代码并执行。
• @portugol-webstudio/ide: 用户界面部分，旨在复制Portugol Studio的界面。

项目根目录下还包含了必要的开发配置和脚本文件，例如gitignore, .prettierrc, LICENSE, README.md, angular.json, package.json等。

2. 项目的启动文件介绍

启动这个项目的主要入口点是通过npm脚本完成的，主要依赖于package.json中的命令。开发者通常会使用以下命令来启动项目：

• npm start: 这个命令用于启动开发服务器，便于实时查看应用的变化，非常适合开发过程中使用。

项目的实际运行逻辑散布于上述核心包中，特别是在IDE相关的组件和服务中，它们共同构成应用的启动流程。

3. 项目的配置文件介绍

package.json

此文件是Node.js项目的元数据文件，它定义了项目的基本信息、脚本命令、依赖项、贡献者等。对于开发者来说，重要的脚本命令包括启动开发服务器（"start"）、构建项目（"build"）等。

angular.json

Angular应用程序的主要配置文件，决定了构建过程的行为，包括输出路径、样式文件设置、开发服务器端口等。开发者可以根据项目需求调整这些配置以优化开发或生产环境部署。

其他配置文件

• tsconfig.json: TypeScript编译选项配置文件，控制TypeScript源码编译过程。
• .prettierrc: Prettier的配置文件，用于代码风格统一。
• lerna.json (如果有): 如果项目采用了Lerna进行多包管理，它记录了Lerna的配置信息。

综上所述，Portugol Webstudio项目通过精心组织的目录结构和详细的配置文件，为用户提供了一个既适合学习也利于协作的在线编程环境。开发者可以依据以上介绍快速理解和入门该项目。

Portugol-WebstudioIDE online para o Portugol项目地址:https://gitcode.com/gh_mirrors/po/Portugol-Webstudio