Synopsis
This article illustrates the usage of our utility scripts on Unix-equivalent systems.
Migrate a Local Lightweight CMS Repository to a New Site
Invoke the following command:
$ ./tools/bin/migrate
The utility script will create site configuration files and posts directory.
Run Lightweight CMS Sites Locally without Apache or Nginx
Traditionally, PHP programmers install either Apache or Nginx to run PHP scripts locally. Nonetheless, it is not easy for beginners to write correct configurations for those web servers. With our utility script, you don't need to set up a local web server to run PHP scripts.
Invoke this command to run a Lightweight CMS site locally:
$ ./tools/bin/serve
By default, this development web server runs on http://localhost:5000. To run a web server on other location, add your location as a parameter:
$ ./tools/bin/serve localhost:3000
If you need promoted priviledge, run it with sudo(1):
$ sudo ./tools/bin/serve
Internally, this utility script runs a builtin web server of PHP. This feature is available after PHP 5.4 (ref).
Compile Static Lightweight CMS Sites
Invoke the following command:
$ ./tools/bin/compile
Deploy a Lightweight CMS Site to a PaaS
Run the command to prepare your deployment:
$ ./tools/bin/publish
We implement this script in POSIX shell because most PaaS are based on GNU/Linux. If you choose a Windows PaaS, run this script instead:
$ .\tools\bin\publish.bat
These utility scripts will copy router of Lightweight CMS and assets to public directory, ready for further step(s) to deploy your site.
See this article for information related to deploy a Lightweight CMS site to a PaaS.
Synchonize Content on a Production Environment
Invoke this command to update your change(s) on a production environment:
$ ./tools/bin/sync-to path/to/www
If you need promoted priviledge, run it with sudo(1):
$ sudo ./tools/bin/sync-to /path/to/www
Internally, this utility script runs rsync(1). Therefore, don't edit anything on your production environment.
Update Site Settings after Changing Project Structure
Invoke this command to update site settings each time you change project structure of your Lightweight CMS repo:
$ ./tools/bin/init
Site settings of Lightweight CMS is recorded in PHP scripts, which are unusable in other scripting languages. To address this issue, we generate a usable settings for POSIX shell.