Principles of Sustainable Software Engineering 项目常见问题解决方案

Principles of Sustainable Software Engineering 项目常见问题解决方案

principles-green Website for Principles of Sustainable Software Engineering 项目地址: https://gitcode.com/gh_mirrors/pr/principles-green

1. 项目基础介绍和主要编程语言

该项目是一个关于可持续软件工程原则的开源项目，它旨在定义、构建和运行可持续的软件应用程序所需的核心能力。项目使用以下主要编程语言：

• SCSS (34.8%)
• JavaScript (33.2%)
• Nunjucks (32.0%)

2. 新手在使用这个项目时需要特别注意的3个问题及解决步骤

问题1：如何本地部署网站？

解决步骤：

1. 克隆项目到本地文件夹：git clone https://github.com/jawache/principles-green.git

2. 安装依赖：npm install

3. 在项目根目录下创建一个名为 server.js 的文件，并添加以下代码：

   var express = require('express');
   var mds = require('markdown-serve');
   var path = require('path');
   
   var app = express();
   app.set('views', path.join(__dirname, 'views'));
   app.set('view engine', 'jade');
   app.use(mds.middleware([ 
       rootDirectory: path.resolve(__dirname, '/'),
       view: 'markdown'
   ]));
   
   app.listen(3000, function() {
       console.log('Server is running on http://localhost:3000');
   });
   

4. 运行服务器：npm run start 或 node server.js

5. 打开浏览器并访问 http://localhost:3000，查看网站。

问题2：如何添加新的Markdown文件到项目中？

解决步骤：

1. 在项目根目录下的 views 文件夹中创建一个新的 .md 文件，例如 new-page.md。
2. 在 server.js 文件中确保 mds.middleware 配置正确，以便能够识别和渲染新的Markdown文件。
3. 重新启动服务器，确保新的Markdown文件被加载。
4. 在浏览器中访问 http://localhost:3000/new-page，查看新页面内容。

问题3：如何贡献代码到这个项目？

解决步骤：

1. Fork 项目：在GitHub上点击项目页面上的 "Fork" 按钮。
2. 克隆你的Fork到本地：git clone https://github.com/你的GitHub用户名/principles-green.git
3. 在本地进行你的更改，并确保所有的更改都遵循项目的编码标准和贡献准则。
4. 提交你的更改：git commit -m '你的提交信息'
5. 推送你的更改到你的Fork仓库：git push origin main
6. 在GitHub上创建一个Pull Request，请求将你的更改合并到原始项目中。
7. 等待项目维护者的审查和合并。

principles-green Website for Principles of Sustainable Software Engineering 项目地址: https://gitcode.com/gh_mirrors/pr/principles-green