projectdoc Toolbox

projectdoc is based on projectdoc documents. Creating a projectdoc document is easy: A projectdoc document is a Confluence page using document properties and sections.

Parent
Audience
Level of Experience
Expected Duration
5 minutes
Tags
Contents

 

Create Documents

projectdoc is about document properties and document sections.

To define a document add document properties with the Document Properties Marker Macro and document sections with the Section Macro.

There are properties and sections that are available for all document types created by smartics.

 

projectdoc documents are usually defined as page blueprints by the Template Author.

Page Authors select the type of document that suits their requirements and simply add content. If they add new sections they are encouraged to use the Section Macro. But if the content is not meant to be transcluded, authors may decide to use simple HTML headers.

The document type supports authors in writing documents of a given kind. Due to the nature of the templates, readers only see those properties and sections which have meaningful information.

This we call "Guided Writing & clutter-free Reading".

 

 

What is Transclusion?

Transclusion is the inclusion of a document or part of a document into another document by reference.

B is transcluded in the document A.

Wikipedia
What is Single Sourcing?
To single source is to allow the same content to be used in different documents or in various formats. Wikipedia

Select Documents

With properties and sections defined in a document, authors may employ the autolist feature (e.g. the Display Table Macro) to select and list documents.

Select documents by their properties and display properties and sections of the selected documents.

Transclude Sections and Properties

Modular documentation supports reuse and collaboration for your team.

Transclusion of information (i.e. include information from another page) supports single-sourcing (i.e. have information in one and only one place).

Use the Transclusion Macro or the Transclude Documents Macro to transclude sections and the display property macros (e.g. Display Document Property Macro or Display Document Properties Macro) to transclude property values.

A document transcludes information (properties, sections, and page fragments) from other documents.

Resources

The following resources provide information to get started with projectdoc.

Related Intros

projectdoc Introduction
A short introduction into the concepts and features of the projectdoc Toolbox.
projectdoc Spaces
projectdoc introduces structure on a Confluence space. It adds the concept of homepages for document types.
projectdoc Space Relationships
projectdoc allows to group spaces and to set them in two kinds of relationships: delegate and search.
Learning projectdoc
Getting started with the projectdoc Toolbox is not easy. Some basic concepts are more than just good-to-know and the number of macros and doctypes may be simply overwhelming. This tip gives some advice on how to get started.

Related Topics

Doctypes Introduction
A gentle introduction to page blueprints provided by doctype add-ons. The page blueprints are grouped semantically to make it easier for users to build a conceptual mind map for them.
Document Types and Templates
Document types (or doctypes for short) define a set of properties and sections. Each doctype matches at least one Confluence Page Blueprint. Confluence Page Blueprints are a collection of templates, but often the collection contains only one element.
Document Type
A document type (doctype) defines the properties and section for document instances. It also provides home and index pages. In Confluence these doctypes are implemented as page blueprints, usually with one template. This template is used to create new pages in Confluence.
Doctypes
Provides a list of doctypes provided by various free add-ons. Doctypes define properties and sections for documents. They are essentially Confluence Blueprints that help to create pages in your wiki based on templates.

Related Tours

Tour for Document Authors
Tour through the documentation for users who want to learn to create documents based on projectdoc doctypes.

Blog Articles