Merge branch 'hotfix/3.0.23'

.gitignore

@@ -13,3 +13,5 @@
 /bin/phpunit
 /build/phabalicious.phar
 /docs/site
+node_modules
+docs/.vuepress/dist

Changelog.md

@@ -342,7 +342,7 @@ There's a lot of change going on here, but the structure of the fabfile.yaml is
 
 As fabric (the underlying lib we used for fabalicious) is quite different to symfony console apps there are more subtle changes. For example you can invoke only one task per run. With fabalicious it was easy to run multiple commands:
 
-```shell
+``` bash
 fab config:mbb docker:run reset ssh
 ```
 
@@ -459,4 +459,3 @@ Most notably the handling of arguments and options has changed a lot. Fabric gav
 * `sshCommand` is deprecated and got renamed to `shell:command` and will return the command to run a shell with the given configuration
 * the needs `drush7`, `drush8` and `drush9` are deprecated, use the need `drush` and the newly introduced options `drupalVersion` and `drushVersion` instead,
 * the `slack`-configuration got removed and got replaced by a general notification solution, currently only with a mattermost implementation.
-

deploy_docs.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env sh
+
+# abort on errors
+set -e
+
+# build
+yarn run docs:build
+
+# navigate into the build output directory
+cd docs/.vuepress/dist
+
+# if you are deploying to a custom domain
+# echo 'www.example.com' > CNAME
+
+git init
+git add -A
+git commit -m 'deploy'
+
+# if you are deploying to https://<USERNAME>.github.io
+# git push -f [email protected]:<USERNAME>/<USERNAME>.github.io.git master
+
+# if you are deploying to https://<USERNAME>.github.io/<REPO>
+git push -f [email protected]:factorial-io/phabalicious.git master:gh-pages
+
+cd -

docs/.vuepress/config.js

@@ -0,0 +1,27 @@
+module.exports = {
+  base: "/phabalicious/",
+  title: "Phabalicious",
+  description: "A deployment system and general purpose helper",
+  theme: require.resolve("@factorial/vuepress-theme"),
+  themeConfig: {
+    repo: "factorial-io/phabalicious",
+    editLinks: true,
+    editLinkText: "Help us improve this page!",
+    docsDir: "docs",
+    sidebar: [
+      "/guide.html",
+      "/installation.html",
+      "/usage.html",
+      "/available-tasks.html",
+      "/configuration.html",
+      "/docker-integration.html",
+      "/local-overrides.html",
+      "/scripts.html",
+      "/app-scaffold.html",
+      "/app-create-destroy.html",
+      "/passwords.html",
+      "/contribute.html",
+      "/Changelog.html"
+    ]
+  }
+};

docs/Changelog.md

@@ -0,0 +1 @@
+../Changelog.md

docs/README.md

@@ -0,0 +1,16 @@
+---
+home: true
+heroImage: http://logo.factorial.io/color.svg
+heroText: "Phabalicious"
+tagline: A deployment system and general purpose helper.
+actionText: Get Started →
+actionLink: /guide/
+features:
+  - title: Every-day tasks
+    details: Reset, backup or deploy your application, copy data from one instance to another.
+  - title: Docker integration
+    details: Administer your docker based stack, local or remote.
+  - title: Scaffolding
+    details: Scaffold new projects, create or destroy projects e.g with your CI.
+footer: A Factorial Open Source Project
+---

docs/docs/app-create-destroy.md → docs/app-create-destroy.md

@@ -35,7 +35,7 @@ appStages:
 
 Run the phab-command as usual. If you want to copy from an existing installation, add the `--copy-from`-option.
 
-```shell
+``` bash
 phab --config=<your-config> app:create
 ```
 
@@ -45,7 +45,7 @@ If the app is not created yet, all `create`-stages will be executed. If nothing
 
 ## Destroying an app
 
-```shell
+``` bash
 phab --config=<your-config> app:destroy
 ```
 
@@ -57,7 +57,7 @@ Both commands work best when using blueprints. This will allow to create a confi
 
 Some examples:
 
-```shell
+``` bash
 phab --config=some-config --blueprint=feature/<some-feature> create:app
 ```