Tips and Tricks

Get the most out of your Open Publishing Space!

Editing Open Publishing Space content on your desktop

You can use the GitHub Desktop application with either GitLab or GitHub to clone and edit your Open Publishing Space pages on your own computer:

Customizing your Open Publishing Space theme

The Open Publishing Space skeleton package comes with an Inherited Theme called 'mytheme' all ready for your further customization.

In addition, this theme is also automatically synced to the Git repository of your site. This means that you can invite other people, such as fellow educators or your students, to assist in the further customization of your site.

Only display page content (when embedding pages)

When displaying Open Publishing Space pages within another system (e.g. LMS) it is often helpful to only display page content and not include header navigation and the sidebar.

To do this, add chromeless:true to your page URLs. For example, to only display the content of the page at you would use the revised URL of

Making a homepage blog post 'sticky'

To make a blog post precede all other blog posts listed, add a featured tag to it's taxonomy field (located on the Options panel when editing a page in the Admin Panel). The frontmatter that is added to the page will look like this:

Hiding a post from the homepage post list

To hide a blog post from the homepage post list, but still make it available on other pages, add the following page frontmatter option:

hide_from_post_list: true
Override a page's automatically calculated Git Repository URL

To override the automatically calculated Git Repository URL on a page (i.e. to view a folder containing child pages), add the desired URL to the page frontmatter like this:

Built-in ShortCodes


This ShortCode embeds an iFrame.

[iframe url=""]
[iframe url="" aspectratio="4-3"]
[iframe url="" aspectratio="16-9"] (default)

PDF File

This ShortCode embeds an external PDF file.

Markdown File

This ShortCode embeds an external Markdown file.

[markdownfile url=""]

This ShortCode embeds an card Webpage preview.

[embedly url=""]

Example (image)

Google Slides

This ShortCode embeds a Google Slides deck.

<div class="grav-youtube"><iframe src="" frameborder="0" width="960" height="569" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe></div>

Example (image)


This ShortCode embeds an H5P content item.

When using the format the H5P Content Embed Source URL must be set in the Active Theme settings.

Example (image)

Notice an error? Think you can improve this documentation? Edit this Page