Paligo Theme Studio settings and troubleshooting
Settings
Theme Studio's settings are in VS Code's Settings, under Paligo Theme Studio.
Setting | What it does |
|---|---|
Instance Url | Your Paligo instance. Signing in sets it. |
Username | Your Paligo username. Signing in sets it. Set it for one workspace to work as another user there. |
Allowed Origins | Addresses the previewed theme may load scripts, styles, images and fonts from, such as a CDN. Empty by default. |
Preview Debounce Ms | How long to wait after you save before rendering again, in milliseconds. The default is 250. |
Ca Cert Path | A certificate to trust for an instance with a self-signed certificate. Leave it empty for any other instance. |
Note
The preview blocks scripts, styles and fonts from other websites, so a theme that loads them from a CDN looks different in the preview. Add the CDN's address, such as https://cdn.jsdelivr.net, to Allowed Origins to allow it. Only add addresses you trust: their code runs in the preview.
When something goes wrong
Problem | What to do |
|---|---|
The Paligo commands do nothing, or No theme.json found | Open the folder that has |
Sign in to Paligo first. | Run Paligo: Sign in to instance…. |
Paligo rejected … with that key | The API key must belong to the username you entered. Sign in again with the right pair. |
No publications are available to preview against. | Your user can't see any publications on the instance. |
This instance has no themed layouts to push to. | Create a theme layout first. See Create a theme layout. |
The preview takes a long time the first time | Paligo is building the publication's content. This happens once per publication. |
The preview shows an error | The error names the template and the line. Correct it and save. |
For more detail, open the Output panel and choose Paligo. It logs each render and anything that went wrong. To see more, select the gear icon and set the level to Debug.