Publishing and Status

The Publishing under siteConfig allows the user to view the publishing status, perform a bulk publish and to publish commits from sandbox repository by commit id.

Status

The Status tab allows the user to view the publishing status, such as the following:

  • Last successful publish was for item: {item_path} on {date}
  • Currently publishing item: {item_path} on {date}
  • Stopped while trying to publish item: {item_path} on {date}
  • User {username} stopped the site on {date}

It also allows the user to Start or Stop Studio publishing

Site Config Publishing - Status :align: center

Bulk Publishing

The Bulk Publishing tab allows the user to publish multiple items under the specified path. For example, using the Website Editorial blueprint, to publish all the articles in the year 2017, in the Path to Publish field, enter /site/website/articles/2017. To publish everything in your site, the user will enter / in the Path to Publish field

Site Config Publishing - Bulk Publishing :align: center

Publish by Commit ID(s)

Crafter Studio also allows the user to publish commits from sandbox repository by commit id.

Site Config Publishing - Publish by Commit ID(s) :align: center

To publish by commit id, let’s use a site created using the Website Editorial blueprint and follow the steps below:

  • Edit the Home page (/site/website/index.xm) from the command line or anywhere other than Studio

  • From the command line, commit your changes

    $ cd crafter-authoring/data/repos/sites/mysite/sandbox/site/website
    $ git add .
    $ git commit
    
  • Get the commit id after doing the above step

    $ git log
    commit f47c9a5bae4184e7b5ff2cb03b90b8ff86adec37 (HEAD -> master)
    Author: myuser <myuser@example.com>
    Date:   Fri Mar 15 10:09:57 2019 -0400
    
        edited home page outside of studio
    
    commit 1121d1b90d7b3131025932b6a0f0269d918caa11
    Author: admin admin <evaladmin@example.com>
    Date:   Fri Mar 15 09:31:57 2019 -0400
    

    The commit id we want to publish by commit id is f47c9a5bae4184e7b5ff2cb03b90b8ff86adec37

  • Go back to Studio and click on siteConfig -> Publishing

  • Click on the Publish by Commit ID(s) tab

  • Paste the commit id from the step where we got the commit id, then click on the Publish button