Framework X website

Source code for the Framework X website.

See https://github.com/clue/framework-x for more details about Framework X.

Contribute

You want to contribute to our Framework X website? You've come to the right place! This repository contains everything you need to help out with the texts and code examples found on the landing page of the website. Just locate the public/index.html and there you will find all contents.

ℹ️ This repository contains all files and build scripts required to generate the entire website. If you want to contribute to the Framework X documentation, take a look at clue/framework-x.

Build

You can build the website like this:

$ make

If you've pulled Framework X before and want to update its source code, you can pull an up-to-date version and rebuild the website like this:

$ make pull
$ make

Once built, you can manually browse the build/ directory or run the web server container (Apache) in the foreground like this:

$ make serve

Alternatively, you may also run the web server container (Apache) as a background daemon like this:

$ make served

Once running, you can run some integration tests that check correct paths etc. like this:

$ make test

Once done, you can clean up like this:

$ make clean

Deploy

Once built (see previous "Build" section), you can simply deploy the build/ directory behind Apache.

The live website is deployed by pushing the contents of the build/ directory to the live branch like this:

$ make deploy

Auto-Deployment

The website can be automatically deployed via the GitHub Pages feature.

Any time a commit is merged (such as when a PR is merged), GitHub actions will automatically build and deploy the website. This is done by running the above deployment script (see previous chapter).