Main Content Title
Here is main content text.
Knowledge Base Macros
Last modified 3/21/2023
To add styling and visual elements to a page, there are a number of ISU macros that were created for the knowledge base to match the Illinois State University theme starting with '-ISU'.
Non-ISU Macros
There are a number of other non-ISU macros that you can use at your own risk. If you find you would like to use a non-ISU macro, but have it be ISU themed, fill out a ticket to request an ISU macro be created.
- Accessing macros
Accessing macros
You must be editing a page to access ISU macros.
- On the editor toolbar, Insert
> Other Macros - Choose one of the -ISU macros
- Accordion macros
Accordion Macros
The -ISU Accordion and -ISU Accordion Group are used to group your accordion together. Start with the -ISU Accordion Group and put one or more -ISU Accordion macros inside the group.
-ISU Accordion
A vertical interactive panel that expands and collapses to show or hide content. Must use inside an -ISU Accordion Group.
-ISU Accordion Group
A container for -ISU Accordion. Place one or more accordions inside this group.
<Ex: We are in an accordion>
- Alert macros
Alert Macros
Alert macros notify the user of important messages or system feedback.
-ISU Alert: Danger
Immediate danger
Use only if there is a risk of physical harm OR in conjunction with the Success alert in comparing when NOT to do something.
-ISU Alert: Info
Tips and Tricks
Most commonly used for tips and information.
-ISU Alert: Success
Successful submission
Use for successful submissions OR in conjunction with the Danger alert in comparing when to do something.
-ISU Alert: Warning
Warning
Use when there is a risk of non-physical harm.
- Button macro
Button Macro
Buttons are used to signal actions, submit forms, or trigger new content within the current context.
There are a number of available options to choose from the
-ISU Button:
- Buttons Colors: Red, Red Secondary, Blue, Blue Secondary buttons and Chevron link
Action Link - Button Sizes: Small, Default, Large, Jumbo
- Internal Link: Type a Confluence page title
- External Link: Only use if the link is outside Confluence
- Card macros
Card Macros
The -ISU Card and -ISU Card Group are used to group your cards together. Start with the -ISU Card Group and put one or more -ISU Card macros inside the group. Great for landing or homepages.
-ISU Card
A card is a boxed section of content about a single topic with options for images, titles, text, and buttons. Must use inside an -ISU Card Group.
Options:
- Card Title
- Card Text
- Button Link: Type a Confluence page title
- Button Text
- Card Image
- Image Alt Text: Add an image description
-ISU Card Group
A container for -ISU Card Group. Place one or more cards inside this group.
Options:
- Inset Space: Comfy or Compact -Decide how much vertical space the card group should take up
- Row Header: Put a header on your grouped cards
Row Header
-
Card Title
Bacon ipsum dolor amet prosciutto tenderloin pastrami ground round pork capicola, filet mignon andouille bacon.
-
Card Title
Bacon ipsum dolor amet prosciutto tenderloin pastrami ground round pork capicola, filet mignon andouille bacon.
-
Card Title
Bacon ipsum dolor amet prosciutto tenderloin pastrami ground round pork capicola, filet mignon andouille bacon.
-
Bacon ipsum dolor amet prosciutto tenderloin pastrami ground round pork capicola, filet mignon andouille bacon.
- Children display macro
Children display macro
Add the Children Display macro to a page to display a list of pages from a specific part of the page hierarchy.
Example of Children under the Knowledge Style Guide:
- Content by label macro
Content by label
The Content by Label macro is used to display lists of pages, blog posts or attachments that have particular labels. It's great for collecting related pages together and filtering out content that you don't want to see.
For example, you could use this macro to display a list of all pages that have the label 'feature-shipped' and include the word 'Blueprint', or to list any pages with the label 'meeting-notes' that you've been mentioned in.
Example:
- Page properties macro
The Page Properties macro uses key/value pairs. To display different styles of templates on a page you could add a table like below to your page properties. You would want to display you page properties as hidden.
Homepage
| Property Name | Value |
|---|---|
| SearchIntroText | About your site. |
| SearchThingsToTry | email, office 365, reggienet... |
| SearchButtons |
Interior pages
For use on the Technology site to have Tech Topics only on the right side.
| template | tech-topics.vm |
|---|
For non-standard, full-width pages. Using these pages will require the page to have -ISU Section macros.
| template | landing-page.vm |
|---|
- Section macros (Homepages/landing pages only)
Section macros
Sections create visual separations between items. Great for landing or homepages.
-ISU Section
Change the color of a section's background.
Options:
- Section Color: White, Light Gray, Blue, Gray Checkered, Chevrons
- Row Header
- Inset Border: None, Dashed border
Row Header
Here you can put content-ISU Section AND -ISU Section: Main Content AND -ISU Section: Sidebar
Adding Main Content and Sidebar inside of an -ISU Section allows the page to have a sidebar to the right. You must also choose Sidebar Grid: Right Sidebar in the -ISU Section properties for this to work properly.
Row Header
-ISU Section with Quicklinks
A pre-styled section with a row header, left column title and text, and quick links.
Options:
- Section Color: White, Light Gray, Blue, Gray Checkered, Chevrons
- Row Header
- Left Column Title
- Left Column Text
- Quicklinks
-ISU Section with Intro and Columns
A pre-styled section with a row header, intro section and columns.
Row Header
This is an intro section
This is the first column
This is the second column
This is the third column
This is the fourth column