diff --git a/docs/configuration.rst b/docs/configuration.rst
index 65e48a5..70f08a6 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -208,7 +208,7 @@ Adding custom themes
Comprehensive theming is enabled by default, but only the default theme is compiled. To compile your own theme, add it to the ``env/build/openedx/themes/`` folder::
- git clone https://github.com/me/myopenedxtheme.git $(tutor config printroot)/env/build/openedx/themes/
+ git clone https://github.com/me/myopenedxtheme.git "$(tutor config printroot)/env/build/openedx/themes/"
The ``themes`` folder should have the following structure::
@@ -232,7 +232,7 @@ Installing extra xblocks and requirements
Would you like to include custom xblocks, or extra requirements to your Open edX platform? Additional requirements can be added to the ``env/build/openedx/requirements/private.txt`` file. For instance, to include the `polling xblock from Opencraft `_::
- echo "git+https://github.com/open-craft/xblock-poll.git" >> $(tutor config printroot)/env/build/openedx/requirements/private.txt
+ echo "git+https://github.com/open-craft/xblock-poll.git" >> "$(tutor config printroot)/env/build/openedx/requirements/private.txt"
Then, the ``openedx`` docker image must be rebuilt::
@@ -240,11 +240,11 @@ Then, the ``openedx`` docker image must be rebuilt::
To install xblocks from a private repository that requires authentication, you must first clone the repository inside the ``openedx/requirements`` folder on the host::
- git clone git@github.com:me/myprivaterepo.git ./openedx/requirements/myprivaterepo
+ git clone git@github.com:me/myprivaterepo.git "$(tutor config printroot)/env/build/openedx/requirements/myprivaterepo"
Then, declare your extra requirements with the ``-e`` flag in ``openedx/requirements/private.txt``::
- echo "-e ./myprivaterepo" >> $(tutor config printroot)/env/build/openedx/requirements/private.txt
+ echo "-e ./myprivaterepo" >> "$(tutor config printroot)/env/build/openedx/requirements/private.txt"
.. _edx_platform_fork:
diff --git a/docs/dev.rst b/docs/dev.rst
index 11f8fa6..31fa3d9 100644
--- a/docs/dev.rst
+++ b/docs/dev.rst
@@ -80,7 +80,7 @@ Customised themes
With Tutor, it's pretty easy to develop your own themes. Start by placing your files inside the ``env/build/openedx/themes`` directory. For instance, you could start from the ``edx.org`` theme present inside the ``edx-platform`` repository::
- cp -r /path/to/edx-platform/themes/edx.org $(tutor config printroot)/env/build/openedx/themes/
+ cp -r /path/to/edx-platform/themes/edx.org "$(tutor config printroot)/env/build/openedx/themes/"
Then, run a local webserver::
diff --git a/docs/local.rst b/docs/local.rst
index c038213..b978865 100644
--- a/docs/local.rst
+++ b/docs/local.rst
@@ -133,14 +133,14 @@ In this example, the nginx container ports would be mapped to 81 and 444, instea
For nginx::
- sudo ln -s $(tutor config printroot)/env/local/proxy/nginx/openedx.conf /etc/nginx/sites-enabled/
+ sudo ln -s "$(tutor config printroot)/env/local/proxy/nginx/openedx.conf" /etc/nginx/sites-enabled/
sudo systemctl reload nginx
For apache::
sudo a2enmod proxy
sudo a2enmod proxy_http
- sudo ln -s $(tutor config printroot)/env/local/proxy/apache2/openedx.conf /etc/apache2/sites-enabled/
+ sudo ln -s "$(tutor config printroot)/env/local/proxy/apache2/openedx.conf" /etc/apache2/sites-enabled/
sudo systemctl reload apache2
If you have configured your platform to use SSL/TLS certificates for HTTPS access, the generation and renewal of certificates will not be managed by Tutor: you are supposed to take care of it yourself. Suggestions for generating and renewing these certificates with `Let's Encrypt `_ are given by::
@@ -166,14 +166,14 @@ As an example, here is how to launch two different platforms, with nginx running
export TUTOR_ROOT=~/openedx/site1
tutor config save --set WEB_PROXY=true --set LOCAL_PROJECT_NAME=tutor_site1 --set NGINX_HTTP_PORT=81 --set NGINX_HTTPS_PORT=481
tutor local quickstart
- sudo ln -s $(tutor config printroot)/env/local/proxy/nginx/openedx.conf /etc/nginx/sites-enabled/site1.conf
+ sudo ln -s "$(tutor config printroot)/env/local/proxy/nginx/openedx.conf" /etc/nginx/sites-enabled/site1.conf
# platform 2
export TUTOR_ROOT=~/openedx/site2
tutor config save --set WEB_PROXY=true --set LOCAL_PROJECT_NAME=tutor_site2 --set NGINX_HTTP_PORT=82 --set NGINX_HTTPS_PORT=482
tutor local quickstart
- sudo ln -s $(tutor config printroot)/env/local/proxy/nginx/openedx.conf /etc/nginx/sites-enabled/site2.conf
+ sudo ln -s "$(tutor config printroot)/env/local/proxy/nginx/openedx.conf" /etc/nginx/sites-enabled/site2.conf
You should then have two different platforms, completely isolated from one another, running on the same server.
@@ -196,8 +196,8 @@ Versions 1 and 2 of Tutor were organized differently: they relied on many differ
Then, create the Tutor project root and move your data::
- mkdir -p $(tutor config printroot)
- mv config.json data/ $(tutor config printroot)
+ mkdir -p "$(tutor config printroot)"
+ mv config.json data/ "$(tutor config printroot)"
`Download `_ the latest stable release of Tutor, uncompress the file and place the ``tutor`` executable in your path.
@@ -217,7 +217,7 @@ With Tutor, all data are stored in a single folder. This means that it's extreme
3. Transfer the configuration, environment and platform data from server 1 to server 2::
- rsync -avr "$(tutor config printroot)"/ username@server2:/tmp/tutor/
+ rsync -avr "$(tutor config printroot)/" username@server2:/tmp/tutor/
4. On server 2, move the data to the right location::