Marko.js 入门教程

1. 项目目录结构及介绍

在Marko.js项目中，通常有一个标准的目录结构，其中包括以下几个关键部分：

• src - 这是主要的源代码目录，包含了你的Marko组件和应用逻辑。

  • components - 存放自定义的Marko UI组件。
  • templates - 包含HTML-like的Marko模板文件。

• public - 用于存放静态资源，如CSS样式表、JavaScript文件和图片。

• .gitignore - 定义了版本控制系统应该忽略哪些文件或目录。

• package.json - 项目元数据和依赖管理，包括项目的名称、版本以及npm脚本。

• index.html - （可选）如果你的应用是一个单页应用，这个可能是入口HTML文件。

• server.js 或 app.js - 主服务器文件，负责启动应用和处理HTTP请求。

2. 项目的启动文件介绍

启动文件，通常是server.js或者app.js，这是你的Marko应用的核心。它导入必要的库，设置路由，渲染模板，并启动一个Web服务器。一个简单的例子可能如下所示：

// 导入Marko和Express
const express = require('express');
const marko = require('marko/node-require');

// 初始化Express应用
const app = express();

// 使用Marko模板引擎
marko.registerEngine('.marko', {
  render: (template, input, output) => {
    template.render(input, output);
  }
});

// 设置路由并渲染模板
app.get('/', (req, res) => {
  res.marko('./templates/home.marko'); // 渲染home模板
});

// 启动服务器
app.listen(3000, () => console.log('App listening on port 3000!'));

这里，res.marko方法用于渲染指定的Marko模板文件，并将其作为响应发送给客户端。

3. 项目的配置文件介绍

在大型项目中，你可能会有单独的配置文件，比如config.js或.env来存储环境变量和其他项目设置。这些文件可以包含数据库连接字符串、API密钥或开发/生产环境的不同配置。例如：

// config.js
module.exports = {
  env: process.env.NODE_ENV || 'development',
  port: process.env.PORT || 3000,
  database: {
    url: process.env.DATABASE_URL || 'mongodb://localhost:27017/myapp'
  },
  secretKey: process.env.SECRET_KEY || 'your-secret-key'
};

然后，在你的主文件中，你可以导入并使用这些配置：

const config = require('./config');

// 使用配置项
console.log(config.port); // 输出配置的端口号

通过这种方式，你可以将敏感信息和特定于环境的设置与代码分离，保持代码库更整洁和安全。