Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


For our purposes here, there is little difference between creating pages or updating existing pages, so we favor terminology of update and storePage in what follows.

For publishPage actions, the content can come from a source page or from content provided by the file or content parameters. Most of our internal use is from a file coming from a repository so that we have change control.

When rendering content on the source system from non-page sources like a file, we use the space (and title parameter if provided) to determine the source rendering context. If title is not provided, the space's home page is used.

Use Cases

Table plus

Use CaseDiscussionActionExamples
Update a page from wiki textSimple case. Wiki text is an easy format for simple automation scripts to produce.storePage

No Format
-a storePage --space XXX --title "My page" --content "h1. Example"

No Format
-a storePage --space XXX --title "My page" --file

Update a page from storage formatSimple case. In some cases, more complex storage format may be needed.storePage

No Format
-a storePage --space XXX --title "My page" --file my.stg

Copy a page from one system to anotherThis is also relatively common use case and simply copies the storage format from the source page to the target system page. Defaults to the same space and title, but there are parameters making it more flexible.copyPage

No Format
-a copyPage --space XXX --title "My page" --newSpace YYY --targetServer ...

Render storage format content on one system and publish the resulting page on another system

This is a scenario that takes advantage of more advanced Confluence rendering capabilities on one system that may not be available on the target system. Examples are the availability of macros and potential security restrictions on the target platform. A specific example is publishing SQL tables to Confluence Cloud using the SQL on a source system. This site contains a number pages created in this way.

This works only for some wiki content that renders to a HTML that can be easily converted to XHTML storage format required to represent page source on the target system.


No Format
-a publishPage --space XXX --title "My page" --newSpace YYY --noConvert --targetServer ...

Render wiki content on one system and publish the resulting page on another systemSame as the above except the wiki content must first be converted to storage format. The difference is the noConvert parameter that determines whether the content is wiki or storage (need noConvert parameter)publishPage

No Format
-a publishPage --space XXX --title "My page" --newSpace YYY --targetServer ...

From wiki content, provide a way to identify content blocks that represent content that needs to be rendered on the source server and included in the page source for a target page.For instance identifying a SQL macro within the page source that needs to be rendered on the source system before producing the target page.publishPage

No Format
-a publishPage --space XXX --title "My page" --newSpace YYY --targetServer ... --options searchContent