elmsln/haxcms

HAXcms

https://img.shields.io/badge/-HAXTheWeb-999999FF?style=flat&logo=data:image/svg%2bxml;base64,PHN2ZyBpZD0iZmVhMTExZTAtMjEwZC00Y2QwLWJhMWQtZGZmOTQyODc0Njg1IiBkYXRhLW5hbWU9IkxheWVyIDEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgdmlld0JveD0iMCAwIDE4NC40IDEzNS45NyI+PGRlZnM+PHN0eWxlPi5lMWJjMjAyNS0xODAwLTRkYzItODc4NS1jNDZlZDEwM2Y0OTJ7ZmlsbDojMjMxZjIwO308L3N0eWxlPjwvZGVmcz48cGF0aCBjbGFzcz0iZTFiYzIwMjUtMTgwMC00ZGMyLTg3ODUtYzQ2ZWQxMDNmNDkyIiBkPSJNNzguMDcsODMuNDVWNTVIODYuMnY4LjEzaDE2LjI2djQuMDdoNC4wN1Y4My40NUg5OC40VjY3LjE5SDg2LjJWODMuNDVaIi8+PHBvbHlnb24gcG9pbnRzPSIxNTMuMTMgNjMuNyAxNTMuMTMgNTEuMzkgMTQwLjU0IDUxLjM5IDE0MC41NCAzOS4wOSAxMjcuOTUgMzkuMDkgMTI3Ljk1IDI2Ljc5IDEwMi43OCAyNi43OSAxMDIuNzggMzkuMDkgMTE1LjM2IDM5LjA5IDExNS4zNiA1MS4zOSAxMjcuOTUgNTEuMzkgMTI3Ljk1IDYzLjcgMTQwLjU0IDYzLjcgMTQwLjU0IDc2IDEyNy4zNiA3NiAxMjcuMzYgODguMyAxMTQuNzggODguMyAxMTQuNzggMTAwLjYxIDEwMi4xOSAxMDAuNjEgMTAyLjE5IDExMi45MSAxMjcuMzYgMTEyLjkxIDEyNy4zNiAxMDAuNjEgMTM5Ljk1IDEwMC42MSAxMzkuOTUgODguMyAxNTIuNTQgODguMyAxNTIuNTQgNzYgMTY1LjcyIDc2IDE2NS43MiA2My43IDE1My4xMyA2My43Ii8+PHBvbHlnb24gcG9pbnRzPSIzMy4xMyA2My43IDMzLjEzIDUxLjM5IDQ1LjcyIDUxLjM5IDQ1LjcyIDM5LjA5IDU4LjMxIDM5LjA5IDU4LjMxIDI2Ljc5IDgzLjQ4IDI2Ljc5IDgzLjQ4IDM5LjA5IDcwLjg5IDM5LjA5IDcwLjg5IDUxLjM5IDU4LjMxIDUxLjM5IDU4LjMxIDYzLjcgNDUuNzIgNjMuNyA0NS43MiA3NiA1OC44OSA3NiA1OC44OSA4OC4zIDcxLjQ4IDg4LjMgNzEuNDggMTAwLjYxIDg0LjA3IDEwMC42MSA4NC4wNyAxMTIuOTEgNTguODkgMTEyLjkxIDU4Ljg5IDEwMC42MSA0Ni4zMSAxMDAuNjEgNDYuMzEgODguMyAzMy43MiA4OC4zIDMzLjcyIDc2IDIwLjU0IDc2IDIwLjU0IDYzLjcgMzMuMTMgNjMuNyIvPjwvc3ZnPg==]([***]

镜像概述和主要用途

HAXcms 是一款轻量级后端 CMS，旨在结合 HAX 的创作体验，快速构建静态文件支持的网站。它通过最小化后端实现 HAX 功能，利用 JSON Outline Schema 管理多页面内容并写入文件系统，仅需基础认证、文件保存和版本控制能力，适用于构建高效、可扩展的微网站。

核心功能和特性

• 集成 HAX 的完整用户体验，提供直观的内容创作界面
• 简洁可读的文件结构，基于扁平 HTML 文件，支持快速、高扩展的微网站
• CDN 友好配置，便于内容分发
• 零配置，100% 离线可用，支持 PWA 生成
• 与内容分离的清晰主题层，便于定制
• 无数据库设计，使用简单 .json 文件管理关系，页面内容为 HTML+Web 组件
• 可直接访问、 fork 和主题化的文件系统
• 支持多站点管理
• 自动 Git 仓库创建与管理（无需命令行操作，也支持手动介入）
• 内置 gh-pages 发布功能
• 支持 PHP 和 Express 后端

系统要求

PHP 环境

• 支持 PHP 7.1+
• 需安装 zip、gd 和 xml 模块
• Apache 2.4 服务器

Node 环境（开发中）

bash
cd system/backend/nodejs
yarn run dev

快速安装

bash
$ curl -fsSL https://raw.githubusercontent.com/elmsln/HAXcms/master/scripts/haxcmsme.sh -o haxcmsme.sh && sh haxcmsme.sh

详细安装指南

完整安装说明可参考 HAXTheWeb 安装文档，涵盖多种部署方式。

容器部署

1. 克隆仓库：git clone https://github.com/elmsln/haxcms.git
2. 安装服务器容器（推荐），支持以下选项：
   • https://store.docker.com/search?type=edition&offering=community
   • https://ddev.readthedocs.io/en/latest/#installation
   • docksal
   • lando
   • https://www.vagrantup.com/downloads.html
3. 打开终端，进入容器应用目录，执行对应启动命令：
   • ddev：ddev start
   • docksal：fin init
   • lando：lando start && lando magic
   • vagrant：vagrant up
4. 在浏览器中访问容器提供的链接
5. 使用默认用户名/密码 admin/admin 登录，开始构建本地静态网站
6. 点击右上角图标即可开始使用

MAMP 部署

1. 下载 MAMP
2. 下载仓库文件：https://github.com/elmsln/HAXcms/archive/master.zip
3. 将 HAXcms 文件放入 MAMP 的 htdocs 文件夹
4. 启动 MAMP 并点击 "My website"
5. 复制系统提供的密码，点击访问 HAX 即可开始使用

使用场景和适用范围

HAXcms 适用于生成仅包含“内容”的 .html 文件，支持添加新页面并将其组织为简单层级结构（大纲）。它支持多微网站管理，可针对不同主题创建大量内容。作为微网站生成器，HAXcms 旨在与 HAX 生态系统协同工作，无需复杂 CMS 即可实现高效内容管理。

使用方法

访问 yoursite.com，点击登录图标，使用 _config/config.php 中配置的用户名和密码登录，即可开始内容创作和网站管理。

HAXiam 部署

https://github.com/elmsln/HAXiam%EF%BC%88HAX, I am）是 HAXcms 的 SaaS 配置，支持企业级部署，可为每个用户账户复制 HAXcms 实例。它能更好地与企业登录系统集成，同时保持 HAXcms 的简洁性。HAXcms 不依赖 HAXiam 运行，但支持这种替代配置，相关文档中可能会提及该环境下的设置调整方法。

平台特定注意事项

Windows

Cygwin 命令行 已轻度测试，但速度慢于原生 Bash 环境。

Windows 安装配置

为正确设置 Git 换行符，需执行以下命令：

bash
$ git config --global core.autocrlf true

Fedora (31/32) 故障排除

新版 Fedora 使用 cgroupsv2，目前不被 Docker 支持。在本地运行 HAX 前（如执行 "ddev start" 或 "fin init" 前），需运行以下命令避免 cgroup 错误：

bash
sudo mkdir /sys/fs/cgroup/systemd
sudo mount -t cgroup -o none,name=systemd cgroup /sys/fs/cgroup/systemd

许可证

Apache 2.0