...
- Helps ensure we have consistent information captured and displayed about resources (we can have both required and optional fields, and write templates for outputting the information for each resource; if we update the template, the markup of each outputted resource will automatically update)
- We'll more easily be easily able to parse and extract resources from the wiki using automated tools (this will help with getting them into Zotero or writing code to automatically generate resource lists in other contexts)
The easiest way to use the macro when entering content on a page is to type a { (left curly brace), which in the standard Confluence editor will open a "Macro suggestions" dropdown - you can then continue typing {reso or similar to find and insert the macro. This will display a similar interface to the one used to create a standard link, but with some further optional fields available (creator and description).
There are examples of using the macro below (and a screenshot). Please provide feedback to Alan Harnum on any aspect of this - the output template is very basic right now but can be easily customized to output different markup for each resource, or we can have other optional fields, etc.
Example of Harvesting Resources
Here is a simple example using RunKit of harvesting resources entered using the macro from the page and converting them into JSON: https://runkit.com/waharnum/5a70dd9238fd120014773566
Testing Tools
Some Useful Articles and Essays and Books
...