New and Noteworthy
The following changes may be the most interesting of this release.
If you ever thought of extending a document without touching it, the delegate document feature is for you! If you have a document for a person and you want to add additional information to that document in another space you now simply create that new document and delegate to the existing one. Each section of your new document will now render the section of the delegate document as long as it is empty.
HTML Metadata for SEO
The properties of a document can be exported as metadata on an HTML page easily. This metadata such as
DC.description is used by web crawlers or search engines to enhance user experience or the search rank ratings.
Support for Glossaries
This version adds new macros to make working with glossaries and other indices easier.
Title encodings work around the problem that the title of a Confluence page has to be unique within a space. The encodings are defined by the template author and should be activated by default.
This version introduces the encodings for the following types:
Categories allow to set document instance of different doctypes in a hierarchy.
Document the semantics of a tag. May also be used to document Confluence labels.
A party that takes interest in a project. The stakeholder is either a real person, an organization or group, or represents a class of individuals, groups or organizations.
Subject documents allow to set document instance of different doctypes in a common context.
A space may have defined a list of spaces as its search space. Search macros use the search space to collect documents for the result set. The @all is a special token to search in all spaces. From this version on we also allow to exclude spaces from the search.
Authors may also use space labels to include or exclude a set of spaces attached to this label. Use the '
#' to select spaces by a space label.
New Space Properties
The following space properties has been introduced with this version.
Required Document Properties
This is an interesting feature especially for template authors to design blueprint that hide document parts not relevant in a given context.
New Artificial Properties
Sorting by dates is now easier by using normalized date values to be used with Lucene searches. If the property value is specified with the Confluence Date Autocompletion (opened with the shortcut '
//'), and for the creation and last modification date, a normalized date is provided as an artificial property.
The name of this artificial property is that of the original property plus the
Here is an example where the creation date is check against a custom property named
There is also an artificial property value containing the date as a timestamp in milliseconds, prefixed with zeros up to 19 digits (
%019d). The name of the artificial property is constructed from the original name plus the suffix
Timestamp (separated by a blank). Note that the
Creation Timestamp is the creation date in milliseconds, while the
Creation Date Timestamp is the representation of the date (without hours, minutes, seconds) in milliseconds.
See Date Representation for details on provided artificial properties for the creation and last modification date.
The change may break sort orders for instance in the Display Table Macro where the use of
attempts to parse the date in the user's default format. With this version use
Creation Date§ instead.
Since the value may be overridden the index key is technically a special form of an artificial property.
New Property Controls
This version includes the following new property controls.
Signals that the property should be transcluded from the delegate document.
Exports the property as metadata.
Exports the property as schema information.
The property must not be seen outside the space. This is typically used for properties defined in the personal space that should not be used outside this space. Note that specifying this control will hide the property imported from delegate spaces.
HTML Span Macro
Render Children in Table
This version improves support of macros used on non-projectdoc documents. Previous versions typically assumed to calculate default values for non-projectdoc documents. With this release macros will distinguish between projectdoc documents and simple Confluence pages. This removes problems on updating pages that have been converted to projectdoc documents.
The following changes are incompatible with the previous release.
Remove projectdoc Label
Before 1.10 projectdoc relied on the '
projectdoc' label to mark pages that are projectdoc documents. With this version this visible tag is removed and replaced with a content property. The inner workings will then check the content property instead of the tag.
For migration we will always check the content property first and then the label to determine if a page is a projectdoc document. If the '
projectdoc' label is removed we will automatically add the content property.
This is a breaking change for those use cases that expect that projectdoc documents will have a '
projectdoc' label. For instance users who use the Content By Label Macro will not find new pages.
A side effect of this change is that pages with named doctypes, that is doctypes that are not based on a blueprint, will not have the name of the doctype as a label. This is - for instance - the case with docsections.
Users who do not use the '
projectdoc' label for their work will not notice the change. Users who do should be aware of the fact that this label is no longer added automatically.
Doctype Add-on Update
With the update to the projectdoc Toolbox 1.10 the doctype add-ons need also be updated. This is due to an API change that will break compatibility of older versions of the add-ons.
Therefore please update your doctype add-ons to the following versions:
The creation and modification time of a page provided by Confluence is accessible by artificial properties. With this Version the names are as follows:
|The date in a date picker representation.|
|The date (with day precision) with leading zeros in milliseconds.||0000001456441200000|
|The date as text.||26 Feb 2016|
|The normalized date with format ||20160226|
|The timestamp in milliseconds with leading zeros.||0000001456510125056|
The same representations are available for the last modification date:
Last Modification Date
Last Modification Date Timestamp
Last Modification Date$
Last Modification Date§
Last Modification Timestamp
Use the Display All Document Properties Macro to list all properties provided by a document.
A feature tagged as experimental is currently tested. Use cases are explored and changes to the user interface are likely. We intend to get feedback from users to forge the final version of the feature.
The Changelog Macro is added as an experimental feature. The macro renders changes with their comments in a table.
Changes are tricky to track when users apply transclusion. Therefore the macro is helpful in a number of use cases and confusing in others. We release it and marked it as #Experimental to learn more about how this macro can be improved.
This release has the following issues.
Content By Label Warnings
We use the Content By Label Macro on the homepages of spaces. We add a valid element that points to the space the macro include for its search. Due to changes to the macro, it is now migrating the information to CQL, setting the space as a string property. This will not break the macro, but the following message will be written to the Confluence log file:
If you need to remove this warning, just remove the Content By Label Macro from the space homepages generated by the free add-ons. Alternatively you may change the parameters of the macro to use the CQL, but this option depends on the version of your Confluence installation.
In cases where the storing and indexing of the page takes longer than the following view rendering process the content of the rendered page may not be up-to-date. This is especially an issue for homepages on space creation.
The user has to reload the page to see the updated content.
List of Changes
The complete list of changes for this release.
- Release Notes Archive