jsOrrery 开源项目使用教程
1. 项目的目录结构及介绍
jsOrrery 是一个使用 WebGL 和 JavaScript 编写的太阳系轨道力学模拟项目。以下是项目的目录结构及其介绍:
jsOrrery/
├── assets/
├── dist/
│ ├── jsOrrery.js
│ ├── jsOrrery.css
│ └── index.html
├── src/
│ ├── main.js
│ ├── utils.js
│ └── ...
├── .babelrc
├── .eslintrc
├── .gitignore
├── LICENSE.md
├── README.md
├── package.json
├── server.js
└── webpack.config.js
assets/
: 存放项目所需的静态资源文件。dist/
: 包含构建后的应用文件,如jsOrrery.js
和jsOrrery.css
,以及一个示例 HTML 文件index.html
。src/
: 包含项目的源代码文件,如main.js
和utils.js
。.babelrc
: Babel 配置文件。.eslintrc
: ESLint 配置文件。.gitignore
: Git 忽略文件配置。LICENSE.md
: 项目许可证文件。README.md
: 项目说明文档。package.json
: 项目依赖和脚本配置文件。server.js
: 本地开发服务器配置文件。webpack.config.js
: Webpack 构建配置文件。
2. 项目的启动文件介绍
项目的启动文件主要位于 dist/
目录下,包括 jsOrrery.js
和 jsOrrery.css
,以及一个示例 HTML 文件 index.html
。
jsOrrery.js
: 这是项目的主要 JavaScript 文件,包含了太阳系模拟的核心逻辑。jsOrrery.css
: 这是项目的样式文件,定义了模拟界面的外观和布局。index.html
: 这是一个示例 HTML 文件,展示了如何将jsOrrery
嵌入到网页中。
在 index.html
中,你可以看到如何引入 jsOrrery.js
和 jsOrrery.css
文件,并通过调用 JSOrrery
类来初始化应用。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>jsOrrery Example</title>
<link rel="stylesheet" href="jsOrrery.css">
</head>
<body>
<div id="jsOrrery"></div>
<script src="jsOrrery.js"></script>
<script>
window.onJsOrreryLoaded = function(JSOrrery) {
const jsOrrery = new JSOrrery();
};
</script>
</body>
</html>
3. 项目的配置文件介绍
项目的配置文件主要包括 .babelrc
、.eslintrc
、package.json
和 webpack.config.js
。
.babelrc
: 这是 Babel 的配置文件,用于将现代 JavaScript 代码转换为向后兼容的版本。.eslintrc
: 这是 ESLint 的配置文件,用于检查和规范代码风格。package.json
: 这是 Node.js 项目的配置文件,包含了项目的依赖、脚本命令等信息。webpack.config.js
: 这是 Webpack 的配置文件,用于构建和打包项目。
以下是 package.json
文件的部分内容示例:
{
"name": "jsorrery",
"version": "1.0.0",
"description": "WebGL Solar System & orbital mechanics simulator",
"main": "dist/jsOrrery.js",
"scripts": {
"start": "webpack-dev-server --config webpack.config.js --mode development",
"build": "webpack --config webpack.config.js --mode production"
},
"dependencies": {
"webpack": "^5.0.0",
"webpack-dev-server": "^3.11.0"
}
}
通过运行 npm start