PageBuilder 项目使用教程

PageBuilder 项目使用教程

PageBuilderAn arduino library to create html string in the sketch for ESP8266/ESP32 WebServer.项目地址:https://gitcode.com/gh_mirrors/pa/PageBuilder

1. 项目的目录结构及介绍

PageBuilder 项目的目录结构如下：

PageBuilder/
├── examples/
│   ├── Basic/
│   │   ├── Basic.ino
│   │   └── index.html
│   └── Advanced/
│       ├── Advanced.ino
│       └── index.html
├── src/
│   ├── PageBuilder.cpp
│   └── PageBuilder.h
├── LICENSE
└── README.md

目录结构介绍

• examples/: 包含项目的示例代码，分为 Basic 和 Advanced 两个子目录，分别展示了基本和高级的使用方法。
  • Basic/: 基本的示例代码，包含一个 Arduino 文件和一个 HTML 文件。
  • Advanced/: 高级的示例代码，包含一个 Arduino 文件和一个 HTML 文件。
• src/: 包含项目的源代码文件，包括 PageBuilder.cpp 和 PageBuilder.h。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件位于 examples/Basic/Basic.ino 和 examples/Advanced/Advanced.ino。

Basic.ino

#include <PageBuilder.h>
#include <ESP8266WebServer.h>

ESP8266WebServer server(80);
PageBuilder pb;

void setup() {
    Serial.begin(115200);
    WiFi.begin("your-ssid", "your-password");
    while (WiFi.status() != WL_CONNECTED) {
        delay(500);
        Serial.print(".");
    }
    Serial.println("");
    Serial.println("WiFi connected");
    Serial.println("IP address: ");
    Serial.println(WiFi.localIP());

    server.on("/", []() {
        server.send(200, "text/html", pb.build());
    });

    server.begin();
    Serial.println("HTTP server started");
}

void loop() {
    server.handleClient();
}

Advanced.ino

#include <PageBuilder.h>
#include <ESP8266WebServer.h>

ESP8266WebServer server(80);
PageBuilder pb;

void setup() {
    Serial.begin(115200);
    WiFi.begin("your-ssid", "your-password");
    while (WiFi.status() != WL_CONNECTED) {
        delay(500);
        Serial.print(".");
    }
    Serial.println("");
    Serial.println("WiFi connected");
    Serial.println("IP address: ");
    Serial.println(WiFi.localIP());

    server.on("/", []() {
        server.send(200, "text/html", pb.build());
    });

    server.begin();
    Serial.println("HTTP server started");
}

void loop() {
    server.handleClient();
}

启动文件介绍

• Basic.ino: 展示了如何使用 PageBuilder 库创建一个基本的 Web 页面。
• Advanced.ino: 展示了如何使用 PageBuilder 库创建一个高级的 Web 页面。

3. 项目的配置文件介绍

PageBuilder 项目没有显式的配置文件，所有的配置都在代码中完成。例如，在 Basic.ino 和 Advanced.ino 中，配置了 WiFi 连接信息和 Web 服务器的端口。

配置示例

WiFi.begin("your-ssid", "your-password");
ESP8266WebServer server(80);

配置介绍

• WiFi 配置: 配置 WiFi 的 SSID 和密码。
• Web 服务器配置: 配置 Web 服务器的端口（默认为 80）。

通过这些配置，可以连接到 WiFi 网络并启动 Web 服务器，从而提供基于 PageBuilder 的 Web 页面。

PageBuilderAn arduino library to create html string in the sketch for ESP8266/ESP32 WebServer.项目地址:https://gitcode.com/gh_mirrors/pa/PageBuilder