Universe

A typst package to display country flags in your Typst documents. This first version is extremely simple, as the only two arguments is the country and the height of the flag to display in the document.

Loading the package

#import "@preview/flagada:0.2.0" : *

Calling a flag

You need to know the ISO 3166-1 code of the country (string of 2 characters) to display.

Either call the flag as with the long call version flag-zz() or short call flag("ZZ"), zz or "ZZ" being the ISO 3166-1 code.

Please note that long call version, like flag-zz(), must use lowercase of the ISO 3166-1 code. Short version can use both lowercase or uppercase of the ISO 3166-1

Example

Hello people coming from #flag-fr(), #flag-eu(), #flag("DE") and more

Hello people coming from France, Europe, Germany and more

Modifying the height

By default the flag height is 0.65em, which is usually the default text size.

To modify the height, include the height parameter in your call.

Either call the flag as flag-zz(height:6em) or flag("ZZ",height:6em), zz or "ZZ" being the ISO 3166-1 code.

Example for height

Hello people coming from #flag-be(height: 1em), #flag-fr(height: 2em), #flag-eu(height:3em), #flag("DE",height: 2em), #flag("LU",height: 1em) and more

Hello people coming from Belgium, France, Europe, Germany, Luxembourg and more

Comments

Coat of arms

Some flags include coat of arms or other specific components. As ususally these components are hard to build in Typst, a SVG version from wikimedia is used. The coat of arms for countries are in directory coat of arms/

Example of coat of arms

Hello people coming from Europe, Spain, Portugal and more

In this example, coats of arms are used for Spanish and Portuguese flags (but not for European flag as stars can be constructed or displayed from an unicode like U+2605)

Width not updatable

For the moment, the official format defined by each country has been used to build their flag (e.g. 1:2 fro GB, 2:3 for FR, 10:19 for US …). No possibility to modify the width has been considered. As a consequence, when you display two or more flags close to each other at the same height, their width might not be equal for each flag.

Flags covered so far

Flags for the following ISO 3166-1 codes are available in the current version (0.2.0):

AD AE AF AG AL AM AO AR AT AU AZ BA BB BD BE BF BG BH BI BJ BN BO BR BS BT BW BY BZ CA CD CF CG CH CI CL CM CN CO CR CU CV CY CZ DE DJ DK DM DO DZ EC EE EG ER ES ET EU FI FJ FM FR GA GB GD GE GH GM GN GQ GR GT GW GY HN HR HT HU ID IE IL IN IQ IR IS IT JM JO JP KE KG KH KM KN KP KR KW KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MG MH MK ML MM MN MR MT MU MV MW MX MY MZ NA NE NG NI NL NO NP NR NZ OM PA PE PG PH PK PL PS PT PW PY QA RO RS RU RW SA SB SC SD SE SG SI SK SL SM SN SO SR SS ST SV SY SZ TD TG TH TJ TL TM TN TO TR TT TV TW TZ UA UG US UY UZ VA VC VE VN VU WS YE ZA ZM ZW

For these flags, comments are welcome

A list of flags

Flags not yet covered so far

The flags for remaining ISO 3166-1 codes have not been developped and might be developped for the next version

KI AS AI AQ AW AX BL BM BQ BV CC CK CW CX EH FK FO GF GG GI GL GP GS GU HK HM IM IO JE KY MF MO MP MQ MS NC NF NU PF PM PN PR RE SH SJ SX TC TF TK UM VG VI WF YT

History

V0.1.0

The inital version of flags, not covering all countries, but mainly independant countries in Europe, America, Africa and Asia.

V0.2.0

Adding some of missing country flags. In this version, only KI is a missing flag of an independant country. The missing flags not covering ISO3166 codes are for specific places (islands, local place …) related to another country.