This is a page to capture random notes and thoughts that will be factored into a future documentation section.
For developers:
- How attachment conversion works - Since attachments are handled differently for each wiki it is challenging to come up with a generalized strategy to handle all cases. Hence here is the current strategy. For PmWiki and DokuWiki at least the 'attachment converter' is implemented as a custom Java class which implements the 'BaseConverter' abstract class. (This is as opposed to most of the other 'converters' which are simply regular expressions.
- What exactly does an 'AttachmentConverter class' do?
- It is the job of this 'AttachmentConverter' class to not only identify attachment markup text and replace it with Confluence markup, but also to add to each internal 'Page' object of the UWC all the correct attachment info. A 'Page' object represents a wiki page. All this information is queued up and nothing is actually sent to Confluence until you say 'Yes' Send to Confluence. At that time all of the internal in memory 'Page' objects are iterated through. They are then both sent to Confluence and then their attachments are also sent to Confluence.
- What exactly does an 'AttachmentConverter class' do?