Skip to content

Home

Introduction

Development

IDEs

Services

API Explorer

Releases

Release notes

Martini Runtime

Martini Desktop

Martini Online

Feature requests

Bug reports

Running a Gloop template

While writing your Gloop template, you will want quick feedback on how it actually looks like in a web browser when rendered. To do this, you can "run" your Gloop template.

A running Gloop template will be temporarily exposed by the server to a randomly generated URL. This URL is where you can view the rendered web page. It is accessible until you decide to terminate the running Gloop template. To make things even more convenient, editing a running template automatically makes the browser reload the rendered web page.

There are many ways you can run a Gloop template:

  • using the context menu from the Navigator;
  • using the context menu from the step editor;
  • using toolbar in the step editor; and
  • using the shortcut key in Martini Desktop; in Martini Online.

Running a template using the Navigator context menu

Running a template using the Navigator context menu

Running a template using the step editor

Running a template using the step editor

Setting template inputs

When you run a Gloop template, an input dialog will appear. This input dialog allows you to set the template's input properties. Inputs are typically used in order to configure how a Gloop template will behave, and be rendered as a web page.

Inputs can be set under the Main tab, using the Input Model section. To set a property's value, select it and either click on its value cell, or press . Provide the property's value when the text field appears, and press to apply your edit.

If you already have input data written in JSON, XML or YAML format, you can easily feed this data to the input dialog using the Import button. If your input data is partial, you can select a property in the tree and set its value by pasting the JSON, XML, or YAML content from your clipboard.

Martini Desktop also allows you to set where the Gloop template will be opened upon running. You can choose to open it in Martini Desktop's internal browser (default option), or an external browser (which is your machine's configured default browser).

Input dialog for Gloop templates

Input dialog for Gloop templates

Using CSS

In some cases, you might want to run your template with a particular CSS for testing purposes. A common scenario would be when running a component template1 which does not have a <head> tag containing the necessary CSS imports. To provide a CSS for testing purposes, you can go to the input dialog's CSS tab to configure the CSS you want to use for your template when it runs.

You can set the CSS either by pasting CSS rules from your clipboard, or the CSS's source URL. The URL can either be an absolute URL, or a relative path to to the Martini package's web directory. For example, if your CSS file is at todo-app/web/bootstrap.min.css (where todo-app is the name of the Martini package); then your relative path should be /todo-app/bootstrap.min.css. The web directory is excluded in the path.

When run, the configured CSS and/or CSS imports will be injected to your Gloop template's <head> tag.

Configuring a Gloop template's CSS

Configuring a Gloop template's CSS

Using scripts

Similar to injecting CSS, it can be helpful to include extra scripts in your template for testing purposes. This is done through the Scripts tab of the input dialog.

Your JavaScript can be provided by pasting code from your clipboard, or the JavaScript's source URL. The URL can either be an absolute URL, or a relative path to to the Martini package's web directory. For example, if your JS file is at examples/web/script.js (where examples is the name of the Martini package); then your relative path should be examples/script.js. The web directory is excluded in the path.

Configuring a Gloop template's script

Configuring a Gloop template's script

Viewing the rendered web page

When you run a Gloop template, Martini will show a preview of the rendered web page (unless you unchecked the Open in Browser checkbox). This preview automatically reloads when you save the template after applying your changes.

You can open an accidentally closed template preview using the following procedure:

Reopning a closed template preview

Reopning a closed template preview

  1. Switch to the Debug perspective.
  2. Go the the Debug view.
  3. Right click the running Gloop template.
  4. Click either Open Gloop Template Preview, or Show Gloop Template Preview QR Code. The latter prompts a dialog with a QR code to open. This QR code can be scanned by a mobile device so you could view the rendered web page from there.

  1. A template containing only a part of a web page; to be invoked and reused in other templates.