timmmmyboy / HAXcms

HAX with a lightweight CMS backend to manage your microsite universe

Home Page:https://haxtheweb.org/haxcms-1

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

HAXcms

Get all the details you want on HAXTheWeb.org! HAXcms seeks to be the smallest possible back-end CMS to make HAX work and be able to build websites with it. Leveraging JSON Outline Schema, HAX is able to author multiple pages, which it then writes onto the file system. This way a slim server layer is just for basic authentication, knowing how to save files, and placing them in version control.

Features

  • All of HAX without a bloated CMS
  • Incredibly simple, readable file structure of flat HTML files and lightning fast, high scale micro-sites
  • cdn friendly configuration
  • 0 config, 100% offline capable, PWA generation
  • clean, simple theme layer abstracted from content
  • No database (simple .json files help manage the data)
  • Files you can reach out and touch, fork, and theme with ease!
  • Support for multiple sites
  • automatic git repo creation and management (never touch commandline again, but dive in if you really needed)
  • Built in gh-pages publishing

Requirements (PHP)

  • Supports PHP 7.1+
  • Requires zip, gd, and xml modules be installed
  • Apache 2.4

Installation Guide

MAMP

Contaaaiiinnnneeerrrrs

  • Clone this repo: git clone https://github.com/elmsln/haxcms.git
  • Install a server container (recomnended). Here are some options (We support 'em all!):
  • Open a terminal window, go to the directory where you downloaded your container app and type ddev start (for ddev) or fin init (for docksal) or lando start && lando magic (for lando) or vagrant up (for vagrant).
  • Go to the link any of them give you in a browser.
  • Username/password is admin/admin to get building out static sites locally that you can push up anywhere!
  • Click the icon in the top-right and you're off and running!

Scope

Generate .html files which have only "content" in them. Meaning the contents of the page in question. A simple method of adding new pages and managing the organization of those pages into a simple hierarchy (outline). Support for multiple mini web sites so that you can write a lot about different topics. HAXcms is only intended to be a micro-site generator and play nicely with the rest of the HAX ecosystem without needing a monster CMS in order to utilize it.

Usage

Go to yoursite.com and login with the username and password you entered in the _config/config.php by clicking on the login icon

HAXiam deployment

HAXiam (HAX, I am) is a SaaS configuration for HAXcms. It allows for the replication of HAXcms per user account for enterprise deployments. It's able to better interface with enterprise login systems while maintaining a clean copy of HAXcms.

HAXcms does not require HAXiam to operate but it is an alternate configuration that we support. Therefore if you see anything in the docs or under the hood referencing how to change settings when in that type of environment, you know why.

License

Apache 2.0

About

HAX with a lightweight CMS backend to manage your microsite universe

https://haxtheweb.org/haxcms-1

License:Apache License 2.0


Languages

Language:PHP 72.3%Language:HTML 16.3%Language:JavaScript 7.5%Language:Shell 3.5%Language:Dockerfile 0.2%Language:CSS 0.1%