-description: "Sets up the files for a new multisite install."
-help: "The <info>multisite:new</info> command assists in setting up new multisite installs by creating the needed subdirectory and files, and can optionally copy an existing 'default' installation."
+description: 'Sets up the files for a new multisite install.'
+help: 'The <info>multisite:new</info> command assists in setting up new multisite installs by creating the needed subdirectory and files, and can optionally copy an existing ''default'' installation.'
arguments:
- directory: "Name of directory under 'sites' which should be created."
- uri: "Site URI to add to sites.php."
+ directory: 'Name of directory under ''sites'' which should be created.'
+ uri: 'Site URI to add to sites.php.'
options:
- copy-default: "Copies existing site from the default install."
+ copy-default: 'Copies existing site from the default install.'
errors:
- subdir-empty: "You must specify a multisite subdirectory to create."
- subdir-exists: 'The "sites/%s" directory already exists.'
- default-missing: "The sites/default directory is missing."
- mkdir-fail: 'Unable to create "sites/%s". Please check the sites directory permissions and try again.'
- sites-invalid: "The sites.php file located is either not readable or not a file."
- sites-missing: "No sites.php or example.sites.php to copy from."
- sites-other: "A problem was encountered when attempting to write sites.php"
- file-missing: 'The file "%s" was not found for copying.'
- copy-fail: 'Unable to copy "%s" to "%s". Please check permissions and try again.'
- write-fail: 'Unable to write to the file "%s". Please check the file permissions and try again.'
- chmod-fail: 'Unable to change permissions on the file "%s". Please ensure that the permissions on that file are correct.'
+ subdir-empty: 'You must specify a multisite subdirectory to create.'
+ subdir-exists: 'The "sites/%s" directory already exists.'
+ default-missing: 'The sites/default directory is missing.'
+ mkdir-fail: 'Unable to create "sites/%s". Please check the sites directory permissions and try again.'
+ sites-invalid: 'The sites.php file located is either not readable or not a file.'
+ sites-missing: 'No sites.php or example.sites.php to copy from.'
+ sites-other: 'A problem was encountered when attempting to write sites.php'
+ file-missing: 'The file "%s" was not found for copying.'
+ copy-fail: 'Unable to copy "%s" to "%s". Please check permissions and try again.'
+ write-fail: 'Unable to write to the file "%s". Please check the file permissions and try again.'
+ chmod-fail: 'Unable to change permissions on the file "%s". Please ensure that the permissions on that file are correct.'
warnings:
- missing-files: "No sites/default/files directory found. The files directory will need to be created by hand."
+ missing-files: 'No sites/default/files directory found. The files directory will need to be created by hand.'
messages:
- copy-default: 'The default install was successfully copied to "sites/%s".'
- fresh-site: 'The new multisite structure was successfully created at "sites/%s" and is ready for installation.'
+ copy-default: 'The default install was successfully copied to "sites/%s".'
+ fresh-site: 'The new multisite structure was successfully created at "sites/%s" and is ready for installation.'
+examples:
+ - description: 'Set up files for a multisite install specifying destination path and uri'
+ execution: |
+ drupal multisite:new vendor/newsite http://mysite.example.com