Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Document Properties Marker
overridefalse
Short DescriptionYou may want to provide information for specific audiences.
 

Doctypetopichide
NameInformation for Audiences
 

Parent
Parent Property
propertyParent
property-nameName
hide
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
propertyAudience
 

Level of Experience
Name List
doctypeexperience-level
render-no-hits-as-blanktrue
propertyLevel of Experience
 

Expected Duration
 
10 min
Subject
Name List
doctypesubject
propertySubject
 

Categories
Name List
doctypecategory
propertyCategories
 

Tags
Tag List
propertyTags
 

Iteration
Iteration
valuefinished
hide
Type
Name List
doctypetopic-type
render-no-hits-as-blanktrue
namesTip
propertyType
 

Sort Keyhide
Section
titleDescription

Section
show-titlefalse
titleSummary

If you create documents collaboratively, you may want to show some of the information on a page only to other team members who - for instance - have edit permissions for that page.

This is not about sensitive information! The content is hidden because it includes sections that need rework or show just an outline of what will get into. This information is intended for team members that work collaboratively on the documentation and is not useful for other audiences.

Another use case is to add additional information to a page that is again only relevant for a specific audience. Think of a list of documents that transclude content from a given page. This information may be very relevant for authors who apply changes to a document and want to lookup quickly all pages that reuse the changed content. This information is typically irrelevant for all other audiences. Therefore the list of references is only shown to page authors with edit privileges.

If you need to show some content on a page only for a specific audience, the hide macros may be very convenient: Hide From Anonymous User Macro or Hide From Reader Macro.

In addition to that the Section Macro and Content Marker Macro provides parameters that help to hide the page fragment.

Caution Box
titleNote the word 'hide'

The fragment is still on the page and can be accessed by anyone. This is because the page can be fetched in its storage format easily.

So do not hide sensitive information on a page. The hide feature is simply a convenience for the reader.

Panel
titleThe hidden Content in Storage Format

Panel
titleThe hidden Content in View Source

 

If you actually need to secure information then you probably need to install a third-party add-on.

...

Section
titleReferences

Section
titleResources

Piwik Set Multiple Custom Variables
NameValue
Departmentprojectdoc
Categoryprojectdoc-tip
Typehowto