Manual:Extension/ContentDroplets/Icon: Difference between revisions

No edit summary
m ((username removed) (log details removed))
 

Latest revision as of 15:36, 24 July 2023

Using the template

Bootstrap icons

  1. Find a bootstrap icon from the list of currently supported icons.
  2. Click on the icon you would like to use. The icon page shows you the class-name of the icon on the right side of the page:
  3. Highlight the class name (it has the format bi bi-myicon) and copy it to your clipboard (ctrl+c).
  4. Go back to your wiki page.
  5. Open the Droplets dialog in VisualEditor:
  6. Select the Icon-droplet:
    screenshot showing the 3 steps to select the icon-droplet
    Selecting the icon droplet
    1. Search for the droplet "Icon"
    2. Click on the Icon-card
    3. Click the Insert button
  7. Copy the icon class from your clipboard:
    Template editor
    Template editor
  8. Change the font size (optional) if you want the size to be different from the text surrounding it (e.g., from the size of a heading if the icon is placed in the heading or of the paragraph text if the icon is placed in the flow-text. Smaller than text icons are usually sized no smaller than 0.85em and larger icons up to 2.5em.
  9. Color: If you want the color to be different from the surrounding text, you can specify any web color (e.g., a color name like blue or a hex-valuesuch as #0059b3 for a more specific blue). A list of web colors can be found at https://www.w3schools.com/colors/colors_picker.asp
  10. Vertical alignment: It should not be necessary to provide an alignment value. The standard is set to text-top and usually works in headings and in flow-text. If it looks a little off, you can try other vertical-alignment values, such as text-bottom. For a full list of possible values, see https://www.w3schools.com/cssref/pr_pos_vertical-align.asp.
  11. Click Apply changes.

The icon is now displayed on the page.

Inserted Bootstrap icon
Inserted Bootstrap icon

FontAwesome icons

The exension FontAwesome is bundled starting at BlueSpice version 4.3. In one of our next patches, we will add the possibility to use them in the Icon droplet. In the meantime, you can add FontAwesome icons with the {{#fas:...}} parser-function in source edit mode. See the official MediaWiki documentation.




To submit feedback about this documentation, visit our community forum.