Emoji and Icons

How to use icons in the wiki

You can use any font awesome icon listed at https://fontawesome.com/v4.7.0/icons/ in your wiki documents by use of the icon macro.

Syntax for inserting icons
icon:thumbs-up []
icon:database[role=green] // change color by use of the role syntax
icon:heart[2x] // icons can be sized
icon:shield[rotate=90, flip=vertical] // rotate and flip

When setting the icons name, you do not have to preface it with fa-, asciidoctor will accept the font name.

The icon macro has three attributes you can set, they are size, rotate, and flip.

  • size

    • The first positional attribute found, scales the icon; values are: 1x (default), 2x, 3x, 4x, 5x, lg, fw

    • You can fix the width of the icon by use of the fw attribute. This helps when trying to align with other elements by giving the icon a fixed width.

  • rotate

    • Rotates the icon; values are: 90, 180, 270

  • flip

    • Flips the icon; values are: horizontal, vertical

The first unnamed attribute is assumed to be the size. For instance, to make the icon twice the size as the default, simply add 2x inside the square brackets.

icon:heart[2x]

Results:

2x

To rotate and flip the icon:

icon:shield[rotate=270, flip=vertical]

Results:

rotated 90, and flipped vertical

You can also link to icons.

icon:download[link="https://rubygems.org/downloads/asciidoctor-1.5.2.gem"]

Results:

Lastly, you can color your icons using the role syntax.

icon:database[role=green]

Results:

colored green

How to use emoji in the wiki

Using emoji in wiki docs currently requires the setting of the :stylesheet: attribute in the header of the wiki document.

:stylesheet: twemoji-awesome.css

The Anatomy of a Wiki Header document explains setting of this and other header attributes.

Once the header attribute is set, you can add the emoji using the following syntax.

emoji:heart[2x] // the "[2x]" is a size modifier
emoji:rage[]

You can change the icon size with the size modifier [2x].

emoji:heart[] emoji:heart[2x]

Emoji and Name Cheet Sheet

People

smile
smiley
[emoji heart-eyes not found] heart-eyes
flushed
grin
[emoji stuck-out-tongue-closed-eyes not found] stuck-out-tongue-closed-eyes
[emoji kissing-smiling-eyes not found] kissing-smiling-eyes
worried
[emoji open-mouth not found] open-mouth
hushed
[emoji sweat-smile not found] sweat-smile
pensive
fearful
cry
astonished
angry
sleepy
sunglasses
[emoji smiling-imp not found] smiling-imp
innocent
[emoji blue-heart not found] blue-heart
[emoji green-heart not found] green-heart
heartpulse
cupid
star
boom
question
zzz
notes
[emoji poop not found] poop
[emoji ok-hand not found] ok-hand
v
[emoji open-hands not found] open-hands
[emoji point-left not found] point-left
pray
muscle
couple
dancers
[emoji information-desk-person not found] information-desk-person
[emoji person-with-pouting-face not found] person-with-pouting-face
couplekiss
haircut
girl
baby
[emoji person-with-blond-hair not found] person-with-blond-hair
[emoji construction-worker not found] construction-worker
princess
[emoji heart-eyes-cat not found] heart-eyes-cat
[emoji scream-cat not found] scream-cat
[emoji pouting-cat not found] pouting-cat
[emoji see-no-evil not found] see-no-evil
guardsman
lips
ear
tongue
[emoji busts-in-silhouette not found] busts-in-silhouette

laughing
relaxed
[emoji kissing-heart not found] kissing-heart
relieved
wink
grinning
[emoji stuck-out-tongue not found] stuck-out-tongue
frowning
grimacing
expressionless
sweat
disappointed
[emoji cold-sweat not found] cold-sweat
sob
scream
rage
yum
[emoji dizzy-face not found] dizzy-face
[emoji neutral-face not found] neutral-face
alien
[emoji purple-heart not found] purple-heart
[emoji broken-heart not found] broken-heart
[emoji two-hearts not found] two-hearts
[emoji sparkling-heart not found] sparkling-heart
star2
anger
[emoji grey-exclamation not found] grey-exclamation
dash
[emoji musical-note not found] musical-note
+1
[emoji punch not found] punch
wave
[emoji point-up not found] point-up
[emoji point-right not found] point-right
[emoji point-up-2 not found] point-up-2
walking
family
[emoji ok-woman not found] ok-woman
[emoji raised-hand not found] raised-hand
[emoji person-frowning not found] person-frowning
[emoji couple-with-heart not found] couple-with-heart
[emoji nail-care not found] nail-care
woman
[emoji older-woman not found] older-woman
[emoji man-with-gua-pi-mao not found] man-with-gua-pi-mao
cop
[emoji smiley-cat not found] smiley-cat
[emoji kissing-cat not found] kissing-cat
[emoji crying-cat-face not found] crying-cat-face
[emoji japanese-ogre not found] japanese-ogre
[emoji hear-no-evil not found] hear-no-evil
skull
kiss
eyes
[emoji love-letter not found] love-letter
[emoji speech-balloon not found] speech-balloon

blush
smirk
[emoji kissing-closed-eyes not found] kissing-closed-eyes
[emoji satisfied not found] satisfied
[emoji stuck-out-tongue-winking-eye not found] stuck-out-tongue-winking-eye
kissing
sleeping
anguished
confused
unamused
weary
confounded
persevere
joy
[emoji tired-face not found] tired-face
triumph
mask
imp
[emoji no-mouth not found] no-mouth
[emoji yellow-heart not found] yellow-heart
heart
heartbeat
[emoji revolving-hearts not found] revolving-hearts
sparkles
dizzy
exclamation
[emoji grey-question not found] grey-question
[emoji sweat-drops not found] sweat-drops
fire
[emoji thumbsdown not found] thumbsdown
fist
hand
[emoji point-down not found] point-down
[emoji raised-hands not found] raised-hands
clap
runner
dancer
[emoji no-good not found] no-good
[emoji bride-with-veil not found] bride-with-veil
bow
massage
boy
man
[emoji older-man not found] older-man
[emoji man-with-turban not found] man-with-turban
angel
[emoji smile-cat not found] smile-cat
[emoji smirk-cat not found] smirk-cat
[emoji joy-cat not found] joy-cat
[emoji japanese-goblin not found] japanese-goblin
[emoji speak-no-evil not found] speak-no-evil
feet
droplet
nose
[emoji bust-in-silhouette not found] bust-in-silhouette
[emoji thought-balloon not found] thought-balloon

Nature

sunny
snowflake
cyclone
cat
hamster
frog
bear
cow
monkey
camel
[emoji panda-face not found] panda-face
[emoji baby-chick not found] baby-chick
chicken
bug
beetle
[emoji tropical-fish not found] tropical-fish
whale2
ram
tiger2
goat
pig2
[emoji dragon-face not found] dragon-face
[emoji dromedary-camel not found] dromedary-camel
poodle
[emoji cherry-blossom not found] cherry-blossom
rose
[emoji maple-leaf not found] maple-leaf
herb
[emoji palm-tree not found] palm-tree
chestnut
[emoji ear-of-rice not found] ear-of-rice
[emoji sun-with-face not found] sun-with-face
[emoji new-moon not found] new-moon
[emoji waxing-gibbous-moon not found] waxing-gibbous-moon
[emoji last-quarter-moon not found] last-quarter-moon
[emoji first-quarter-moon-with-face not found] first-quarter-moon-with-face
[emoji earth-americas not found] earth-americas
[emoji milky-way not found] milky-way

umbrella
snowman
foggy
dog
rabbit
tiger
pig
boar
horse
sheep
snake
[emoji hatched-chick not found] hatched-chick
penguin
[emoji honeybee not found] honeybee
snail
fish
dolphin
rat
rabbit2
rooster
mouse2
blowfish
leopard
[emoji paw-prints not found] paw-prints
tulip
sunflower
leaves
mushroom
[emoji evergreen-tree not found] evergreen-tree
seedling
shell
[emoji full-moon-with-face not found] full-moon-with-face
[emoji waxing-crescent-moon not found] waxing-crescent-moon
[emoji full-moon not found] full-moon
[emoji waning-crescent-moon not found] waning-crescent-moon
moon
[emoji earth-asia not found] earth-asia
[emoji partly-sunny not found] partly-sunny

cloud
zap
ocean
mouse
wolf
koala
[emoji pig-nose not found] pig-nose
[emoji monkey-face not found] monkey-face
racehorse
elephant
bird
[emoji hatching-chick not found] hatching-chick
turtle
ant
octopus
whale
cow2
[emoji water-buffalo not found] water-buffalo
dragon
dog2
ox
crocodile
cat2
bouquet
[emoji four-leaf-clover not found] four-leaf-clover
hibiscus
[emoji fallen-leaf not found] fallen-leaf
cactus
[emoji deciduous-tree not found] deciduous-tree
blossom
[emoji globe-with-meridians not found] globe-with-meridians
[emoji new-moon-with-face not found] new-moon-with-face
[emoji first-quarter-moon not found] first-quarter-moon
[emoji waning-gibbous-moon not found] waning-gibbous-moon
[emoji last-quarter-moon-with-face not found] last-quarter-moon-with-face
[emoji earth-africa not found] earth-africa
volcano

Objects

bamboo
[emoji school-satchel not found] school-satchel
fireworks
[emoji rice-scene not found] rice-scene
santa
apple
balloon
baseball
bathtub
beers
bicyclist
[emoji black-joker not found] black-joker
bomb
books
bread
cake
camera
cd
cherries
clapper
[emoji closed-lock-with-key not found] closed-lock-with-key
cocktail
[emoji confetti-ball not found] confetti-ball
[emoji credit-card not found] credit-card
curry
dart
dollar
dress
egg
email
fax
[emoji fishing-pole-and-fish not found] fishing-pole-and-fish
[emoji flower-playing-cards not found] flower-playing-cards
[emoji fried-shrimp not found] fried-shrimp
gem
grapes
guitar
hammer
hearts
hocho
hourglass
icecream
iphone
kimono
lipstick
lollipop
[emoji low-brightness not found] low-brightness
mahjong
[emoji mailbox-with-mail not found] mailbox-with-mail
[emoji meat-on-bone not found] meat-on-bone
memo
minidisc
[emoji mountain-bicyclist not found] mountain-bicyclist
[emoji musical-score not found] musical-score
necktie
notebook
oden
[emoji outbox-tray not found] outbox-tray
pager
pear
pill
[emoji postal-horn not found] postal-horn
[emoji poultry-leg not found] poultry-leg
pushpin
ribbon
[emoji rice-cracker not found] rice-cracker
[emoji running-shirt-with-sash not found] running-shirt-with-sash
satellite
scroll
shirt
smoking
sound
spaghetti
[emoji straight-ruler not found] straight-ruler
sushi
syringe
tangerine
telescope
tomato
trophy
tv
[emoji video-camera not found] video-camera
watch
[emoji womans-clothes not found] womans-clothes
yen

[emoji gift-heart not found] gift-heart
[emoji mortar-board not found] mortar-board
sparkler
[emoji jack-o-lantern not found] jack-o-lantern
8ball
art
banana
basketball
battery
bell
bikini
[emoji black-nib not found] black-nib
bookmark
boot
briefcase
calendar
candy
[emoji chart-with-downwards-trend not found] chart-with-downwards-trend
[emoji chocolate-bar not found] chocolate-bar
clipboard
[emoji closed-umbrella not found] closed-umbrella
coffee
cookie
crown
custard
date
door
dvd
eggplant
euro
[emoji file-folder not found] file-folder
flashlight
football
fries
gift
[emoji green-apple not found] green-apple
gun
handbag
[emoji high-brightness not found] high-brightness
[emoji honey-pot not found] honey-pot
[emoji hourglass-flowing-sand not found] hourglass-flowing-sand
[emoji inbox-tray not found] inbox-tray
jeans
ledger
lock
loop
mag
mailbox
[emoji mailbox-with-no-mail not found] mailbox-with-no-mail
mega
microphone
[emoji money-with-wings not found] money-with-wings
[emoji movie-camera not found] movie-camera
mute
newspaper
[emoji notebook-with-decorative-cover not found] notebook-with-decorative-cover
[emoji open-file-folder not found] open-file-folder
[emoji page-facing-up not found] page-facing-up
paperclip
pencil2
pineapple
postbox
pound
radio
rice
ring
sake
saxophone
seat
shower
snowboarder
[emoji space-invader not found] space-invader
speaker
strawberry
[emoji sweet-potato not found] sweet-potato
tada
tea
tennis
tophat
[emoji tropical-drink not found] tropical-drink
unlock
[emoji video-game not found] video-game
watermelon
[emoji womans-hat not found] womans-hat

dolls
flags
[emoji wind-chime not found] wind-chime
ghost
[emoji alarm-clock not found] alarm-clock
[emoji baby-bottle not found] baby-bottle
[emoji bar-chart not found] bar-chart
bath
beer
bento
birthday
[emoji blue-book not found] blue-book
[emoji bookmark-tabs not found] bookmark-tabs
bowling
bulb
calling
[emoji card-index not found] card-index
[emoji chart-with-upwards-trend not found] chart-with-upwards-trend
[emoji christmas-tree not found] christmas-tree
[emoji closed-book not found] closed-book
clubs
computer
corn
[emoji crystal-ball not found] crystal-ball
dango
diamonds
doughnut
e-mail
[emoji electric-plug not found] electric-plug
eyeglasses
[emoji fish-cake not found] fish-cake
[emoji floppy-disk not found] floppy-disk
[emoji fork-and-knife not found] fork-and-knife
[emoji game-die not found] game-die
golf
[emoji green-book not found] green-book
hamburger
headphones
[emoji high-heel not found] high-heel
[emoji horse-racing not found] horse-racing
[emoji ice-cream not found] ice-cream
[emoji incoming-envelope not found] incoming-envelope
key
lemon
[emoji lock-with-ink-pen not found] lock-with-ink-pen
loudspeaker
[emoji mag-right not found] mag-right
[emoji mailbox-closed not found] mailbox-closed
[emoji mans-shoe not found] mans-shoe
melon
microscope
moneybag
[emoji musical-keyboard not found] musical-keyboard
[emoji name-badge not found] name-badge
[emoji no-bell not found] no-bell
[emoji nut-and-bolt not found] nut-and-bolt
[emoji orange-book not found] orange-book
[emoji page-with-curl not found] page-with-curl
peach
phone
pizza
pouch
purse
ramen
[emoji rice-ball not found] rice-ball
[emoji rugby-football not found] rugby-football
sandal
scissors
[emoji shaved-ice not found] shaved-ice
ski
soccer
spades
stew
surfer
swimmer
[emoji tanabata-tree not found] tanabata-tree
[emoji telephone-receiver not found] telephone-receiver
toilet
[emoji triangular-ruler not found] triangular-ruler
trumpet
vhs
violin
[emoji wine-glass not found] wine-glass
wrench

Places

[emoji aerial-tramway not found] aerial-tramway
anchor
bank
bike
[emoji bridge-at-night not found] bridge-at-night
bus
[emoji carousel-horse not found] carousel-horse
[emoji circus-tent not found] circus-tent
construction
[emoji department-store not found] department-store
factory
fountain
hospital
house
[emoji japanese-castle not found] japanese-castle
minibus
[emoji mountain-cableway not found] mountain-cableway
office
[emoji oncoming-police-car not found] oncoming-police-car
[emoji police-car not found] police-car
rainbow
[emoji rotating-light not found] rotating-light
school
speedboat
[emoji statue-of-liberty not found] statue-of-liberty
[emoji sunrise-over-mountains not found] sunrise-over-mountains
tent
tractor
tram
truck
wedding
[emoji cn not found] cn
[emoji es not found] es
[emoji gb not found] gb

airplane
[emoji articulated-lorry not found] articulated-lorry
barber
[emoji blue-car not found] blue-car
[emoji bullettrain-front not found] bullettrain-front
busstop
[emoji checkered-flag not found] checkered-flag
[emoji city-sunrise not found] city-sunrise
[emoji convenience-store not found] convenience-store
[emoji european-castle not found] european-castle
[emoji ferris-wheel not found] ferris-wheel
fuelpump
hotel
[emoji house-with-garden not found] house-with-garden
[emoji light-rail not found] light-rail
monorail
[emoji mountain-railway not found] mountain-railway
[emoji oncoming-automobile not found] oncoming-automobile
[emoji oncoming-taxi not found] oncoming-taxi
[emoji post-office not found] post-office
rocket
[emoji round-pushpin not found] round-pushpin
ship
stars
[emoji steam-locomotive not found] steam-locomotive
[emoji suspension-railway not found] suspension-railway
ticket
[emoji traffic-light not found] traffic-light
[emoji triangular-flag-on-post not found] triangular-flag-on-post
[emoji vertical-traffic-light not found] vertical-traffic-light
[emoji jp not found] jp
[emoji us not found] us
[emoji it not found] it
[emoji de not found] de

ambulance
atm
beginner
boat
[emoji bullettrain-side not found] bullettrain-side
car
church
[emoji city-sunset not found] city-sunset
[emoji crossed-flags not found] crossed-flags
[emoji european-post-office not found] european-post-office
[emoji fire-engine not found] fire-engine
helicopter
hotsprings
japan
[emoji love-hotel not found] love-hotel
[emoji mount-fuji not found] mount-fuji
moyai
[emoji oncoming-bus not found] oncoming-bus
[emoji performing-arts not found] performing-arts
[emoji railway-car not found] railway-car
[emoji roller-coaster not found] roller-coaster
rowboat
[emoji slot-machine not found] slot-machine
station
sunrise
taxi
[emoji tokyo-tower not found] tokyo-tower
train2
trolleybus
warning
[emoji kr not found] kr
[emoji fr not found] fr
[emoji ru not found] ru

Symbols

100
ab
accept
[emoji arrow-backward not found] arrow-backward
[emoji arrow-down not found] arrow-down
[emoji arrow-heading-down not found] arrow-heading-down
[emoji arrow-lower-left not found] arrow-lower-left
[emoji arrow-right-hook not found] arrow-right-hook
[emoji arrow-up-small not found] arrow-up-small
[emoji arrows-clockwise not found] arrows-clockwise
[emoji baby-symbol not found] baby-symbol
[emoji bangbang not found] bangbang
cancer
chart
cl
clock1030
clock12
clock2
clock330
clock5
clock630
clock8
clock930
copyright
customs
eight
end
four
hash
[emoji heavy-division-sign not found] heavy-division-sign
[emoji heavy-multiplication-x not found] heavy-multiplication-x
[emoji ideograph-advantage not found] ideograph-advantage
[emoji keycap-ten not found] keycap-ten
[emoji large-blue-diamond not found] large-blue-diamond
[emoji left-right-arrow not found] left-right-arrow
libra
mens
[emoji negative-squared-cross-mark not found] negative-squared-cross-mark
nine
[emoji no-entry-sign not found] no-entry-sign
[emoji no-smoking not found] no-smoking
[emoji o2 not found] o2
one
[emoji part-alternation-mark not found] part-alternation-mark
[emoji potable-water not found] potable-water
recycle
repeat
rewind
scorpius
[emoji signal-strength not found] signal-strength
[emoji small-blue-diamond not found] small-blue-diamond
[emoji small-red-triangle-down not found] small-red-triangle-down
symbols
[emoji tm not found] tm
[emoji twisted-rightwards-arrows not found] twisted-rightwards-arrows
[emoji u5408 not found] u5408
[emoji u6708 not found] u6708
[emoji u7121 not found] u7121
[emoji u7a7a not found] u7a7a
[emoji vibration-mode not found] vibration-mode
[emoji wavy-dash not found] wavy-dash
[emoji white-check-mark not found] white-check-mark
[emoji white-square-button not found] white-square-button
zero

1234
abc
aquarius
[emoji arrow-double-down not found] arrow-double-down
[emoji arrow-down-small not found] arrow-down-small
[emoji arrow-heading-up not found] arrow-heading-up
[emoji arrow-lower-right not found] arrow-lower-right
[emoji arrow-up not found] arrow-up
[emoji arrow-upper-left not found] arrow-upper-left
[emoji arrows-counterclockwise not found] arrows-counterclockwise
[emoji baggage-claim not found] baggage-claim
[emoji black-circle not found] black-circle
[emoji capital-abcd not found] capital-abcd
[emoji children-crossing not found] children-crossing
clock1
clock11
clock1230
clock230
clock4
clock530
clock7
clock830
congratulations
[emoji curly-loop not found] curly-loop
[emoji diamond-shape-with-a-dot-inside not found] diamond-shape-with-a-dot-inside
[emoji eight-pointed-black-star not found] eight-pointed-black-star
[emoji fast-forward not found] fast-forward
free
[emoji heart-decoration not found] heart-decoration
[emoji heavy-dollar-sign not found] heavy-dollar-sign
[emoji heavy-plus-sign not found] heavy-plus-sign
[emoji information-source not found] information-source
koko
[emoji large-orange-diamond not found] large-orange-diamond
[emoji leftwards-arrow-with-hook not found] leftwards-arrow-with-hook
link
metro
new
[emoji no-bicycles not found] no-bicycles
[emoji no-mobile-phones not found] no-mobile-phones
[emoji non-potable-water not found] non-potable-water
ok
ophiuchus
[emoji passport-control not found] passport-control
[emoji put-litter-in-its-place not found] put-litter-in-its-place
[emoji red-circle not found] red-circle
[emoji repeat-one not found] repeat-one
sa
secret
six
[emoji small-orange-diamond not found] small-orange-diamond
soon
taurus
top
two
[emoji u55b6 not found] u55b6
[emoji u6709 not found] u6709
[emoji u7533 not found] u7533
underage
virgo
wc
[emoji white-circle not found] white-circle
womens

a
abcd
aries
[emoji arrow-double-up not found] arrow-double-up
[emoji arrow-forward not found] arrow-forward
[emoji arrow-left not found] arrow-left
[emoji arrow-right not found] arrow-right
[emoji arrow-up-down not found] arrow-up-down
[emoji arrow-upper-right not found] arrow-upper-right
b
[emoji ballot-box-with-check not found] ballot-box-with-check
[emoji black-square-button not found] black-square-button
capricorn
cinema
clock10
clock1130
clock130
clock3
clock430
clock6
clock730
clock9
cool
[emoji currency-exchange not found] currency-exchange
[emoji do-not-litter not found] do-not-litter
[emoji eight-spoked-asterisk not found] eight-spoked-asterisk
five
gemini
[emoji heavy-check-mark not found] heavy-check-mark
[emoji heavy-minus-sign not found] heavy-minus-sign
id
interrobang
[emoji large-blue-circle not found] large-blue-circle
left-luggage
leo
m
[emoji mobile-phone-off not found] mobile-phone-off
ng
[emoji no-entry not found] no-entry
[emoji no-pedestrians not found] no-pedestrians
o
on
parking
pisces
radio-button
[emoji registered not found] registered
restroom
sagittarius
seven
[emoji six-pointed-star not found] six-pointed-star
[emoji small-red-triangle not found] small-red-triangle
sos
three
trident
[emoji u5272 not found] u5272
[emoji u6307 not found] u6307
[emoji u6e80 not found] u6e80
[emoji u7981 not found] u7981
up
vs
wheelchair
[emoji white-flower not found] white-flower
x