We can have a visual style for providing tip just like we have for Note, Warning, and Important (screenshot attached for reference). The Tip element is important to provide information that helps users apply the techniques and the procedures that are described in the text in a better way. The element might contain information such as keyboard shortcuts,alternate ways to perform the same procedure etc.
Created attachment 828094 [details] Attachment for reference.
The publishing toolchain (specifically Publican) actually explicitly disallows the use of "tip" and "caution". From http://jfearn.fedorapeople.org/en-US/Publican/3.2/html/Users_Guide/appe-Users_Guide-Disallowed_elements_and_attributes.html#sect-Users_Guide-Disallowed_elements_and_attributes-Disallowed_elements : "DocBook XML supports five admonitions of varying severity: <tip>, <note>, <important>, <caution>, and <warning>. Taken together, these represent a very fine-grained set of distinctions. It is unlikely that these fine distinctions can be applied consistently within a document, especially when more than one person writes or maintains the document. Moreover, this level of granularity is meaningless to readers. By design, Publican disallows the <tip> and <caution> elements, these elements being the two most redundant in the set. Use <note> instead of <tip>, and use either <important> or <warning> instead of <caution>. Some criteria by which you might select a suitable level of severity are presented in the ‘Document Conventions’ section of the preface of books produced with Publican's default brand."
Changed to PUG component as the PUG is out of date on this. Publican does not disallow any element, it recommends against them and may not provide any style for them, but it does not prevent you from using them or stop brands from styling them. The PUG should be updated to match this.
Going to add tip formatting to HTML5 output.
http://jfearn.fedorapeople.org/HTML5_Test/html/pref-Publican-Users_Guide-Preface.html#idm210053778208 Text for tip and caution required. Rudi, please set a docs contact for above.
Verified that this works; when using <tip> and <caution> with the common-db5 branch, the resulting HTML style looks exactly as laid out in the link provided by Jeff. (In reply to Jeff Fearn from comment #6) > http://jfearn.fedorapeople.org/HTML5_Test/html/pref-Publican-Users_Guide- > Preface.html#idm210053778208 > > Text for tip and caution required. > > Rudi, please set a docs contact for above.
Sorry, I meant common-db5 *brand* (In reply to Don Domingo from comment #7) > Verified that this works; when using <tip> and <caution> with the common-db5 > branch, the resulting HTML style looks exactly as laid out in the link > provided by Jeff.
A fix for this shipped in Publican 4.2.0.