Macabacus libraries are repositories for content and templates intended for frequent reuse that facilitate the standardization and preparation of materials produced by you or your organization. You can create up to three libraries with Macabacus—a personal library intended for use by a single Macabacus user, a team library to be shared by users in a group, and a company library to be shared by all users in an organization.
Macabacus libraries are similar to PowerPoint's native Slide Library, except that (a) Macabacus requires neither the Professional Plus version of Office nor SharePoint to deliver such functionality, and (b) Macabacus lets you add much more than just slides to the library.
A Macabacus library may contain several types of content:
A Macabacus library may contain three types of templates:
The term "template" is used here loosely, as "template" normally refers to .xltx/.xltm and .dotx/.dotm files in the context of Excel and Word, respectively.
Macabacus > Library button in PowerPoint, Excel, or Word to open the Library pane and
display content in your libraries. The types of content available in the Library pane vary with the Office
application in which you opened the Library pane. For example, slide content is only viewable in the Library pane
when opened in PowerPoint. Use the toggle buttons at the top of the pane to and in the expandable Filters section
toggle the visibility of libraries and content types. The search bar searches pre-indexed slide and other text very
quickly; a powerful tool to help you find what you are looking for fast. Library images are displayed on a
checkered background, so that you can determine if transparency is supported, as you would expect for certain
illustration file formats (.svg, .png, and .emf).
To insert content into your presentation, workbook, or document, select the desired content and click the
Insert button. Macabacus will insert the content at the current selection. When inserting shapes,
images, and charts into PowerPoint with a placeholder pre-selected, Macabacus places the content into the
placeholder if the placeholder accepts the type of content being inserted. When inserting charts into Excel, the
inserted chart and its dummy data are added to the workbook on a new worksheet.
In PowerPoint, when you click native buttons for inserting pictures and charts, either on the ribbon or in some content placeholders, Macabacus can override the native behavior and open the Library pane instead, showing images or charts, as appropriate. If the Library pane is already open, then clicking these buttons results in native behavior (so, you can always click twice for native behavior). These settings are enabled by default, and can be changed in the
PowerPoint > Library Behavior section of the Settings dialog, if desired.
If multiple cells in a single column or row are selected when inserting images from libraries in Excel, the image will be sized to match the height or width, respectively, of the selection. Otherwise, images are inserted at their original size.
You can optionally link slides (including Meta Slides) inserted into PowerPoint from the Library pane to their library source presentations, so they can be updated with a click of a button. To link inserted slides, check the
Link to Source checkbox (icon) at the bottom of the Library pane. Read more about linking with PowerPoint slides.
A slide highlighting recent deals is published to your library. This slide is updated quarterly and is used frequently in presentations. An analyst begins drafting a presentation including this slide on June 20, but by the time the presentation is ready for print on July 5, the slide is outdated. With the click of a button, the analyst can replace the outdated slide with the library's updated version.
Presentation templates in your libraries are used by several of Macabacus for PowerPoint's presentation automation tools, and require specific configuration in order to work with these tools. You "use" a presentation template in your library by setting it to the "active" template, as discussed in another section of this manual. Spreadsheets and document "templates," on the other hand, are simply collections of useful workbooks and documents intended to serve as starting points or building blocks for creating financial models or a new fax cover page, for example. You use model and document templates by accessing them from the
Macabacus > New menus in Excel and Word.
You can work with your remote library content and templates even when disconnected from the Internet or the network on which remote libraries are stored. When Macabacus cannot connect to a remote library, it will automatically switch to the locally cached version of the library (if caching is enabled). When inserting cached content using the Library pane in PowerPoint in Macabacus v8 and older, the option to link inserted slides to the library is disabled. An icon in the Library pane notifies the user when cached content is displayed.
Macabacus automatically caches remote libraries at the frequency you specify in the Library Manager dialog (or Libraries section of the Settings dialog in v8). The default is every three days (seven days in v8). This setting can be shared as part of enterprise configuration so that remote libraries will be cached at the desired frequency for all Macabacus users. Automatic caching, when required, occurs in the background upon starting Excel, PowerPoint, or Word. Macabacus performs incremental caches, updating only those files and folders in the local cache that have changed in the remote library to reduce network load and improve caching speed. In Macabacus v9, cached libraries are saved in the following local folder:
C:\Users\%USER NAME%\AppData\Roaming\Macabacus\Cached Libraries
In older versions of Macabacus, cached libraries are saved in the following local folders, as applicable:
As of v9, Macabacus defaults to using cached libraries full-time to maximize Library pane performance. This means that users' Library pane contents may be outdated until the next cache is performed, which is determined by your cache frequency (a customizable setting). If you prefer to display remote content in the Library pane, disable the
Use cached libraries option in the Library Manager dialog. Whether or not you choose to always use cached libraries does not affect the ability to link inserted slides as in prior versions of Macabacus.
In older versions of Macabacus you must manually enable the option to always use cached libraries in the Settings dialog. Enabling this option can improve how quickly content loads in the Library pane, depending on the speed of your network and how much content resides in the library, but prevents linking to library slide content and may leave you with outdated cached content and templates. If you decide to enable this option, set your cache frequency to a small value, like every one or two days.
In Macabacus v9, all library management is performed in a single dialog called the Library Manager, accessed from the
Macabacus > Settings menu. Use the Library Manager to configure add, remove, and otherwise configure libraries; add, delete, and republish library content and templates; configure user group access; configure custom fields for content that supports metadata; and more.
In older versions of Macabacus, library configuration is performed in Macabacus' Settings dialog, and content and templates are published to libraries from the
Macabacus > Settings > Publish to Library menu. To otherwise manage library content and templates, click the
Macabacus > Settings > Manage Libraries > Library Contents button.
Making changes to shared libraries (v9) or the company library (v8) requires that either (a) the user be a Macabacus account administrator, or (b) the host Office application be run as a Windows administrator.
A library contains several pre-defined content categories, such as Slides, Shapes, Charts, Tables, etc. These categories cannot be modified. Each category may contain one or more content groups that can be modified as desired. In Library Manager, expanding a library node will reveal the content categories, and expanding a category node will reveal the content groups in that category (see image above).
When setting up shared libraries for the first time, give thoughtful consideration to their structure before publishing content to them (except as needed for testing). Questions to ask yourself include:
If you intend to store library content in a cloud storage location like OneDrive or Dropbox, verify that your cloud storage shared folder is properly configured before before proceeding. To do this, go to the
General > Cloud Storage section of Macabacus' Settings dialog and follow the instructions there (no change may be required). If you did not complete this step before defining your shared libraries, you must delete existing shared library definitions and start over (note that this does not necessarily mean that you need to delete any content previously published to shared libraries).
If you intend to use user groups to manage library read/write access, define them in your Admin Console before setting up shared libraries. Although you can add user groups at any time, considering how user groups impact your library structure may save you the hassle of moving / republishing library content later.
If you use a cloud storage service like OneDrive, SharePoint, or Dropbox, ensure that you have configured your cloud storage shared folder path before defining shared libraries as described below.
Before you can publish content to your shared libraries, you must define one or more shared libraries as follows:
New Librarybutton, populating the library definition fields as desired, and clicking the
Create Shared Librarybutton. Keep in mind the following points about library paths:
C:\Users\bob\OneDrive - Company, then your shared library path should point to a downstream folder such as
C:\Users\bob\OneDrive - Company\My Library.
Shared Librariesbox is checked, and publish your settings. This makes others' Macabacus installations aware of your organization's shared library locations.
After initial setup, if you add a add, remove, or modify a library definition, you must republish shared settings as described above for other users to see these changes. This applies only to library definitions, not changes to library contents.
Content and templates are added to a library by "publishing" them in Macabacus v9 as follows:
Chartsnode to publish charts).
Publish to Groupbutton and follow the instructions.
In Macabacus v8, publish content and templates to libraries from the
Macabacus > Settings > Publish to Library menu:
Follow the steps above to publish library content and templates, except check the box to replace existing content when prompted.
Observe the following guidelines and recommendations for publishing certain types to libraries:
Slides published to libraries should generally have a descriptive title for identification and searchability purposes. Macabacus reads all text on published slides and stores it for fast reference when users perform text searches in the Library pane. Macabacus cannot read text in images and embedded objects.
When you publish slides in Macabacus v8 and older, the slides in your original presentation are marked with unique identifiers used for linking purposes. Therefore, it is necessary to retain the original presentation so that it can be republished, if desired, without breaking links between other presentations and slides in your library. See below for more guidance on republishing.
Create a presentation containing only those shapes you want to add to the library (placeholder shapes will be ignored). Each shape should be assigned a name in the PowerPoint Selection Pane that describes that shape's form, function, or intended use. Shape names are used for identification and searchability.
Library images include company logos, headshot photos, stock photography, and other reusable imagery. Before publishing images, ensure each image's file name describes the image, as file names are used for identification and searching. For example, a company logo should naturally include the company's name in the file name. The reminaing guidance in this section is applicable to Macabacus v8 or older.
To publish multiple images at once you create a folder containing only those images—such as company logos, headshot photos, and other reusable imagery—that you want to add to the library and publish the entire folder. In newer versions of Macabacus the process is more intuitive.
You can publish multiple image galleries (folders) to libraries, so it is not necessary to place all images into a single folder. You may prefer to use multiple folders to group similar images. For example, if you want to add 100 company logos and 15 headshot photos to a library, it makes sense to organize these images in separate logo and head shot folders. Also, if you have hundreds of logos to publish, you could break them into folders named A-G Logos, H-M Logos, and so on.
Publishing charts involves publishing a workbook. Ensure that your workbook observes the following guidelines:
Publishing tables involves publishing a workbook. Ensure that your workbook observes the following guidelines:
Macabacus will publish the selected text or text within any selected object (e.g., shape, cell) in Excel, PowerPoint, or Word. Only text is published; text formatting is not preserved.
Instructions for configuring and publishing tombstones are detailed in the tombstones section of this documentation.
Respublishing content in Macabacus v9 or later is intuitive and generally does not warrant explanation, so this section focuses on republishing in Macabacus v8 and earlier.
You can republish content and templates using the same processes described above. Ensure that any content files/folders being republished have the same name as those that were originally published to ensure that the old versions are overwritten. Macabacus will prompt you to confirm your intent to overwrite existing library content/templates.
When republishing slides, specifically, there are additional considerations involving slide links. When you originally published your slides to a library, the slides in your presentation were invisibly marked with unique link identifiers to support linking from other presentations. Therefore, when republishing slides, make any necessary changes in the original presentation and follow the guidance below to ensure that these link identifiers are preserved upon republishing.
When republishing slides in v8, consider whether the Migrate Links tool is needed to preserve slide link identifiers. Also, do not copy and paste slides within the presentation to be republished. Otherwise, links to library slides in other presentations may be broken.
When Macabacus is run for the first time after installation, or when Macabacus does not detect a personal library folder upon starting Office applications, Macabacus will automatically create a personal library and populate it with sample content and templates to demonstrate the functionality of libraries and other tools. Macabacus normally creates this library in your
Documents folder, and its contents are copied from the installation files found at
C:\ProgramData\Macabacus\Macabacus 20XX\Sample Library.
When the Macabacus software is subsequently updated, the newest versions of sample library content will reside in the
ProgramData folder above, but your existing personal library folder will not be updated. Accordingly, you may be confused if you are reading a description of Macabacus-enabled templates in this manual, but the sample template in your personal library does not conform to the description. In these cases, you should refer to the sample files in your
ProgramData folder, or reset your personal library (more on that below).
Sample content and templates are provided for demonstration purposes, only, and are not considered part of Macabacus software. They may be removed, replaced, or modified as desired.
To reset all content and templates in your personal library to the sample library content/template installed with Macabacus, open the Library Manager dialog, select your personal library, and click the
Reset Librarybutton. In Macabacus v8 and earlier, click the
Macabacus > Settings > Manage Libraries > Library Contents button, select the personal library, and click the
Reset button. A reset can only be performed on your personal library, not shared libraries. It may be a good idea to back up your personal library folder by simply making a copy of it, prior to resetting the library, so that you can subsequently reverse these changes, if desired. If you want to reference a file in the sample library that has been deleted, you may not need to reset your personal library at all. The file you want to reference can be found at
C:\ProgramData\Macabacus\Macabacus 20XX\Sample Library (the
ProgramData folder may be hidden).
This documentation refers to Macabacus version 9.2.7. Some features and descriptions of these features may not
apply to older versions of Macabacus. Update your Macabacus software to take advantage of the latest features.