BookStack Code Mirror - system-cli/blob - readme.md

   1 # BookStack System CLI
   2
   3 A simple command line interface for managing instances of BookStack. Provides the following commands:
   4
   5 - **Init** - Setup a fresh BookStack installation within a folder.
   6 - **Backup** - Creates a backup of an existing BookStack installation to a single ZIP file.
   7 - **Restore** - Restore a backup ZIP into an instance of BookStack.
   8 - **Update** - Update an existing BookStack installation to the latest version.
   9
  10 This CLI is intended to be platform abstract, intended for plain installs that follow our scripts/manual instructions.
  11 This is intended to work independently from BookStack itself, so it can be used even if a BookStack instance is not available or broken, although it could be distributed with and called upon by the core BookStack codebase.
  12
  13 ### Development
  14
  15 This project uses composer to manage PHP dependencies. They can be installed as follows:
  16
  17 ```bash
  18 composer install
  19 ```
  20
  21 This project is intended to be bundled up into a single [phar file](https://www.php.net/manual/en/intro.phar.php) for portability and separation with BookStack itself.
  22 This can be done by running the compile file:
  23
  24 ```bash
  25 php compile.php
  26 ```
  27
  28 ### Contributing
  29
  30 I welcome issues and PRs but keep in mind that I'd like to keep the feature-set narrow to limit support/maintenance burden.
  31 Therefore I likely won't leave issues open long, or merge PRs, for requests to add new features or for changes that increase the scope of what this script already supports.