Logo Docs
Logo Docs

Using the sandbox

With its instantaneous feedback, the sandbox is an important tool to learn to use DocuMold and to test commands.

The sandbox doesn’t allow you to use formatting like Word does, but to learn to use DocuMold, formatting isn’t needed.

Many tutorials and guides will use the sandbox to make it easier to see the results, so let’s get familiar with it.

1. Go to the sandbox’s page

  1. Login on https://documold.com
  2. Click on “Sandbox” in the menu on the left
  3. Click on “Reset” at the top so that you start with the content that this tutorial expects

2. Add text

Type some text on a new line in the left box. For example:

This is some more text.

The left box now should contain something like:

Hello <# client_name #>! This is an example.
This is some more text.

Notice how the right box’s content has changed to reflect what was added in the left one.

3. Edit the client_name variable

As seen in the previous tutorial, <# client_name #> inserts the content of a variable in its place. So on the right, you should see Anna Logwatch instead of <# client_name #>.

You can change the variable’s value below the left box. There should be a small round box with client_name and a small text field. Change the small text field’s value to Best client.

The change will be copied to the right box automatically. The right box should now contain:

Hello Best client! This is an example.
This is some more text.

4. Add a variable

The sandbox automatically detects when you use variables in the left box. Let’s try it.

Add a new line: Your country is <# client_country #>.

Once done, you should notice at the bottom left that a new round box appeared for that variable. Its initial value will be (client_country), which you can already see in the right box.

You can set its value (Ex: “Canada”) at the bottom left and see that it gets updated in the right box too.

Conclusion

With its fast feedback, the sandbox should be the first place you go when you want to test a command or a function. Speaking of which, the next tutorial introduces functions: Using functions.