Create a wiki article/page
A wiki article/page can contain multiple actions or instructions to preform a task. The page should include content from detailed articles if possible. The page can use one or two options for pulling content from a detail article.
- The Excerpt Include macro will insert content marked in a page using the excerpt macro.
- The Include Page macro will pull the entire detail article page into the page.
Step-by-step guide
Using the Excerpt Include marco
a. Select the + (plus sign) on the top menu bar to get the drop down menu to access macro
b. Scroll down the drop down menu to select Other macros
c. Enter excerpt and select Excerpt Include.
d. Enter the page that contains content excerpt and select the page from the list.
e. To view how the selected page excerpt will display select Preview.
g. If you do not want to see the Surrounding Panel, the Page Name, select Remove Surrounding Panel and then select Preview to see how the content will be displayed.
After preview selected.
h. Select insert to have content included on the page. The excerpt include macro content appears below.
The content should be marked by an excerpt macro. The excerpt macro marks the content of the detail article which can be pulled into other pages as needed. When the detail article is updated, the new information will be pulled into all pages that use it. This allows for a change in only one page making it easier to maintain over time.
2. Using Include Page Macro.
a. Follow steps 1 a. and 1 b. to get search menu for macros.
b. Enter excerpt and select Include Page.
c. Enter the page you wish to include and select the page form the list
d. Select Preview to view the page and it's content which is being included.
e. Select Insert to add (include) the page content, the included page is displayed below.
Note: the Page Name will not be displayed and the all remaining content is displayed including Info and Related article sections is present.
THIS IS THE CONTENT FROM THE CREATE A DETAIL ARTICLE PAGE
A detail article has information for a specific topic or action. It may contain steps with screen shots or a simple set of instructions that the user should follow.
This page can mark specific content which may be used by multiple pages using the Excerpt macro. The other option to reuse the detail article is to pull the whole page into another page by using the Include Page macro to access the detail article page.
Example of marking content with excerpt macro:
- When editing the page select the content to mark for reuse:
2. Marking content with the excerpt macro.
a. Select the + (plus sign) on the top menu bar to get the drop down menu to access macro
b. Scroll down the drop down menu to select Other macros
c. Enter excerpt into the search box to find the macro and then select Excerpt
d. A Preview of the mark content will be displayed, select Insert to mark the content.
e. The content will display as follows when the page is in edit mode
f. When the page is published the content will display without the excerpt box. The content that was marked is below:
The content should be marked by an excerpt macro. The excerpt macro marks the content of the detail article which can be pulled into other pages as needed. When the detail article is updated, the new information will be pulled into all pages that use it. This allows for a change in only one page making it easier to maintain over time.
Related articles
Basic Guide to Create a Wiki Page
THIS IS THE END OF THE CONTENT FROM THE CREATE A DETAIL ARTICLE PAGE
If there are multiple excerpts on a page use Multiexcerpt Include macro to be able to specify the excerpt to include. Additional resources from confluence:
Excerpt Include macro: https://confluence.atlassian.com/confcloud/excerpt-include-macro-724765190.html
Include Page macro: https://confluence.atlassian.com/conf615/include-page-macro-967337939.html
Related articles
Basic Guide to Create a Wiki Page
Create a wiki detail article/page