diff --git a/content/posts/emoji-support.md b/content/posts/emoji-support.md deleted file mode 100644 index d68dbbc..0000000 --- a/content/posts/emoji-support.md +++ /dev/null @@ -1,1273 +0,0 @@ ---- -title: "Emoji Support" -date: 2020-10-01T17:55:28+08:00 -description: "Guide to emoji usage in Hugo and DoIt." -tags: ["emoji"] -type: post -weight: 25 -showTableOfContents: true ---- - -Emoji can be enabled in a Hugo project in a number of ways. - -The [`emojify`](https://gohugo.io/functions/emojify/) function can be called directly in templates or [Inline Shortcodes](https://gohugo.io/templates/shortcode-templates#inline-shortcodes). - -To enable emoji globally, set `enableEmoji` to `true` in your [site configuration](https://gohugo.io/getting-started/configuration/) and then you can type emoji shorthand codes directly in content files. - -These begin and end with a **colon** and include the **code** of an emoji: - -```markdown -Gone camping! {?:}tent: Be back soon. - -That is so funny! {?:}joy: -``` - -The rendered output looks like this: - -Gone camping! :tent: Be back soon. - -That is so funny! :joy: - -The following **cheat sheet** is a useful reference for emoji shorthand codes. - -## Smileys & Emotion - -### Face Smiling - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :grinning: | grinning | :smiley: | smiley | -| :smile: | smile | :grin: | grin | -| :laughing: | laughing
satisfied | :sweat_smile: | sweat_smile | -| :rofl: | rofl | :joy: | joy | -| :slightly_smiling_face: | slightly_smiling_face | :upside_down_face: | upside_down_face | -| :wink: | wink | :blush: | blush | -| :innocent: | innocent | | | - -### Face Affection - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :heart_eyes: | heart_eyes | :kissing_heart: | kissing_heart | -| :kissing: | kissing | :relaxed: | relaxed | -| :kissing_closed_eyes: | kissing_closed_eyes | :kissing_smiling_eyes: | kissing_smiling_eyes | - -### Face Tongue - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :yum: | yum | :stuck_out_tongue: | stuck_out_tongue | -| :stuck_out_tongue_winking_eye: | stuck_out_tongue_winking_eye | :stuck_out_tongue_closed_eyes: | stuck_out_tongue_closed_eyes | -| :money_mouth_face: | money_mouth_face | | | - -### Face Hand - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :hugs: | hugs | :thinking: | thinking | - -### Face Neutral Skeptical - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :zipper_mouth_face: | zipper_mouth_face | :neutral_face: | neutral_face | -| :expressionless: | expressionless | :no_mouth: | no_mouth | -| :smirk: | smirk | :unamused: | unamused | -| :roll_eyes: | roll_eyes | :grimacing: | grimacing | -| :lying_face: | lying_face | | | - -### Face Sleepy - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :relieved: | relieved | :pensive: | pensive | -| :sleepy: | sleepy | :drooling_face: | drooling_face | -| :sleeping: | sleeping | | | - -### Face Unwell - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :mask: | mask | :face_with_thermometer: | face_with_thermometer | -| :face_with_head_bandage: | face_with_head_bandage | :nauseated_face: | nauseated_face | -| :sneezing_face: | sneezing_face | :dizzy_face: | dizzy_face | - -### Face Hat - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :cowboy_hat_face: | cowboy_hat_face | | | - -### Face Glasses - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :sunglasses: | sunglasses | :nerd_face: | nerd_face | - -### Face Concerned - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :confused: | confused | :worried: | worried | -| :slightly_frowning_face: | slightly_frowning_face | :frowning_face: | frowning_face | -| :open_mouth: | open_mouth | :hushed: | hushed | -| :astonished: | astonished | :flushed: | flushed | -| :frowning: | frowning | :anguished: | anguished | -| :fearful: | fearful | :cold_sweat: | cold_sweat | -| :disappointed_relieved: | disappointed_relieved | :cry: | cry | -| :sob: | sob | :scream: | scream | -| :confounded: | confounded | :persevere: | persevere | -| :disappointed: | disappointed | :sweat: | sweat | -| :weary: | weary | :tired_face: | tired_face | - -### Face Negative - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :triumph: | triumph | :pout: | pout
rage | -| :angry: | angry | :smiling_imp: | smiling_imp | -| :imp: | imp | :skull: | skull | -| :skull_and_crossbones: | skull_and_crossbones | | | - -### Face Costume - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :hankey: | hankey
poop
shit | :clown_face: | clown_face | -| :japanese_ogre: | japanese_ogre | :japanese_goblin: | japanese_goblin | -| :ghost: | ghost | :alien: | alien | -| :space_invader: | space_invader | :robot: | robot | - -### Cat Face - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :smiley_cat: | smiley_cat | :smile_cat: | smile_cat | -| :joy_cat: | joy_cat | :heart_eyes_cat: | heart_eyes_cat | -| :smirk_cat: | smirk_cat | :kissing_cat: | kissing_cat | -| :scream_cat: | scream_cat | :crying_cat_face: | crying_cat_face | -| :pouting_cat: | pouting_cat | | | - -### Monkey Face - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :see_no_evil: | see_no_evil | :hear_no_evil: | hear_no_evil | -| :speak_no_evil: | speak_no_evil | | | - -### Emotion - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :kiss: | kiss | :love_letter: | love_letter | -| :cupid: | cupid | :gift_heart: | gift_heart | -| :sparkling_heart: | sparkling_heart | :heartpulse: | heartpulse | -| :heartbeat: | heartbeat | :revolving_hearts: | revolving_hearts | -| :two_hearts: | two_hearts | :heart_decoration: | heart_decoration | -| :heavy_heart_exclamation: | heavy_heart_exclamation | :broken_heart: | broken_heart | -| :heart: | heart | :yellow_heart: | yellow_heart | -| :green_heart: | green_heart | :blue_heart: | blue_heart | -| :purple_heart: | purple_heart | :black_heart: | black_heart | -| :100: | 100 | :anger: | anger | -| :boom: | boom
collision | :dizzy: | dizzy | -| :sweat_drops: | sweat_drops | :dash: | dash | -| :hole: | hole | :bomb: | bomb | -| :speech_balloon: | speech_balloon | :eye_speech_bubble: | eye_speech_bubble | -| :right_anger_bubble: | right_anger_bubble | :thought_balloon: | thought_balloon | -| :zzz: | zzz | | | - -## People & Body - -### Hand Fingers Open - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :wave: | wave | :raised_back_of_hand: | raised_back_of_hand | -| :raised_hand_with_fingers_splayed: | raised_hand_with_fingers_splayed | :hand: | hand
raised_hand | -| :vulcan_salute: | vulcan_salute | | | - -### Hand Fingers Partial - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :ok_hand: | ok_hand | :v: | v | -| :crossed_fingers: | crossed_fingers | :metal: | metal | -| :call_me_hand: | call_me_hand | | | - -### Hand Single Finger - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :point_left: | point_left | :point_right: | point_right | -| :point_up_2: | point_up_2 | :fu: | fu
middle_finger | -| :point_down: | point_down | :point_up: | point_up | - -### Hand Fingers Closed - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :+1: | +1
thumbsup | :-1: | -1
thumbsdown | -| :fist: | fist
fist_raised | :facepunch: | facepunch
fist_oncoming
punch | -| :fist_left: | fist_left | :fist_right: | fist_right | - -### Hands - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :clap: | clap | :raised_hands: | raised_hands | -| :open_hands: | open_hands | :handshake: | handshake | -| :pray: | pray | | | - -### Hand Prop - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :writing_hand: | writing_hand | :nail_care: | nail_care | -| :selfie: | selfie | | | - -### Body Parts - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :muscle: | muscle | :ear: | ear | -| :nose: | nose | :eyes: | eyes | -| :eye: | eye | :tongue: | tongue | -| :lips: | lips | | | - -### Person - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :baby: | baby | :boy: | boy | -| :girl: | girl | :blonde_man: | blonde_man
person_with_blond_hair | -| :man: | man | :woman: | woman | -| :blonde_woman: | blonde_woman | :older_man: | older_man | -| :older_woman: | older_woman | | | - -### Person Gesture - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :frowning_woman: | frowning_woman
person_frowning | :frowning_man: | frowning_man | -| :person_with_pouting_face: | person_with_pouting_face
pouting_woman | :pouting_man: | pouting_man | -| :ng_woman: | ng_woman
no_good
no_good_woman | :ng_man: | ng_man
no_good_man | -| :ok_woman: | ok_woman | :ok_man: | ok_man | -| :information_desk_person: | information_desk_person
sassy_woman
tipping_hand_woman | :sassy_man: | sassy_man
tipping_hand_man | -| :raising_hand: | raising_hand
raising_hand_woman | :raising_hand_man: | raising_hand_man | -| :bow: | bow
bowing_man | :bowing_woman: | bowing_woman | -| :man_facepalming: | man_facepalming | :woman_facepalming: | woman_facepalming | -| :man_shrugging: | man_shrugging | :woman_shrugging: | woman_shrugging | - -### Person Role - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :man_health_worker: | man_health_worker | :woman_health_worker: | woman_health_worker | -| :man_student: | man_student | :woman_student: | woman_student | -| :man_teacher: | man_teacher | :woman_teacher: | woman_teacher | -| :man_judge: | man_judge | :woman_judge: | woman_judge | -| :man_farmer: | man_farmer | :woman_farmer: | woman_farmer | -| :man_cook: | man_cook | :woman_cook: | woman_cook | -| :man_mechanic: | man_mechanic | :woman_mechanic: | woman_mechanic | -| :man_factory_worker: | man_factory_worker | :woman_factory_worker: | woman_factory_worker | -| :man_office_worker: | man_office_worker | :woman_office_worker: | woman_office_worker | -| :man_scientist: | man_scientist | :woman_scientist: | woman_scientist | -| :man_technologist: | man_technologist | :woman_technologist: | woman_technologist | -| :man_singer: | man_singer | :woman_singer: | woman_singer | -| :man_artist: | man_artist | :woman_artist: | woman_artist | -| :man_pilot: | man_pilot | :woman_pilot: | woman_pilot | -| :man_astronaut: | man_astronaut | :woman_astronaut: | woman_astronaut | -| :man_firefighter: | man_firefighter | :woman_firefighter: | woman_firefighter | -| :cop: | cop
policeman | :policewoman: | policewoman | -| :detective: | detective
male_detective | :female_detective: | female_detective | -| :guardsman: | guardsman | :guardswoman: | guardswoman | -| :construction_worker: | construction_worker
construction_worker_man | :construction_worker_woman: | construction_worker_woman | -| :prince: | prince | :princess: | princess | -| :man_with_turban: | man_with_turban | :woman_with_turban: | woman_with_turban | -| :man_with_gua_pi_mao: | man_with_gua_pi_mao | :man_in_tuxedo: | man_in_tuxedo | -| :bride_with_veil: | bride_with_veil | :pregnant_woman: | pregnant_woman | - -### Person Fantasy - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :angel: | angel | :santa: | santa | -| :mrs_claus: | mrs_claus | | | - -### Person Activity - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :massage: | massage
massage_woman | :massage_man: | massage_man | -| :haircut: | haircut
haircut_woman | :haircut_man: | haircut_man | -| :walking: | walking
walking_man | :walking_woman: | walking_woman | -| :runner: | runner
running
running_man | :running_woman: | running_woman | -| :dancer: | dancer | :man_dancing: | man_dancing | -| :business_suit_levitating: | business_suit_levitating | :dancers: | dancers
dancing_women | -| :dancing_men: | dancing_men | | | - -### Person Sport - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :person_fencing: | person_fencing | :horse_racing: | horse_racing | -| :skier: | skier | :snowboarder: | snowboarder | -| :golfing_man: | golfing_man | :golfing_woman: | golfing_woman | -| :surfer: | surfer
surfing_man | :surfing_woman: | surfing_woman | -| :rowboat: | rowboat
rowing_man | :rowing_woman: | rowing_woman | -| :swimmer: | swimmer
swimming_man | :swimming_woman: | swimming_woman | -| :basketball_man: | basketball_man | :basketball_woman: | basketball_woman | -| :weight_lifting_man: | weight_lifting_man | :weight_lifting_woman: | weight_lifting_woman | -| :bicyclist: | bicyclist
biking_man | :biking_woman: | biking_woman | -| :mountain_bicyclist: | mountain_bicyclist
mountain_biking_man | :mountain_biking_woman: | mountain_biking_woman | -| :man_cartwheeling: | man_cartwheeling | :woman_cartwheeling: | woman_cartwheeling | -| :men_wrestling: | men_wrestling | :women_wrestling: | women_wrestling | -| :man_playing_water_polo: | man_playing_water_polo | :woman_playing_water_polo: | woman_playing_water_polo | -| :man_playing_handball: | man_playing_handball | :woman_playing_handball: | woman_playing_handball | -| :man_juggling: | man_juggling | :woman_juggling: | woman_juggling | - -### Person Resting - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :bath: | bath | :sleeping_bed: | sleeping_bed | - -### Family - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :two_women_holding_hands: | two_women_holding_hands | :couple: | couple | -| :two_men_holding_hands: | two_men_holding_hands | :couplekiss_man_woman: | couplekiss_man_woman | -| :couplekiss_man_man: | couplekiss_man_man | :couplekiss_woman_woman: | couplekiss_woman_woman | -| :couple_with_heart: | couple_with_heart
couple_with_heart_woman_man | :couple_with_heart_man_man: | couple_with_heart_man_man | -| :couple_with_heart_woman_woman: | couple_with_heart_woman_woman | :family: | family
family_man_woman_boy | -| :family_man_woman_girl: | family_man_woman_girl | :family_man_woman_girl_boy: | family_man_woman_girl_boy | -| :family_man_woman_boy_boy: | family_man_woman_boy_boy | :family_man_woman_girl_girl: | family_man_woman_girl_girl | -| :family_man_man_boy: | family_man_man_boy | :family_man_man_girl: | family_man_man_girl | -| :family_man_man_girl_boy: | family_man_man_girl_boy | :family_man_man_boy_boy: | family_man_man_boy_boy | -| :family_man_man_girl_girl: | family_man_man_girl_girl | :family_woman_woman_boy: | family_woman_woman_boy | -| :family_woman_woman_girl: | family_woman_woman_girl | :family_woman_woman_girl_boy: | family_woman_woman_girl_boy | -| :family_woman_woman_boy_boy: | family_woman_woman_boy_boy | :family_woman_woman_girl_girl: | family_woman_woman_girl_girl | -| :family_man_boy: | family_man_boy | :family_man_boy_boy: | family_man_boy_boy | -| :family_man_girl: | family_man_girl | :family_man_girl_boy: | family_man_girl_boy | -| :family_man_girl_girl: | family_man_girl_girl | :family_woman_boy: | family_woman_boy | -| :family_woman_boy_boy: | family_woman_boy_boy | :family_woman_girl: | family_woman_girl | -| :family_woman_girl_boy: | family_woman_girl_boy | :family_woman_girl_girl: | family_woman_girl_girl | - -### Person Symbol - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :speaking_head: | speaking_head | :bust_in_silhouette: | bust_in_silhouette | -| :busts_in_silhouette: | busts_in_silhouette | :footprints: | footprints | - -## Animals & Nature - -### Animal Mammal - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :monkey_face: | monkey_face | :monkey: | monkey | -| :gorilla: | gorilla | :dog: | dog | -| :dog2: | dog2 | :poodle: | poodle | -| :wolf: | wolf | :fox_face: | fox_face | -| :cat: | cat | :cat2: | cat2 | -| :lion: | lion | :tiger: | tiger | -| :tiger2: | tiger2 | :leopard: | leopard | -| :horse: | horse | :racehorse: | racehorse | -| :unicorn: | unicorn | :deer: | deer | -| :cow: | cow | :ox: | ox | -| :water_buffalo: | water_buffalo | :cow2: | cow2 | -| :pig: | pig | :pig2: | pig2 | -| :boar: | boar | :pig_nose: | pig_nose | -| :ram: | ram | :sheep: | sheep | -| :goat: | goat | :dromedary_camel: | dromedary_camel | -| :camel: | camel | :elephant: | elephant | -| :rhinoceros: | rhinoceros | :mouse: | mouse | -| :mouse2: | mouse2 | :rat: | rat | -| :hamster: | hamster | :rabbit: | rabbit | -| :rabbit2: | rabbit2 | :chipmunk: | chipmunk | -| :bat: | bat | :bear: | bear | -| :koala: | koala | :panda_face: | panda_face | -| :feet: | feet
paw_prints | | | - -### Animal Bird - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :turkey: | turkey | :chicken: | chicken | -| :rooster: | rooster | :hatching_chick: | hatching_chick | -| :baby_chick: | baby_chick | :hatched_chick: | hatched_chick | -| :bird: | bird | :penguin: | penguin | -| :dove: | dove | :eagle: | eagle | -| :duck: | duck | :owl: | owl | - -### Animal Amphibian - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :frog: | frog | - -### Animal Reptile - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :crocodile: | crocodile | :turtle: | turtle | -| :lizard: | lizard | :snake: | snake | -| :dragon_face: | dragon_face | :dragon: | dragon | - -### Animal Marine - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :whale: | whale | :whale2: | whale2 | -| :dolphin: | dolphin
flipper | :fish: | fish | -| :tropical_fish: | tropical_fish | :blowfish: | blowfish | -| :shark: | shark | :octopus: | octopus | -| :shell: | shell | | | - -### Animal Bug - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :snail: | snail | :butterfly: | butterfly | -| :bug: | bug | :ant: | ant | -| :bee: | bee
honeybee | :beetle: | beetle | -| :spider: | spider | :spider_web: | spider_web | -| :scorpion: | scorpion | | | - -### Plant Flower - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :bouquet: | bouquet | :cherry_blossom: | cherry_blossom | -| :white_flower: | white_flower | :rosette: | rosette | -| :rose: | rose | :wilted_flower: | wilted_flower | -| :hibiscus: | hibiscus | :sunflower: | sunflower | -| :blossom: | blossom | :tulip: | tulip | - -### Plant Other - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :seedling: | seedling | :evergreen_tree: | evergreen_tree | -| :deciduous_tree: | deciduous_tree | :palm_tree: | palm_tree | -| :cactus: | cactus | :ear_of_rice: | ear_of_rice | -| :herb: | herb | :shamrock: | shamrock | -| :four_leaf_clover: | four_leaf_clover | :maple_leaf: | maple_leaf | -| :fallen_leaf: | fallen_leaf | :leaves: | leaves | - -## Food & Drink - -### Food Fruit - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :grapes: | grapes | :melon: | melon | -| :watermelon: | watermelon | :mandarin: | mandarin
orange
tangerine | -| :lemon: | lemon | :banana: | banana | -| :pineapple: | pineapple | :apple: | apple | -| :green_apple: | green_apple | :pear: | pear | -| :peach: | peach | :cherries: | cherries | -| :strawberry: | strawberry | :kiwi_fruit: | kiwi_fruit | -| :tomato: | tomato | | | - -### Food Vegetable - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :avocado: | avocado | :eggplant: | eggplant | -| :potato: | potato | :carrot: | carrot | -| :corn: | corn | :hot_pepper: | hot_pepper | -| :cucumber: | cucumber | :mushroom: | mushroom | -| :peanuts: | peanuts | :chestnut: | chestnut | - -### Food Prepared - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :bread: | bread | :croissant: | croissant | -| :baguette_bread: | baguette_bread | :pancakes: | pancakes | -| :cheese: | cheese | :meat_on_bone: | meat_on_bone | -| :poultry_leg: | poultry_leg | :bacon: | bacon | -| :hamburger: | hamburger | :fries: | fries | -| :pizza: | pizza | :hotdog: | hotdog | -| :taco: | taco | :burrito: | burrito | -| :stuffed_flatbread: | stuffed_flatbread | :egg: | egg | -| :fried_egg: | fried_egg | :shallow_pan_of_food: | shallow_pan_of_food | -| :stew: | stew | :green_salad: | green_salad | -| :popcorn: | popcorn | | | - -### Food Asian - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :bento: | bento | :rice_cracker: | rice_cracker | -| :rice_ball: | rice_ball | :rice: | rice | -| :curry: | curry | :ramen: | ramen | -| :spaghetti: | spaghetti | :sweet_potato: | sweet_potato | -| :oden: | oden | :sushi: | sushi | -| :fried_shrimp: | fried_shrimp | :fish_cake: | fish_cake | -| :dango: | dango | | | - -### Food Marine - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :crab: | crab | :shrimp: | shrimp | -| :squid: | squid | | | - -### Food Sweet - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :icecream: | icecream | :shaved_ice: | shaved_ice | -| :ice_cream: | ice_cream | :doughnut: | doughnut | -| :cookie: | cookie | :birthday: | birthday | -| :cake: | cake | :chocolate_bar: | chocolate_bar | -| :candy: | candy | :lollipop: | lollipop | -| :custard: | custard | :honey_pot: | honey_pot | - -### Drink - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :baby_bottle: | baby_bottle | :milk_glass: | milk_glass | -| :coffee: | coffee | :tea: | tea | -| :sake: | sake | :champagne: | champagne | -| :wine_glass: | wine_glass | :cocktail: | cocktail | -| :tropical_drink: | tropical_drink | :beer: | beer | -| :beers: | beers | :clinking_glasses: | clinking_glasses | -| :tumbler_glass: | tumbler_glass | | | - -### Dishware - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :plate_with_cutlery: | plate_with_cutlery | :fork_and_knife: | fork_and_knife | -| :spoon: | spoon | :hocho: | hocho
knife | -| :amphora: | amphora | | | - -## Travel & Places - -### Place Map - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :earth_africa: | earth_africa | :earth_americas: | earth_americas | -| :earth_asia: | earth_asia | :globe_with_meridians: | globe_with_meridians | -| :world_map: | world_map | :japan: | japan | - -### Place Geographic - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :mountain_snow: | mountain_snow | :mountain: | mountain | -| :volcano: | volcano | :mount_fuji: | mount_fuji | -| :camping: | camping | :beach_umbrella: | beach_umbrella | -| :desert: | desert | :desert_island: | desert_island | -| :national_park: | national_park | | | - -### Place Building - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :stadium: | stadium | :classical_building: | classical_building | -| :building_construction: | building_construction | :houses: | houses | -| :derelict_house: | derelict_house | :house: | house | -| :house_with_garden: | house_with_garden | :office: | office | -| :post_office: | post_office | :european_post_office: | european_post_office | -| :hospital: | hospital | :bank: | bank | -| :hotel: | hotel | :love_hotel: | love_hotel | -| :convenience_store: | convenience_store | :school: | school | -| :department_store: | department_store | :factory: | factory | -| :japanese_castle: | japanese_castle | :european_castle: | european_castle | -| :wedding: | wedding | :tokyo_tower: | tokyo_tower | -| :statue_of_liberty: | statue_of_liberty | | | - -### Place Religious - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :church: | church | :mosque: | mosque | -| :synagogue: | synagogue | :shinto_shrine: | shinto_shrine | -| :kaaba: | kaaba | | | - -### Place Other - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :fountain: | fountain | :tent: | tent | -| :foggy: | foggy | :night_with_stars: | night_with_stars | -| :cityscape: | cityscape | :sunrise_over_mountains: | sunrise_over_mountains | -| :sunrise: | sunrise | :city_sunset: | city_sunset | -| :city_sunrise: | city_sunrise | :bridge_at_night: | bridge_at_night | -| :hotsprings: | hotsprings | :carousel_horse: | carousel_horse | -| :ferris_wheel: | ferris_wheel | :roller_coaster: | roller_coaster | -| :barber: | barber | :circus_tent: | circus_tent | - -### Transport Ground - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :steam_locomotive: | steam_locomotive | :railway_car: | railway_car | -| :bullettrain_side: | bullettrain_side | :bullettrain_front: | bullettrain_front | -| :train2: | train2 | :metro: | metro | -| :light_rail: | light_rail | :station: | station | -| :tram: | tram | :monorail: | monorail | -| :mountain_railway: | mountain_railway | :train: | train | -| :bus: | bus | :oncoming_bus: | oncoming_bus | -| :trolleybus: | trolleybus | :minibus: | minibus | -| :ambulance: | ambulance | :fire_engine: | fire_engine | -| :police_car: | police_car | :oncoming_police_car: | oncoming_police_car | -| :taxi: | taxi | :oncoming_taxi: | oncoming_taxi | -| :car: | car
red_car | :oncoming_automobile: | oncoming_automobile | -| :blue_car: | blue_car | :truck: | truck | -| :articulated_lorry: | articulated_lorry | :tractor: | tractor | -| :racing_car: | racing_car | :motorcycle: | motorcycle | -| :motor_scooter: | motor_scooter | :bike: | bike | -| :kick_scooter: | kick_scooter | :busstop: | busstop | -| :motorway: | motorway | :railway_track: | railway_track | -| :oil_drum: | oil_drum | :fuelpump: | fuelpump | -| :rotating_light: | rotating_light | :traffic_light: | traffic_light | -| :vertical_traffic_light: | vertical_traffic_light | :stop_sign: | stop_sign | -| :construction: | construction | | | - -### Transport Water - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :anchor: | anchor | :boat: | boat
sailboat | -| :canoe: | canoe | :speedboat: | speedboat | -| :passenger_ship: | passenger_ship | :ferry: | ferry | -| :motor_boat: | motor_boat | :ship: | ship | - -### Transport Air - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :airplane: | airplane | :small_airplane: | small_airplane | -| :flight_departure: | flight_departure | :flight_arrival: | flight_arrival | -| :seat: | seat | :helicopter: | helicopter | -| :suspension_railway: | suspension_railway | :mountain_cableway: | mountain_cableway | -| :aerial_tramway: | aerial_tramway | :artificial_satellite: | artificial_satellite | -| :rocket: | rocket | | | - -### Hotel - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :bellhop_bell: | bellhop_bell | - -### Time - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :hourglass: | hourglass | :hourglass_flowing_sand: | hourglass_flowing_sand | -| :watch: | watch | :alarm_clock: | alarm_clock | -| :stopwatch: | stopwatch | :timer_clock: | timer_clock | -| :mantelpiece_clock: | mantelpiece_clock | :clock12: | clock12 | -| :clock1230: | clock1230 | :clock1: | clock1 | -| :clock130: | clock130 | :clock2: | clock2 | -| :clock230: | clock230 | :clock3: | clock3 | -| :clock330: | clock330 | :clock4: | clock4 | -| :clock430: | clock430 | :clock5: | clock5 | -| :clock530: | clock530 | :clock6: | clock6 | -| :clock630: | clock630 | :clock7: | clock7 | -| :clock730: | clock730 | :clock8: | clock8 | -| :clock830: | clock830 | :clock9: | clock9 | -| :clock930: | clock930 | :clock10: | clock10 | -| :clock1030: | clock1030 | :clock11: | clock11 | -| :clock1130: | clock1130 | | | - -### Sky & Weather - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :new_moon: | new_moon | :waxing_crescent_moon: | waxing_crescent_moon | -| :first_quarter_moon: | first_quarter_moon | :moon: | moon
waxing_gibbous_moon | -| :full_moon: | full_moon | :waning_gibbous_moon: | waning_gibbous_moon | -| :last_quarter_moon: | last_quarter_moon | :waning_crescent_moon: | waning_crescent_moon | -| :crescent_moon: | crescent_moon | :new_moon_with_face: | new_moon_with_face | -| :first_quarter_moon_with_face: | first_quarter_moon_with_face | :last_quarter_moon_with_face: | last_quarter_moon_with_face | -| :thermometer: | thermometer | :sunny: | sunny | -| :full_moon_with_face: | full_moon_with_face | :sun_with_face: | sun_with_face | -| :star: | star | :star2: | star2 | -| :stars: | stars | :milky_way: | milky_way | -| :cloud: | cloud | :partly_sunny: | partly_sunny | -| :cloud_with_lightning_and_rain: | cloud_with_lightning_and_rain | :sun_behind_small_cloud: | sun_behind_small_cloud | -| :sun_behind_large_cloud: | sun_behind_large_cloud | :sun_behind_rain_cloud: | sun_behind_rain_cloud | -| :cloud_with_rain: | cloud_with_rain | :cloud_with_snow: | cloud_with_snow | -| :cloud_with_lightning: | cloud_with_lightning | :tornado: | tornado | -| :fog: | fog | :wind_face: | wind_face | -| :cyclone: | cyclone | :rainbow: | rainbow | -| :closed_umbrella: | closed_umbrella | :open_umbrella: | open_umbrella | -| :umbrella: | umbrella | :parasol_on_ground: | parasol_on_ground | -| :zap: | zap | :snowflake: | snowflake | -| :snowman_with_snow: | snowman_with_snow | :snowman: | snowman | -| :comet: | comet | :fire: | fire | -| :droplet: | droplet | :ocean: | ocean | - -## Activities - -### Event - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :jack_o_lantern: | jack_o_lantern | :christmas_tree: | christmas_tree | -| :fireworks: | fireworks | :sparkler: | sparkler | -| :sparkles: | sparkles | :balloon: | balloon | -| :tada: | tada | :confetti_ball: | confetti_ball | -| :tanabata_tree: | tanabata_tree | :bamboo: | bamboo | -| :dolls: | dolls | :flags: | flags | -| :wind_chime: | wind_chime | :rice_scene: | rice_scene | -| :ribbon: | ribbon | :gift: | gift | -| :reminder_ribbon: | reminder_ribbon | :tickets: | tickets | -| :ticket: | ticket | | | - -### Award Medal - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :medal_military: | medal_military | :trophy: | trophy | -| :medal_sports: | medal_sports | :1st_place_medal: | 1st_place_medal | -| :2nd_place_medal: | 2nd_place_medal | :3rd_place_medal: | 3rd_place_medal | - -### Sport - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :soccer: | soccer | :baseball: | baseball | -| :basketball: | basketball | :volleyball: | volleyball | -| :football: | football | :rugby_football: | rugby_football | -| :tennis: | tennis | :bowling: | bowling | -| :cricket: | cricket | :field_hockey: | field_hockey | -| :ice_hockey: | ice_hockey | :ping_pong: | ping_pong | -| :badminton: | badminton | :boxing_glove: | boxing_glove | -| :martial_arts_uniform: | martial_arts_uniform | :goal_net: | goal_net | -| :golf: | golf | :ice_skate: | ice_skate | -| :fishing_pole_and_fish: | fishing_pole_and_fish | :running_shirt_with_sash: | running_shirt_with_sash | -| :ski: | ski | | | - -### Game - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :dart: | dart | :8ball: | 8ball | -| :crystal_ball: | crystal_ball | :video_game: | video_game | -| :joystick: | joystick | :slot_machine: | slot_machine | -| :game_die: | game_die | :spades: | spades | -| :hearts: | hearts | :diamonds: | diamonds | -| :clubs: | clubs | :black_joker: | black_joker | -| :mahjong: | mahjong | :flower_playing_cards: | flower_playing_cards | - -### Arts & Crafts - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :performing_arts: | performing_arts | :framed_picture: | framed_picture | -| :art: | art | | | - -## Objects - -### Clothing - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :eyeglasses: | eyeglasses | :dark_sunglasses: | dark_sunglasses | -| :necktie: | necktie | :shirt: | shirt
tshirt | -| :jeans: | jeans | :dress: | dress | -| :kimono: | kimono | :bikini: | bikini | -| :womans_clothes: | womans_clothes | :purse: | purse | -| :handbag: | handbag | :pouch: | pouch | -| :shopping: | shopping | :school_satchel: | school_satchel | -| :mans_shoe: | mans_shoe
shoe | :athletic_shoe: | athletic_shoe | -| :high_heel: | high_heel | :sandal: | sandal | -| :boot: | boot | :crown: | crown | -| :womans_hat: | womans_hat | :tophat: | tophat | -| :mortar_board: | mortar_board | :rescue_worker_helmet: | rescue_worker_helmet | -| :prayer_beads: | prayer_beads | :lipstick: | lipstick | -| :ring: | ring | :gem: | gem | - -### Sound - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :mute: | mute | :speaker: | speaker | -| :sound: | sound | :loud_sound: | loud_sound | -| :loudspeaker: | loudspeaker | :mega: | mega | -| :postal_horn: | postal_horn | :bell: | bell | -| :no_bell: | no_bell | | | - -### Music - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :musical_score: | musical_score | :musical_note: | musical_note | -| :notes: | notes | :studio_microphone: | studio_microphone | -| :level_slider: | level_slider | :control_knobs: | control_knobs | -| :microphone: | microphone | :headphones: | headphones | -| :radio: | radio | | | - -### Musical Instrument - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :saxophone: | saxophone | :guitar: | guitar | -| :musical_keyboard: | musical_keyboard | :trumpet: | trumpet | -| :violin: | violin | :drum: | drum | - -### Phone - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :iphone: | iphone | :calling: | calling | -| :phone: | phone
telephone | :telephone_receiver: | telephone_receiver | -| :pager: | pager | :fax: | fax | - -### Computer - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :battery: | battery | :electric_plug: | electric_plug | -| :computer: | computer | :desktop_computer: | desktop_computer | -| :printer: | printer | :keyboard: | keyboard | -| :computer_mouse: | computer_mouse | :trackball: | trackball | -| :minidisc: | minidisc | :floppy_disk: | floppy_disk | -| :cd: | cd | :dvd: | dvd | - -### Light & Video - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :movie_camera: | movie_camera | :film_strip: | film_strip | -| :film_projector: | film_projector | :clapper: | clapper | -| :tv: | tv | :camera: | camera | -| :camera_flash: | camera_flash | :video_camera: | video_camera | -| :vhs: | vhs | :mag: | mag | -| :mag_right: | mag_right | :candle: | candle | -| :bulb: | bulb | :flashlight: | flashlight | -| :izakaya_lantern: | izakaya_lantern
lantern | | | - -### Book Paper - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :notebook_with_decorative_cover: | notebook_with_decorative_cover | :closed_book: | closed_book | -| :book: | book
open_book | :green_book: | green_book | -| :blue_book: | blue_book | :orange_book: | orange_book | -| :books: | books | :notebook: | notebook | -| :ledger: | ledger | :page_with_curl: | page_with_curl | -| :scroll: | scroll | :page_facing_up: | page_facing_up | -| :newspaper: | newspaper | :newspaper_roll: | newspaper_roll | -| :bookmark_tabs: | bookmark_tabs | :bookmark: | bookmark | -| :label: | label | | | - -### Money - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :moneybag: | moneybag | :yen: | yen | -| :dollar: | dollar | :euro: | euro | -| :pound: | pound | :money_with_wings: | money_with_wings | -| :credit_card: | credit_card | :chart: | chart | - -### Mail - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :email: | email
envelope | :e-mail: | :e-mail: | -| :incoming_envelope: | incoming_envelope | :envelope_with_arrow: | envelope_with_arrow | -| :outbox_tray: | outbox_tray | :inbox_tray: | inbox_tray | -| :package: | package | :mailbox: | mailbox | -| :mailbox_closed: | mailbox_closed | :mailbox_with_mail: | mailbox_with_mail | -| :mailbox_with_no_mail: | mailbox_with_no_mail | :postbox: | postbox | -| :ballot_box: | ballot_box | | | - -### Writing - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :pencil2: | pencil2 | :black_nib: | black_nib | -| :fountain_pen: | fountain_pen | :pen: | pen | -| :paintbrush: | paintbrush | :crayon: | crayon | -| :memo: | memo
pencil | | | - -### Office - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :briefcase: | briefcase | :file_folder: | file_folder | -| :open_file_folder: | open_file_folder | :card_index_dividers: | card_index_dividers | -| :date: | date | :calendar: | calendar | -| :spiral_notepad: | spiral_notepad | :spiral_calendar: | spiral_calendar | -| :card_index: | card_index | :chart_with_upwards_trend: | chart_with_upwards_trend | -| :chart_with_downwards_trend: | chart_with_downwards_trend | :bar_chart: | bar_chart | -| :clipboard: | clipboard | :pushpin: | pushpin | -| :round_pushpin: | round_pushpin | :paperclip: | paperclip | -| :paperclips: | paperclips | :straight_ruler: | straight_ruler | -| :triangular_ruler: | triangular_ruler | :scissors: | scissors | -| :card_file_box: | card_file_box | :file_cabinet: | file_cabinet | -| :wastebasket: | wastebasket | | | - -### Lock - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :lock: | lock | :unlock: | unlock | -| :lock_with_ink_pen: | lock_with_ink_pen | :closed_lock_with_key: | closed_lock_with_key | -| :key: | key | :old_key: | old_key | - -### Tool - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :hammer: | hammer | :pick: | pick | -| :hammer_and_pick: | hammer_and_pick | :hammer_and_wrench: | hammer_and_wrench | -| :dagger: | dagger | :crossed_swords: | crossed_swords | -| :gun: | gun | :bow_and_arrow: | bow_and_arrow | -| :shield: | shield | :wrench: | wrench | -| :nut_and_bolt: | nut_and_bolt | :gear: | gear | -| :clamp: | clamp | :balance_scale: | balance_scale | -| :link: | link | :chains: | chains | - -### Science - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :alembic: | alembic | :microscope: | microscope | -| :telescope: | telescope | :satellite: | satellite | - -### Medical - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :syringe: | syringe | :pill: | pill | - -### Household - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :door: | door | :bed: | bed | -| :couch_and_lamp: | couch_and_lamp | :toilet: | toilet | -| :shower: | shower | :bathtub: | bathtub | -| :shopping_cart: | shopping_cart | | | - -### Other Object - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :smoking: | smoking | :coffin: | coffin | -| :funeral_urn: | funeral_urn | :moyai: | moyai | - -## Symbols - -### Transport Sign - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :atm: | atm | :put_litter_in_its_place: | put_litter_in_its_place | -| :potable_water: | potable_water | :wheelchair: | wheelchair | -| :mens: | mens | :womens: | womens | -| :restroom: | restroom | :baby_symbol: | baby_symbol | -| :wc: | wc | :passport_control: | passport_control | -| :customs: | customs | :baggage_claim: | baggage_claim | -| :left_luggage: | left_luggage | | | - -### Warning - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :warning: | warning | :children_crossing: | children_crossing | -| :no_entry: | no_entry | :no_entry_sign: | no_entry_sign | -| :no_bicycles: | no_bicycles | :no_smoking: | no_smoking | -| :do_not_litter: | do_not_litter | :non-potable_water: | :non-potable_water: | -| :no_pedestrians: | no_pedestrians | :no_mobile_phones: | no_mobile_phones | -| :underage: | underage | :radioactive: | radioactive | -| :biohazard: | biohazard | | | - -### Arrow - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :arrow_up: | arrow_up | :arrow_upper_right: | arrow_upper_right | -| :arrow_right: | arrow_right | :arrow_lower_right: | arrow_lower_right | -| :arrow_down: | arrow_down | :arrow_lower_left: | arrow_lower_left | -| :arrow_left: | arrow_left | :arrow_upper_left: | arrow_upper_left | -| :arrow_up_down: | arrow_up_down | :left_right_arrow: | left_right_arrow | -| :leftwards_arrow_with_hook: | leftwards_arrow_with_hook | :arrow_right_hook: | arrow_right_hook | -| :arrow_heading_up: | arrow_heading_up | :arrow_heading_down: | arrow_heading_down | -| :arrows_clockwise: | arrows_clockwise | :arrows_counterclockwise: | arrows_counterclockwise | -| :back: | back | :end: | end | -| :on: | on | :soon: | soon | -| :top: | top | | | - -### Religion - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :place_of_worship: | place_of_worship | :atom_symbol: | atom_symbol | -| :om: | om | :star_of_david: | star_of_david | -| :wheel_of_dharma: | wheel_of_dharma | :yin_yang: | yin_yang | -| :latin_cross: | latin_cross | :orthodox_cross: | orthodox_cross | -| :star_and_crescent: | star_and_crescent | :peace_symbol: | peace_symbol | -| :menorah: | menorah | :six_pointed_star: | six_pointed_star | - -### Zodiac - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :aries: | aries | :taurus: | taurus | -| :gemini: | gemini | :cancer: | cancer | -| :leo: | leo | :virgo: | virgo | -| :libra: | libra | :scorpius: | scorpius | -| :sagittarius: | sagittarius | :capricorn: | capricorn | -| :aquarius: | aquarius | :pisces: | pisces | -| :ophiuchus: | ophiuchus | | | - -### Av Symbol - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :twisted_rightwards_arrows: | twisted_rightwards_arrows | :repeat: | repeat | -| :repeat_one: | repeat_one | :arrow_forward: | arrow_forward | -| :fast_forward: | fast_forward | :next_track_button: | next_track_button | -| :play_or_pause_button: | play_or_pause_button | :arrow_backward: | arrow_backward | -| :rewind: | rewind | :previous_track_button: | previous_track_button | -| :arrow_up_small: | arrow_up_small | :arrow_double_up: | arrow_double_up | -| :arrow_down_small: | arrow_down_small | :arrow_double_down: | arrow_double_down | -| :pause_button: | pause_button | :stop_button: | stop_button | -| :record_button: | record_button | :cinema: | cinema | -| :low_brightness: | low_brightness | :high_brightness: | high_brightness | -| :signal_strength: | signal_strength | :vibration_mode: | vibration_mode | -| :mobile_phone_off: | mobile_phone_off | | | - -### Math - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :heavy_multiplication_x: | heavy_multiplication_x | :heavy_plus_sign: | heavy_plus_sign | -| :heavy_minus_sign: | heavy_minus_sign | :heavy_division_sign: | heavy_division_sign | - -### Punctuation - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :bangbang: | bangbang | :interrobang: | interrobang | -| :question: | question | :grey_question: | grey_question | -| :grey_exclamation: | grey_exclamation | :exclamation: | exclamation
heavy_exclamation_mark | -| :wavy_dash: | wavy_dash | | | - -### Currency - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :currency_exchange: | currency_exchange | :heavy_dollar_sign: | heavy_dollar_sign | - -### Keycap - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :hash: | hash | :asterisk: | asterisk | -| :zero: | zero | :one: | one | -| :two: | two | :three: | three | -| :four: | four | :five: | five | -| :six: | six | :seven: | seven | -| :eight: | eight | :nine: | nine | -| :keycap_ten: | keycap_ten | | | - -### Alphabet - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :capital_abcd: | capital_abcd | :abcd: | abcd | -| :1234: | 1234 | :symbols: | symbols | -| :abc: | abc | :a: | a | -| :ab: | ab | :b: | b | -| :cl: | cl | :cool: | cool | -| :free: | free | :information_source: | information_source | -| :id: | id | :m: | m | -| :new: | new | :ng: | ng | -| :o2: | o2 | :ok: | ok | -| :parking: | parking | :sos: | sos | -| :up: | up | :vs: | vs | -| :koko: | koko | :sa: | sa | -| :u6708: | u6708 | :u6709: | u6709 | -| :u6307: | u6307 | :ideograph_advantage: | ideograph_advantage | -| :u5272: | u5272 | :u7121: | u7121 | -| :u7981: | u7981 | :accept: | accept | -| :u7533: | u7533 | :u5408: | u5408 | -| :u7a7a: | u7a7a | :congratulations: | congratulations | -| :secret: | secret | :u55b6: | u55b6 | -| :u6e80: | u6e80 | | | - -### Geometric - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :red_circle: | red_circle | :large_blue_circle: | large_blue_circle | -| :black_circle: | black_circle | :white_circle: | white_circle | -| :black_large_square: | black_large_square | :white_large_square: | white_large_square | -| :black_medium_square: | black_medium_square | :white_medium_square: | white_medium_square | -| :black_medium_small_square: | black_medium_small_square | :white_medium_small_square: | white_medium_small_square | -| :black_small_square: | black_small_square | :white_small_square: | white_small_square | -| :large_orange_diamond: | large_orange_diamond | :large_blue_diamond: | large_blue_diamond | -| :small_orange_diamond: | small_orange_diamond | :small_blue_diamond: | small_blue_diamond | -| :small_red_triangle: | small_red_triangle | :small_red_triangle_down: | small_red_triangle_down | -| :diamond_shape_with_a_dot_inside: | diamond_shape_with_a_dot_inside | :radio_button: | radio_button | -| :white_square_button: | white_square_button | :black_square_button: | black_square_button | - -### Other Symbol - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :recycle: | recycle | :fleur_de_lis: | fleur_de_lis | -| :trident: | trident | :name_badge: | name_badge | -| :beginner: | beginner | :o: | o | -| :white_check_mark: | white_check_mark | :ballot_box_with_check: | ballot_box_with_check | -| :heavy_check_mark: | heavy_check_mark | :x: | x | -| :negative_squared_cross_mark: | negative_squared_cross_mark | :curly_loop: | curly_loop | -| :loop: | loop | :part_alternation_mark: | part_alternation_mark | -| :eight_spoked_asterisk: | eight_spoked_asterisk | :eight_pointed_black_star: | eight_pointed_black_star | -| :sparkle: | sparkle | :copyright: | copyright | -| :registered: | registered | :tm: | tm | - -## Flags - -### Common Flags - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :checkered_flag: | checkered_flag | :triangular_flag_on_post: | triangular_flag_on_post | -| :crossed_flags: | crossed_flags | :black_flag: | black_flag | -| :white_flag: | white_flag | :rainbow_flag: | rainbow_flag | - -### Country and Region Flags - -| icon | code | icon | code | -| :-: | - | :-: | - | -| :andorra: | andorra | :united_arab_emirates: | united_arab_emirates | -| :afghanistan: | afghanistan | :antigua_barbuda: | antigua_barbuda | -| :anguilla: | anguilla | :albania: | albania | -| :armenia: | armenia | :angola: | angola | -| :antarctica: | antarctica | :argentina: | argentina | -| :american_samoa: | american_samoa | :austria: | austria | -| :australia: | australia | :aruba: | aruba | -| :aland_islands: | aland_islands | :azerbaijan: | azerbaijan | -| :bosnia_herzegovina: | bosnia_herzegovina | :barbados: | barbados | -| :bangladesh: | bangladesh | :belgium: | belgium | -| :burkina_faso: | burkina_faso | :bulgaria: | bulgaria | -| :bahrain: | bahrain | :burundi: | burundi | -| :benin: | benin | :st_barthelemy: | st_barthelemy | -| :bermuda: | bermuda | :brunei: | brunei | -| :bolivia: | bolivia | :caribbean_netherlands: | caribbean_netherlands | -| :brazil: | brazil | :bahamas: | bahamas | -| :bhutan: | bhutan | :botswana: | botswana | -| :belarus: | belarus | :belize: | belize | -| :canada: | canada | :cocos_islands: | cocos_islands | -| :congo_kinshasa: | congo_kinshasa | :central_african_republic: | central_african_republic | -| :congo_brazzaville: | congo_brazzaville | :switzerland: | switzerland | -| :cote_divoire: | cote_divoire | :cook_islands: | cook_islands | -| :chile: | chile | :cameroon: | cameroon | -| :cn: | cn | :colombia: | colombia | -| :costa_rica: | costa_rica | :cuba: | cuba | -| :cape_verde: | cape_verde | :curacao: | curacao | -| :christmas_island: | christmas_island | :cyprus: | cyprus | -| :czech_republic: | czech_republic | :de: | de | -| :djibouti: | djibouti | :denmark: | denmark | -| :dominica: | dominica | :dominican_republic: | dominican_republic | -| :algeria: | algeria | :ecuador: | ecuador | -| :estonia: | estonia | :egypt: | egypt | -| :western_sahara: | western_sahara | :eritrea: | eritrea | -| :es: | es | :ethiopia: | ethiopia | -| :eu: | eu
european_union | :finland: | finland | -| :fiji: | fiji | :falkland_islands: | falkland_islands | -| :micronesia: | micronesia | :faroe_islands: | faroe_islands | -| :fr: | fr | :gabon: | gabon | -| :gb: | gb
uk | :grenada: | grenada | -| :georgia: | georgia | :french_guiana: | french_guiana | -| :guernsey: | guernsey | :ghana: | ghana | -| :gibraltar: | gibraltar | :greenland: | greenland | -| :gambia: | gambia | :guinea: | guinea | -| :guadeloupe: | guadeloupe | :equatorial_guinea: | equatorial_guinea | -| :greece: | greece | :south_georgia_south_sandwich_islands: | south_georgia_south_sandwich_islands | -| :guatemala: | guatemala | :guam: | guam | -| :guinea_bissau: | guinea_bissau | :guyana: | guyana | -| :hong_kong: | hong_kong | :honduras: | honduras | -| :croatia: | croatia | :haiti: | haiti | -| :hungary: | hungary | :canary_islands: | canary_islands | -| :indonesia: | indonesia | :ireland: | ireland | -| :israel: | israel | :isle_of_man: | isle_of_man | -| :india: | india | :british_indian_ocean_territory: | british_indian_ocean_territory | -| :iraq: | iraq | :iran: | iran | -| :iceland: | iceland | :it: | it | -| :jersey: | jersey | :jamaica: | jamaica | -| :jordan: | jordan | :jp: | jp | -| :kenya: | kenya | :kyrgyzstan: | kyrgyzstan | -| :cambodia: | cambodia | :kiribati: | kiribati | -| :comoros: | comoros | :st_kitts_nevis: | st_kitts_nevis | -| :north_korea: | north_korea | :kr: | kr | -| :kuwait: | kuwait | :cayman_islands: | cayman_islands | -| :kazakhstan: | kazakhstan | :laos: | laos | -| :lebanon: | lebanon | :st_lucia: | st_lucia | -| :liechtenstein: | liechtenstein | :sri_lanka: | sri_lanka | -| :liberia: | liberia | :lesotho: | lesotho | -| :lithuania: | lithuania | :luxembourg: | luxembourg | -| :latvia: | latvia | :libya: | libya | -| :morocco: | morocco | :monaco: | monaco | -| :moldova: | moldova | :montenegro: | montenegro | -| :madagascar: | madagascar | :marshall_islands: | marshall_islands | -| :macedonia: | macedonia | :mali: | mali | -| :myanmar: | myanmar | :mongolia: | mongolia | -| :macau: | macau | :northern_mariana_islands: | northern_mariana_islands | -| :martinique: | martinique | :mauritania: | mauritania | -| :montserrat: | montserrat | :malta: | malta | -| :mauritius: | mauritius | :maldives: | maldives | -| :malawi: | malawi | :mexico: | mexico | -| :malaysia: | malaysia | :mozambique: | mozambique | -| :namibia: | namibia | :new_caledonia: | new_caledonia | -| :niger: | niger | :norfolk_island: | norfolk_island | -| :nigeria: | nigeria | :nicaragua: | nicaragua | -| :netherlands: | netherlands | :norway: | norway | -| :nepal: | nepal | :nauru: | nauru | -| :niue: | niue | :new_zealand: | new_zealand | -| :oman: | oman | :panama: | panama | -| :peru: | peru | :french_polynesia: | french_polynesia | -| :papua_new_guinea: | papua_new_guinea | :philippines: | philippines | -| :pakistan: | pakistan | :poland: | poland | -| :st_pierre_miquelon: | st_pierre_miquelon | :pitcairn_islands: | pitcairn_islands | -| :puerto_rico: | puerto_rico | :palestinian_territories: | palestinian_territories | -| :portugal: | portugal | :palau: | palau | -| :paraguay: | paraguay | :qatar: | qatar | -| :reunion: | reunion | :romania: | romania | -| :serbia: | serbia | :ru: | ru | -| :rwanda: | rwanda | :saudi_arabia: | saudi_arabia | -| :solomon_islands: | solomon_islands | :seychelles: | seychelles | -| :sudan: | sudan | :sweden: | sweden | -| :singapore: | singapore | :st_helena: | st_helena | -| :slovenia: | slovenia | :slovakia: | slovakia | -| :sierra_leone: | sierra_leone | :san_marino: | san_marino | -| :senegal: | senegal | :somalia: | somalia | -| :suriname: | suriname | :south_sudan: | south_sudan | -| :sao_tome_principe: | sao_tome_principe | :el_salvador: | el_salvador | -| :sint_maarten: | sint_maarten | :syria: | syria | -| :swaziland: | swaziland | :turks_caicos_islands: | turks_caicos_islands | -| :chad: | chad | :french_southern_territories: | french_southern_territories | -| :togo: | togo | :thailand: | thailand | -| :tajikistan: | tajikistan | :tokelau: | tokelau | -| :timor_leste: | timor_leste | :turkmenistan: | turkmenistan | -| :tunisia: | tunisia | :tonga: | tonga | -| :tr: | tr | :trinidad_tobago: | trinidad_tobago | -| :tuvalu: | tuvalu | :taiwan: | taiwan | -| :tanzania: | tanzania | :ukraine: | ukraine | -| :uganda: | uganda | :us: | us | -| :uruguay: | uruguay | :uzbekistan: | uzbekistan | -| :vatican_city: | vatican_city | :st_vincent_grenadines: | st_vincent_grenadines | -| :venezuela: | venezuela | :british_virgin_islands: | british_virgin_islands | -| :us_virgin_islands: | us_virgin_islands | :vietnam: | vietnam | -| :vanuatu: | vanuatu | :wallis_futuna: | wallis_futuna | -| :samoa: | samoa | :kosovo: | kosovo | -| :yemen: | yemen | :mayotte: | mayotte | -| :south_africa: | south_africa | :zambia: | zambia | -| :zimbabwe: | zimbabwe | | | - diff --git a/content/posts/lorem-ipsum.md b/content/posts/lorem-ipsum.md deleted file mode 100644 index 7ccec06..0000000 --- a/content/posts/lorem-ipsum.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: "Lorem Ipsum" -date: 2021-04-15T23:39:49+05:30 -tags: ["xyz", "def"] -type: "post" -image: "/images/lorem-ipsum/quick-fox.png" -showTableOfContents: false ---- - -# Heading 1 - -"Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum." - -This continues at length and variously. The text is not really Greek, but badly garbled Latin. It started life as extracted phrases from sections 1.10.32 and 1.10.33 of Cicero's "De Finibus Bonorum et Malorum" ("The Extremes of Good and Evil"), which read: - -## Heading 2 - -Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? - -At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus, omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat. - -### Heading 3 - -"Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum." - -This continues at length and variously. The text is not really Greek, but badly garbled Latin. It started life as extracted phrases from sections 1.10.32 and 1.10.33 of Cicero's "De Finibus Bonorum et Malorum" ("The Extremes of Good and Evil"), which read: - -Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? - - -#### Heading 4 - -At ver -"Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum." - -This continues at length and variously. The text is not really Greek, but badly garbled Latin. It started life as extracted phrases from sections 1.10.32 and 1.10.33 of Cicero's "De Finibus Bonorum et Malorum" ("The Extremes of Good and Evil"), which read: - -Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? - -##### Heading 5 - -At ver -"Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum." - -This continues at length and variously. The text is not really Greek, but badly garbled Latin. It started life as extracted phrases from sections 1.10.32 and 1.10.33 of Cicero's "De Finibus Bonorum et Malorum" ("The Extremes of Good and Evil"), which read: - -Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? - -At ver diff --git a/content/posts/theme-documentation-advanced.md b/content/posts/theme-documentation-advanced.md deleted file mode 100644 index c524ae4..0000000 --- a/content/posts/theme-documentation-advanced.md +++ /dev/null @@ -1,378 +0,0 @@ ---- -weight: 15 -title: "Theme Documentation - Advanced" -date: 2020-05-06T21:29:01+08:00 -description: "Discover how to maximise Gokarna's potential" -tags: ["installation", "configuration", "markdown"] -type: post -showTableOfContents: true ---- - -Gokarna is an opinionated theme with a focus on minimalism and simplicity. - -## Content Types - -This theme supports two types of content types: `post` and `page`. To specify them, you need to add them in your markdown metadata. - -### Post - -This is the default blog post type which will be shown in your "Posts" section and who's tags will be indexed. Basically, a normal blog post. - -```markdown ---- -title: "Hello, world!" -date: 2021-01-01 -description: "A blog post" -image: "/path/to/image.png" -type: "post" -tags: ["blog"] ---- - -# Hello World! -This is my blog. -``` - -### Page - -We introduced this type to distinguish between blog posts and normal markdown pages. The reason to create this was to give the user complete freedom in creating their website. You can use this to create a portfolio of your projects or showcase your designs. The possibilites are endless and the choice is yours. - -```markdown ---- -title: "Hello, world!" -image: "/path/to/image.png" -type: "page" ---- - -# Projects -Keep an eye on this space for my upcoming projects -``` - -### Table of Contents - -To show `Table of Contents`, update your config by adding -```toml -[markup] - [markup.tableOfContents] - startLevel = 1 - endLevel = 3 - ordered = false -``` - -And then on each page add the attribute `showTableOfContents: true` **(Note: It is disabled by default)** - -```markdown ---- -title: "Hello, world!" -image: "/path/to/image.png" -type: "page" -showTableOfContents: true ---- -``` - -Detailed configuration can be found on [Hugo's official documentation](https://gohugo.io/getting-started/configuration-markup/#table-of-contents) - -## Weights - -The `weight` attribute can be added in the markdown metadata for `post` types. We have an option in our config.toml: `params.showPostsOnHomePage` which allows you to: - -1. Show popular posts on home page if the value is set to `popular`. It sorts the all the posts by it's weight attribute in ascending order. -2. Show recent posts on home page if the value is set to `recent` -3. Do not show anything if the variable is unset or an empty string. - -## Homepage - -### About description text - -In extension to the basic configuration with the `description` field, it's also possible to write the about section using markdown. -Create a file called `index-about.md` in the `content` directory and write your content there. - -> **Attention**: Don't use frontmatter in this file. It would also render it. - -```markdown -# Gokarna -Gokarna is a small temple town located in the Uttara Kannada district of Karnataka state in southern India. - -## Beaches -Something about beaches, **which is *very* important**. - -- every -- beach -- is beautiful -``` - -Having the above about section in place, results in the following homepage: - -![Markdown about description](/images/theme-documentation-advanced/homepage-markdown-about-description.png "Markdown about description") - - -## Icons -Gokarna supports popular social media icons (Github, Linkedin, Twitter, StackOverflow, Dribbble, etc.) out of the box. See full list of supported icons [on GitHub](https://github.com/gokarna-theme/gokarna-hugo/tree/main/static/icons). - -### Icons on homepage - -To display icons on the homepage, simply update the `socialIcons` config param with a list of name and url of each icon. The specified `name` should exactly match one of the names from [the `icons` directory](https://github.com/gokarna-theme/gokarna-hugo/tree/main/static/svg/icons). -If you want to add more icons, you can download the svg directly from [Simple Icons' website](https://simpleicons.org/) and place them in your local icons directory (`/static/svg/icons/`) - -```toml - [params] - socialIcons = [ - {name = "twitter", url = "https://example.com"}, - {name = "linkedin", url = "https://example.com"}, - {name = "stackoverflow", url = "https://example.com"}, - ] -``` - -Preview: - -![Icons on homepage Preview](/images/theme-documentation-advanced/icons-homepage-preview.png "Icons on homepage Preview") - - -### Icons in header - -[Feather](https://feathericons.com) icons has a comprehensive list of icons which are more general purpose and not limited to social media. -Therefore, we use feather as an additional source of icons. Here is an example of how to add custom icons in the header using feather: - -```toml - [[menu.main]] - identifier = "github" - url = "https://github.com" - weight = 3 - # Using feather-icons - pre = "" -``` - -The same icon in this case could also be added without feather: - -```toml - [[menu.main]] - identifier = "github" - url = "https://www.buymeacoffee.com/" - weight = 3 - # Without using feather-icons - pre = "" -``` - -You can add `params` allowing menu link to open in a new tab, for example: -```toml -[[menu.main]] - identifier = "github" - url = "https://github.com/zerodahero" - weight = 4 - # We use feather-icons: https://feathericons.com/ - pre = "" - [menu.main.params] - newPage = true -``` - -## Custom Head and Footer HTML - -The goal of this feature is to give the user more control over the theme. It's functioning is very straightforward - "You can inject any HTML you want in the `` tag" . This may seem simple at first, but it opens up a lot of possibilities. - -## Custom Comment HTML - -Similar to custom head and footer HTML, you can add custom HTML for comments at the end of every post. Its in a `
` with the id `comments` which can be then customized with your external CSS. - -The purpose of this is to freely use any comments platform of your choosing - -### For example -```toml -customCommentHTML = """ - -""" -``` - -### Bring your own scripts - -Add your own JavaScript or CSS by putting them in the `static/` folder and importing them into your HTML. - -```toml -[params] - customHeadHTML = ''' - - - ''' - customFooterHTML = ''' -
Comment SDK Integration
- - - ''' -``` - -### Analytics - -Integration with any analytics tool: This was a personal pet peeve. User privacy is our primary concern and this meant not using Google Analytics or any of the popular tools. - -We preferred privacy friendly tools like [Umami](https://umami.is/) & [Fathom Analytics](https://usefathom.com/), but the downside was that no theme supported them out of the box which led to either changing the theme source code or contributing supporting code to the original theme (both of which are good ways to extend the theme, but not our ideal choice) - -Giving users the freedom to add anything in the HTML via config.toml seemed like an elegant way to solve the problem. - -```toml -[params] - customHeadHTML = ''' - - ''' -``` - -### Katex - -Katex is a math typesetting library for the web which lets you write beautiful equations. To use it, add the javascript as mentioned in [their documentation](https://katex.org/docs/browser.html) in our `params.customHeadHTML`. - -```toml -[params] - customHeadHTML = ''' - - - - - ''' -``` - -> Note: Make sure you use the latest version of katex and use the correct script tags as described in [their documentation](https://katex.org/docs/browser.html) - -Then the equation `$$y_t = \beta_0 + \beta_1 x_t + \epsilon_t$$` wrapped by double `$$` would be displayed as: - - $$y_t = \beta_0 + \beta_1 x_t + \epsilon_t$$ - -The equation `$y_t = \beta_0 + \beta_1 x_t + \epsilon_t$` wrapped by single `$` would be displayed inline as $y_t = \beta_0 + \beta_1 x_t + \epsilon_t$. - -### Comments - -Integration with any comments SDK is possible. All you have to do is add the relevant HTML/JavaScript in the `customFooterHTML` param. - -An example with commento: - -```toml -[params] - customFooterHTML = ''' -
- - - ''' -``` - - -## Syntax Highlighting - -Hugo lets you choose the color scheme for the codeblocks. You can choose from the options here: https://xyproto.github.io/splash/docs/all.html - -After choosing your theme, just update the `pygmentsStyle` attribute in config.toml. - -```toml -pygmentsStyle = "monokai" -``` - -You can read more about syntax highlighting on the [official hugo docs](https://gohugo.io/content-management/syntax-highlighting/). - -## Site Metadata - -Gokarna enables you to improve the SEO performance of your website with minimal effort. - -### Image preview - -We make sure your pages are social media ready. - -![Social Media Preview](/images/theme-documentation-advanced/preview.png "Social Media Preview") - -```markdown ---- -title: "Hello, world!" -image: "/path/to/image.png" ---- -``` - -> Note: If no image is specified in the markdown metadata, the site avatar is automatically used instead. - -### SEO keywords - -The keywords relevant for SEO are composed of the page `tags` as defined below: - -```markdown ---- -title: "Hello, world!" -tags: ["hello", "world"] ---- -``` - -and the `metaKeywords` specified in the config.toml: - -```markdown -[params] - metaKeywords = ["blog", "gokarna", "hugo"] -``` - -## Hide tags, date or description of posts - -Tags can be used to categorize posts (e.g.: Project or Blog), and be hidden on -the posts. Use the `params.hiddenTags` field in `hugo.toml`. -A post's date and description can be hidden if it has at least one tag listed in -`params.tagsHidePostDate` or `params.tagsHidePostDescription`, respectively. - - -```toml -[params] - [params.hidden] - tags = ["project", "blog"] - tagsPostDate = ["project"] - tagsPostDescription = ["project"] - [menu] - [[menu.main]] - identifier = "projects" - url = "/tags/project/" - name = "My Projects" - weight = 1 - [[menu.main]] - identifier = "blog" - url = "/tags/blog/" - name = "Blog" - weight = 2 -``` - -## Site-wide copyright notice - -Define the [copyright notice for your site](https://gohugo.io/methods/site/copyright/). The notice will only be displayed on [page Kinds](#content-types). - -For example, the following configuration in `config.toml` and front matter respectively... - -```toml -copyright = "Verbatim copying and distribution of this entire article are permitted worldwide, without royalty, in any medium, provided this notice is preserved." -``` - -``` -date: 2020-06-17 -lastmod: 2024-02-05 -``` - -Will produce this footer: - -> © 2020-2024 The Marauders Verbatim copying and distribution of this entire article are permitted worldwide, without royalty, in any medium, provided this notice is preserved. - -`copyright` can include [Markdown syntax](https://www.markdownguide.org/tools/hugo/). This is best used for including hyperlinks, emoji, or text formatting. - -The years of `.Date` and `.Lastmod` are used to create a date range for your copyrighted material. [dateFormat](/posts/theme-documentation-basics/#date-format) **must** be set in `config.toml` if `.Lastmod` is present in any front matter. - -## Minification - -`hugo`'s HTML output can be [minified](https://gohugo.io/hugo-pipes/minification/#usage), resulting in smaller files. This makes your site more performant (especially when paired with compression), and may confer a better [Google Lighthouse](https://pagespeed.web.dev/) score. - -```toml -[minify] - minifyOutput = true -``` diff --git a/content/posts/theme-documentation-basics.md b/content/posts/theme-documentation-basics.md deleted file mode 100644 index f30ddd4..0000000 --- a/content/posts/theme-documentation-basics.md +++ /dev/null @@ -1,332 +0,0 @@ ---- -weight: 10 -title: "Theme Documentation - Basics" -date: 2020-03-06T21:29:01+08:00 -description: "A guide to getting started with Gokarna" -tags: ["installation", "configuration", "markdown"] -type: post -showTableOfContents: true ---- - -Gokarna is an opinionated theme with a focus on minimalism and simplicity. - -## Installation - -Follow these steps to initialize your new website. - -If you are new to [Hugo](https://gohugo.io/), we suggest following this [great documentation for beginners](https://gohugo.io/getting-started/quick-start/). - - - -### a. Create Your Project {#create-your-project} - -Hugo provides a `new` subcommand to create a new website: - -```bash -hugo new site my-website -cd my-website -``` - -### b. Install the Theme {#install-the-theme} - -The theme's repository is: [https://github.com/gokarna-theme/gokarna-hugo](https://github.com/gokarna-theme/gokarna-hugo). - -Make this repository a submodule of your Git project: - -```bash -git init -git submodule add https://github.com/gokarna-theme/gokarna-hugo.git themes/gokarna -``` - -### c. Basic Configuration {#basic-configuration} - -A simple Hugo [configuration file](https://gohugo.io/getting-started/configuration/#configuration-file) with [menu items](https://gohugo.io/content-management/menus/#properties-front-matter). - -Gokarna supports [adding Feather icons to the header](/posts/theme-documentation-advanced/#icons-in-header). - -```toml -baseURL = "https://example.org/" -defaultContentLanguage = "en" -# Automatically generate robots.txt -enableRobotsTXT = true -languageCode = "en" -theme = "gokarna" -title = "My New Hugo Site" - -[menu] - [[menu.main]] - # Display name - name = "Posts" - - # Relative URL slug (appended to baseURL) - url = "/posts/" - - # Lower weights are listed first in the menu (leftmost); higher weights are - # listed last in the menu (rightmost) - weight = 1 - - [[menu.main]] - name = "Tags" - url = "/tags/" - weight = 2 - - [[menu.main]] - # Unique identifiers are required for menu entries without a name property, - # or for menu entries which re-use a name - identifier = "github" - - # Absolute URL to external resource - url = "https://github.com" - weight = 3 - - # Surround the menu entry (or name) with HTML content, such as Feather - # icons: https://feathericons.com - pre = "" - post = "" -``` - - -### d. Create Your First Post {#create-your-first-post} - -Use the [`new` subcommand](https://gohugo.io/commands/hugo_new/#hugo-new) to create a post (in [the `content/` directory](https://gohugo.io/content-management/organization/#organization-of-content-source)): - -```bash -hugo new posts/'My First Post'.md -``` - -Two [content types](https://gohugo.io/content-management/types/) are supported in Gokarna: - -1. `type: "post"` - - A blog post consisting of a [page title](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/title#page_titles_and_seo), [meta description](https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML#adding_an_author_and_description), creation/last modified dates, [SEO keywords (tags)](/posts/theme-documentation-advanced/#seo-keywords), and Markdown content. - - Read more about Posts in the [advanced documentation](/posts/theme-documentation-advanced/#post). - -2. `type: "page"` - - A standalone page which only renders Markdown. Best used for custom pages (e.g. your [portfolio](/projects/)) which should not feature in your [Posts](/posts/) timeline. - - Read more about Pages in the [advanced documentation](/posts/theme-documentation-advanced/#page). - -#### Using archetypes - -`hugo new` will automatically use an appropriate [archetype](https://gohugo.io/content-management/archetypes/#lookup-order) (see [`archetypes/`](https://github.com/gokarna-theme/gokarna-hugo/tree/main/archetypes)) and insert [front matter](https://gohugo.io/content-management/front-matter/) depending on the location of your content: - -- `hugo new posts/$post-name.md` automatically sets `type: "post"` -- `hugo new $page-name.md` automatically sets `type: "page"` - -Gokarna employs [custom front matter](/posts/theme-documentation-advanced/#content-types), which is included in the archetypes: - -- The creation date of the file is automatically set (e.g. `date: 2023-12-25`) -- The file name is used as the default title (e.g. `title: "My First Post"`) - -### e. Launching the Website Locally {#launching-the-website-locally} - -Use the [`server` subcommand](https://gohugo.io/commands/hugo_server/#synopsis) to view your site. - -```bash -hugo server -``` - -Go to [`http://localhost:1313`](http://localhost:1313/) (if no other Hugo servers are running; Hugo will use an [ephemeral port](https://en.wikipedia.org/wiki/Ephemeral_port) if one or more servers are running concurrently on the host). - -### f. Build the Website {#build-the-website} - -Use the `hugo` command to build your site. - -```bash -hugo -``` - -A `public` folder will be generated, containing all static content and assets for your website. It can be hosted on any web server. - -The website can be automatically published and hosted with [Netlify](https://www.netlify.com/), [AWS Amplify](https://gohugo.io/hosting-and-deployment/hosting-on-aws-amplify/), [GitHub Pages](https://gohugo.io/hosting-and-deployment/hosting-on-github/), [Render](https://gohugo.io/hosting-and-deployment/hosting-on-render/), and more... - -## Configuration - -In addition to [Hugo global configuration](https://gohugo.io/overview/configuration/) and [menu configuration](#basic-configuration), Gokarna lets you define the following [parameters](https://gohugo.io/methods/site/params/) in your site configuration. - -See this sample `config.toml`, which uses Gokarna's default values, and [exampleSite's `config.toml`](https://github.com/gokarna-theme/gokarna-hugo/blob/main/exampleSite/config.toml): - -```toml -[params] - # Choose the color shown when hyperlinks are hovered over - accentColor = "#FF4D4D" - - # Resource URL for the site avatar (home page and header) - avatarURL = "/images/avatar.webp" - - # Describe the avatar for screen readers - avatarAltText = "avatar" - - # Set the avatar's size: size-xs, size-s, size-m, size-l & size-xl - avatarSize = "size-m" - - # Inject arbitrary HTML via the tag - # Best used for importing custom JavaScript, CSS, or analytics - customHeadHTML = "" - - # Configure how post dates are displayed - # dateFormat must be set if lastmod is declared in front matter, or - # enableGitInfo is true - dateFormat = "January 2, 2006" - - # Home page meta description - description = "Sky above, sand below & peace within" - - # Footer text (i.e. author/project name) - footer = "The Marauders" - - # Define SEO keywords - metaKeywords = ["blog", "gokarna", "hugo"] - - # Define how many posts are displayed on the home page - # showPostsOnHomePage must be "popular" or "recent" - numberPostsOnHomePage = 4 - - # Display a "back to top" button on posts and pages: true, false - # May not render on smaller screen sizes - showBackToTopButton = true - - # Display posts on the home page: - # "popular" (order posts by weight) - # "recent" (order posts by date) - # "", unset (do not display) - showPostsOnHomePage = "" - - # Show the previous and next post in your timeline: "true", "false" - # Incompatible with Weight - togglePreviousAndNextButtons = "false" -``` - -### Accent color - -The color displayed when a user hovers over hyperlinks (`` tags), expressed as a [hexadecimal](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color). - -```toml -[params] - accentColor = "#FF4D4D" -``` - -### Avatar URL - -The avatar's resource URL, displayed on the [home page](/) and header (top-left). - -Images are typically placed into the [`assets/`](https://gohugo.io/getting-started/directory-structure/#assets) or [`static/`](https://gohugo.io/getting-started/directory-structure/#static) directories (which are copied to the top-level directory [at build time](#build-the-website)). - -```toml -[params] - avatarURL = "/images/avatar.webp" -``` - -### Avatar size - -Set the avatar's size as: `size-xs`, `size-s`, `size-m`, `size-l`, or `size-xl`. - -```toml -[params] - avatarSize = "size-m" -``` - -### Custom Head HTML - -Add arbitrary HTML code to the [`` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/head). - -```toml -[params] - customHeadHTML = "" -``` - -Examples are available in the [advanced documentation](/posts/theme-documentation-advanced/#bring-your-own-scripts). - -### Date format - -[Configure how posts date are displayed](https://gohugo.io/functions/time/format/), using [date strings](https://pkg.go.dev/time#pkg-constants). - -dateFormat **must be set** if [`enableGitInfo`](https://gohugo.io/methods/page/gitinfo/#prerequisites) is `true`, or [`.Lastmod`](https://gohugo.io/methods/page/lastmod/) is present in any front matter. - -```toml -[params] - dateFormat = "2 January, 2006" -``` - -### Description - -[Meta description](https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML#adding_an_author_and_description) to display on the home page, below the title and avatar. - -```toml -[params] - description = "Sky above, sand below & peace within" -``` - -### Display content on the home page - -Markdown content in `content/index-about.md` will be rendered on the home page, below the social icons. - -### Display posts on the home page - -Recent and popular posts can be shown on the home page: - -- `popular`: Sort posts in ascending order of their [Weight](https://gohugo.io/methods/page/weight/) - - **If any post on your site defines `weight`, you cannot enable [Previous and Next buttons](#previous-and-next-buttons).** - -- `recent`: Sort posts in ascending order of [Date](https://gohugo.io/methods/page/date/) - -- Do not show anything if the variable is: - - unset - - an empty string (`""`) - -The number of posts displayed on the home page can be changed by setting `numberPostsOnHomePage`. If `numberPostsOnHomePage` is equal to `""` or `0`, the default value (`4`) is used. - -```toml -[params] - showPostsOnHomePage = "" - numberPostsOnHomePage = 4 -``` - -### Favicons - -Place favicons into the `static/` directory. The following files are supported: - -- `apple-touch-icon.png` (180x180) -- `favicon-32x32.png` (32x32) -- `favicon-16x16.png` (16x16) -- `mstile-150x150.png` (150x150) -- `android-chrome-192x192.png` (192x192) -- `android-chrome-512x512.png` (512x512) - -Favicons can be generated using services such as [favicon.io](https://favicon.io), or [realfavicongenerator.net](https://realfavicongenerator.net/). - -### Footer - -Text to display in the footer section, typically the name of the author or project. - -```toml -[params] - footer = "The Marauders" -``` - -`footer` can include [Markdown syntax](https://www.markdownguide.org/tools/hugo/) - best used for including hyperlinks, emoji, or text formatting. - -### Previous and Next buttons - -At the bottom of a post, show the previous and next post chronologically. - -**Warning**: Not compatible with the `.Weight` parameter. - -If any post front matter contains `weight`, the posts will not appear by Date. See [Hugo's default sort](https://gohugo.io/templates/lists#default-weight--date--linktitle--filepath). - -```toml -[params] - togglePreviousAndNextButtons = "false" -``` - -### robots.txt - -[Automatically generate](https://gohugo.io/templates/robots/) a `robots.txt` file, used to ['manage crawler traffic to your site'](https://developers.google.com/search/docs/crawling-indexing/robots/intro). - -```toml -enableRobotsTXT = true -``` diff --git a/content/projects/_index.md b/content/projects/_index.md new file mode 100644 index 0000000..ea40547 --- /dev/null +++ b/content/projects/_index.md @@ -0,0 +1,8 @@ +--- +title: "Projects" +type: page +--- + +## Hello, my projects are: + +1. [Tatooine](/projects/tatooine/) \ No newline at end of file diff --git a/content/projects/bludhaven.md b/content/projects/bludhaven.md new file mode 100644 index 0000000..f95c981 --- /dev/null +++ b/content/projects/bludhaven.md @@ -0,0 +1,8 @@ +--- +title: Blüdhaven +type: page +--- + +## History + +Blüdhaven was a former whaling town, which was officially incorporated as a "Commonwealth" in 1912. The town had a generally poor socio-economic populace, owing in part to failed efforts to transform itself into a manufacturing and shipping center. diff --git a/hugo.toml b/hugo.toml index 75a358b..9cbcc98 100644 --- a/hugo.toml +++ b/hugo.toml @@ -5,9 +5,13 @@ title = "我的天空" theme = "gokarna" enableEmoji = true enableRobotsTXT = true -# pygmentsStyle = "monokai" +pygmentsStyle = "monokai" [params] + [params.hidden] + tags = ["project", "blog"] + tagsPostDate = ["project"] + tagsPostDescription = ["project"] avatarAltText = "avatar" avatarSize = "size-m" avatarURL = "/images/avatar.webp"