# hiccup-plus

**Repository Path**: sevenclear/hiccup-plus

## Basic Information

- **Project Name**: hiccup-plus
- **Description**: HiccupPlus 是一个基于 Clojure 语言的 Hiccup 库扩展项目，旨在通过增强 Hiccup 的功能，为开发者提供更加灵活和强大的网页构建能力。
- **Primary Language**: Clojure
- **License**: EPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-26
- **Last Updated**: 2024-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hiccup-plus
### 开源项目介绍：hiccup-plus

#### 项目名称：hiccup-plus

hiccup-plus 是一个基于 Clojure 语言的 Hiccup 库扩展项目，旨在通过增强 Hiccup 的功能，为开发者提供更加灵活和强大的网页构建能力。Hiccup 本身是一个用于生成 HTML 的 Clojure 库，它通过 Clojure 的列表和符号来表示 HTML 元素和属性，极大地简化了 HTML 模板的编写。hiccup-plus 在此基础上，引入了自定义标签和样式的支持，并集成了 Bootstrap 组件的 DSL（领域特定语言），使得开发者能够更加方便地构建响应式和美观的网页界面。

## 主要特性

#### 主要特性：

1. **自定义标签支持**：
    - 允许开发者定义自己的 HTML 标签，这些标签可以封装复杂的 HTML 结构或逻辑，提高代码复用性和可维护性。
    - 通过宏（Macro）或高阶函数实现自定义标签的创建，使其能够接收参数并动态生成 HTML。

2. **样式扩展**：
    - 支持在 Hiccup 模板中直接嵌入 CSS 样式，无论是内联样式还是引用外部样式表。
    - 提供方便的函数或宏来生成带样式的 HTML 元素，如 `styled-div`、`styled-button` 等，减少重复代码。

3. **Bootstrap 组件 DSL**：
    - 集成 Bootstrap 框架的常用组件（如按钮、导航栏、模态框等）的 DSL，使得开发者可以通过简单的函数调用或宏调用来生成复杂的 Bootstrap 组件。
    - DSL 设计简洁直观，支持参数化配置，让开发者能够轻松定制组件的样式和行为。

4. **灵活的配置选项**：
    - 允许开发者根据项目需求选择性地启用或禁用自定义标签、样式扩展和 Bootstrap 组件 DSL。
    - 提供配置文件或 API 调用方式，以便开发者在项目启动时进行配置。

5. **文档和示例**：
    - 提供详尽的文档，包括 API 参考、使用指南和最佳实践。
    - 包含丰富的示例代码，展示如何使用 hiccup-plus 构建各种网页界面，帮助开发者快速上手。

#### 使用场景：
- **Web 应用开发**：对于需要快速构建响应式和美观的 Web 应用界面的开发者来说，hiccup-plus 是一个理想的选择。
- **前端模板引擎替代**：对于那些寻求更灵活、更强大且能与 Clojure 生态无缝集成的前端模板引擎的开发者来说，hiccup-plus 是一个很好的替代方案。
- **教育和学习**：hiccup-plus 的简洁性和扩展性使其成为学习 Clojure Web 开发的一个好工具，特别是对于那些希望深入了解 HTML 生成和前端框架集成的开发者。

#### 使用例子

```clojure 
(comp/modal
  (comp/modal-dialog 
    (comp/modal-content 
      (comp/modal-header 
        (comp/modal-title "modal title")
        (comp/modal-close-button)
        )
      (comp/modal-body 
        [:p "modal body text goes here."])
      (comp/modal-footer
        (comp/modal-close-button "Close")
        (comp/button-primary "save Changes"))
      ))
  )
```


#### 贡献指南：
- 我们欢迎任何形式的贡献，包括代码提交、文档改进、问题报告和特性建议。
- 请遵循项目的代码风格和贡献流程，确保提交的代码符合质量标准。
- 详细的贡献指南可以在项目的 GitHub 仓库中找到。

#### 联系方式：
- gitee 仓库：[https://gitee.com/sevenclear/hiccup-style-extend](https://gitee.com/sevenclear/hiccup-style-extend)（请替换 `your-username` 为实际的项目所有者用户名）
- 问题追踪：gitee Issues

#### 结语：
hiccup-plus 是一个旨在提升 Clojure Web 开发效率的开源项目，我们期待与广大开发者一起，共同推动这个项目的发展和完善。如果你对 hiccup-plus 感兴趣，欢迎加入我们的行列，一起为构建更好的 Web 应用而努力！

## License

Copyright © 2024 FIXME

This program and the accompanying materials are made available under the
terms of the Eclipse Public License 2.0 which is available at
http://www.eclipse.org/legal/epl-2.0.

This Source Code may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the Eclipse
Public License, v. 2.0 are satisfied: GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or (at your
option) any later version, with the GNU Classpath Exception which is available
at https://www.gnu.org/software/classpath/license.html.