# Generate Alternative Unicode Representations of A - Z [![[version]](https://badge.fury.io/rb/az.svg)](https://badge.fury.io/rb/az)  [![[ci]](https://github.com/janlelis/az/workflows/Test/badge.svg)](https://github.com/janlelis/az/actions?query=workflow%3ATest)

Going from A to Z in different ways. It will translate Latin ASCII characters to funky Unicode ones.

## Setup

Make sure you have Ruby installed and installing gems works properly. Then do:

```
$ gem install az
```

## Usage

Pass the string to convert to `az`:

### From CLI

```
$ az "character.construction" --to bold
# 𝐜𝐡𝐚𝐫𝐚𝐜𝐭𝐞𝐫.𝐜𝐨𝐧𝐬𝐭𝐫𝐮𝐜𝐭𝐢𝐨𝐧
```

You can also directly copy to your system clipboard using the `--copy` option

To see a list of all fonts included, run: `$ az --fonts`

### From Ruby

```ruby
require "az/kernel_method"
az "character.construction", :fraktur
# => "𝖈𝖍𝖆𝖗𝖆𝖈𝖙𝖊𝖗.𝖈𝖔𝖓𝖘𝖙𝖗𝖚𝖈𝖙𝖎𝖔𝖓"
```

## Included Fonts

**Please note:** Be sure to understand that the output from az does not change the real font, but displays these special "font" codepoints within the actual font.

Font                                | Output
------------------------------------|------------
ascii                               | From A to Z
bold                                | 𝐅𝐫𝐨𝐦 𝐀 𝐭𝐨 𝐙
italic                              | 𝐹𝑟𝑜𝑚 𝐴 𝑡𝑜 𝑍
bold_italic / italic_bold           | 𝑭𝒓𝒐𝒎 𝑨 𝒕𝒐 𝒁
monospace                           | 𝙵𝚛𝚘𝚖 𝙰 𝚝𝚘 𝚉
double                              | Ｆｒｏｍ Ａ ｔｏ Ｚ
sans                                | 𝖥𝗋𝗈𝗆 𝖠 𝗍𝗈 𝖹
sans_bold                           | 𝗙𝗿𝗼𝗺 𝗔 𝘁𝗼 𝗭
sans_italic                         | 𝘍𝘳𝘰𝘮 𝘈 𝘵𝘰 𝘡
sans_bold_italic / sans_italic_bold | 𝙁𝙧𝙤𝙢 𝘼 𝙩𝙤 𝙕
script                              | ℱ𝓇ℴ𝓂 𝒜 𝓉ℴ 𝒵
bold_script / script_bold           | 𝓕𝓻𝓸𝓶 𝓐 𝓽𝓸 𝓩
fraktur                             | 𝔉𝔯𝔬𝔪 𝔄 𝔱𝔬 ℨ
bold_fraktur / fraktur_bold         | 𝕱𝖗𝖔𝖒 𝕬 𝖙𝖔 𝖅
parentheses                         | 🄕⒭⒪⒨ 🄐 ⒯⒪ 🄩
small_caps                          | Fʀᴏᴍ A ᴛᴏ Z
double_struck                       | 𝔽𝕣𝕠𝕞 𝔸 𝕥𝕠 ℤ
circled                             | Ⓕⓡⓞⓜ Ⓐ ⓣⓞ Ⓩ
circled_upper / upper_circled       | ⒻⓇⓄⓂ Ⓐ ⓉⓄ Ⓩ
circled_negative / negative_circled | 🅕🅡🅞🅜 🅐 🅣🅞 🅩
squared_upper / upper_squared       | 🄵🅁🄾🄼 🄰 🅃🄾 🅉
squared_negative / negative_squared | 🅵🆁🅾🅼 🅰 🆃🅾 🆉
region                              | 🇫🇷🇴🇲 🇦 🇹🇴 🇿
tag                                 | `󠁆󠁲󠁯󠁭 󠁁 󠁴󠁯 󠁚`

## Also see

- [character.construction/az](https://character.construction/az)
- CLI: [uniscribe](https://github.com/janlelis/uniscribe)

Copyright (C) 2019-2021 Jan Lelis <https://janlelis.com>. Released under the MIT license.