Versions Compared

Key

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

...

Document Properties Marker
doctypetopic
overridefalse


Short DescriptionThe projectdoc Toolbox installs a lot of macros and additional doctype add-ons install a lot of doctypes. This tips shows ways that allow to remove the projectdoc tools from the current page.
NameHide projectdoc Tools within Browserhide
Short Name
Parent
Parent Property
property-nameName
hide
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
property-restrict-value-rangetrue
propertyAudience
empty-as-nonetrue

Subject
Name List
doctypesubject
propertySubject

Categories
Name List
doctypecategory
property-restrict-value-rangetrue
propertyCategories

Tags
Tag List
propertyTags

Flagshide
Iteration

Iteration
valuefocusedreleased

hide
Type

Name List
doctypetopic-type
render-no-hits-as-blanktrue
namesTip
property-restrict-value-rangetrue
propertyType


Level of Experience

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


Expected Duration
Sponsors
Name List
doctypestakeholder
render-no-hits-as-blanktrue
propertySponsors

Userscript

System Link
file/projectdoc-bookmarklets/raw/master/src/main/resources/de/smartics/projectdoc/userscripts/Hide%20projectdoc%20Tools.user.js
system-idbitbucket-smartics
labelHide projectdoc Tools.user.js

hide
Sort Keyhide


...

Section
titlePrerequisites

For bookmarklets there are no prerequisites.

For userscripts the browser needs to install a plugin a userscript manager like Grease Monkey or Tampermonkey that build  must be installed to the browser. The userscript manager builds the context in which the script is executed.

...

Section
titleCommon Approach

The common approach to both solutions is that a JavaScript is run in the browser that matches HTML elements and alters them to be hidden. Therefore all elements are rendered as normal and then are hidden by the script.

Content Marker
idscreenshots


projectdoc-content-marker
idscreenshots-bookmarklet


Section


Column
width50%


Panel
titleSpace Blueprint Wizard with projectdoc Blueprints

Image Added



Column
width50%


Panel
titleSpace Blueprint Wizard without projectdoc Blueprints

Image Added




Section


Column
width50%


Panel
titlePage Blueprint Wizard with projectdoc Blueprints

Screenshot showing the Blueprint Wizard with projectdoc BlueprintsImage Added



Column
width50%


Panel
titlePage Blueprint Wizard without projectdoc Blueprints

Screenshot showing the Blueprint Wizard without projectdoc BlueprintsImage Added




Section


Column
width50%


Panel
titleMacro Browser with projectdoc Macros

Screenshot showing the Macro Browser with projectdoc MacrosImage Added



Column
width50%


Panel
titleMacro Browser without projectdoc Macros

Screenshot showing the Macro Browser without projectdoc MacrosImage Added





Section


Column
width50%


Panel
titleMacro Suggestions with projectdoc Macros

Screenshot showing the Macro Suggestions with projectdoc MacrosImage Added



Panel
titleMacro Suggestions without projectdoc Macros


Column
width50%

Macro Suggestions without projectdoc MacrosImage Added




Note that this use case is not properly supported the bookmarklet. A user will probably not run the bookmarklet manually when using the autocomplete function to select a macro.

Note Box
titleHide selectively?

The following examples show how to remove all macros or doctypes from the view.

In case you need to remove these tools selectively, you would need to adjust the CSS selectors in the scripts.



Section
titleBookmarklet Solution

The bookmarklet solution is easily installed as a bookmark in a browser. The advantage is that no additional tools are required. The disadvantage is that the user needs to open the bookmarklet to remove the elements from the page manually each time.

This solution may be appropriate in case the user only occasionally wants to remove the element.

Transclusion
documentHide projectdoc Tools
idsCode

For more information on the bookmarklet, please visit Hide projectdoc Tools within Browser.


Section
titleUserscript Solution

The userscript can be configured to be automatically executed on every page whose URL matches a regular expression. This way a user may select the script to remove element only on certain spaces, while leave them untouched on others.

A userscript is a JavaScript script with some metadata. It may also use services provided by the userscript manager context.

Text Snippet
propertyUserscript

The following screenshot shows the script installed with Tampermonkey.

Screenshot showing the installed userscript in with TampermonkeyImage RemovedScreenshot showing the installed userscript in with TampermonkeyImage Added

You may want to edit the script and adjust the match URL to your Confluence server.

Code Block
languagejs
// @match        https://*/confluence/*

The browser plugin may also take care of automatically update the scripts. The source of the script could be hosted in a controlled environment. We recommend to copy the script to your server and alter it to meet your specific requirements.

For more information on the userscript, please visit Hide projectdoc Tools.


projectdoc-section
titleDeactivation of Blueprints

As mentioned in the introduction, blueprints can be deactivated in your Confluence instance.

This short example walks you through the steps to deactivate the projectdoc Blank Document Doctype. This doctype is a meant as a simple starter for new users. Once the team uses the Core Doctypes or has designed their own doctypes, this doctype is no longer needed.

Caution Box
titleInternal Problems after deactivating Module?

If modules are deactivated, the space blueprint wizard may fail. This is related to Space Wizard Dialog fails after deactivating Add-on.

So in case you have deactivated modules you may want to check if the space wizard dialog still opens.

  1. As an admin, go to Manage apps
  2. Select the app that contains the blueprint you want to deactivate
    Image Added
  3. Open the list of modules by clicking on the plus sign
     Image Added
  4. Deactivate the following modules for each doctype: The doctype template, the home and index page template, the blueprint and the wizard module.
    Image Added

For information on how to control blueprints on space level, please refer to the tip Overwhelmed with Blueprints?.


Section
ignore-template-buttonstrue
titleSubordinate Topics


Hide From Reader

Create from template
blueprintModuleCompleteKeyde.smartics.atlassian.confluence.smartics-projectdoc-confluence-space-core:projectdoc-blueprint-doctype-topic
buttonLabelCreate Topic

Display Table
doctypetopic
render-no-hits-as-blanktrue
render-modedefinition
selectName, Short Description
restrict-to-immediate-childrentrue
sort-bySort Key, Name

...

Section
titleResources


Tour
render-no-hits-as-blanktrue
render-as-definition-listtrue
marker-column-property-nameTitle
replace-title-with-nametrue


TitleShort Description
Hide projectdoc Tools
Bookmarklets
Community Resources
TampermonkeyThe homepage of Tampermonkey.
Tampermonkey DocumentationDescribes how the Tampermonkey API can be used and what is different to Geasemonkey.
Overwhelmed with Blueprints?




Piwik Set Multiple Custom Variables


NameValue
Departmentprojectdoc
Categoryprojectdoc-tip
Typehowto


...