Bug 1033830
| Summary: | Can we have a visual style for a providing tips to users? | ||||||
|---|---|---|---|---|---|---|---|
| Product: | [Community] Publican | Reporter: | nilakshi <nilakshihandique> | ||||
| Component: | publican | Assignee: | Jeff Fearn 🐞 <jfearn> | ||||
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Don Domingo <ddomingo> | ||||
| Severity: | low | Docs Contact: | |||||
| Priority: | unspecified | ||||||
| Version: | 3.2 | CC: | aigao, ddomingo, jfearn, rlandman, sgordon, topic-tool-list | ||||
| Target Milestone: | 4.2 | Keywords: | Reopened | ||||
| Target Release: | --- | ||||||
| Hardware: | Unspecified | ||||||
| OS: | Unspecified | ||||||
| Whiteboard: | |||||||
| Fixed In Version: | 4.2.0 | Doc Type: | Bug Fix | ||||
| Doc Text: | Story Points: | --- | |||||
| Clone Of: | Environment: | ||||||
| Last Closed: | 2014-09-01 03:40:29 UTC | Type: | Bug | ||||
| Regression: | --- | Mount Type: | --- | ||||
| Documentation: | --- | CRM: | |||||
| Verified Versions: | Category: | --- | |||||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||
| Cloudforms Team: | --- | Target Upstream Version: | |||||
| Embargoed: | |||||||
| Attachments: |
|
||||||
|
Description
nilakshi
2013-11-23 14:37:34 UTC
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. |