Update documentation

Ponomar/CuConverter.xba

@@ -155,9 +155,9 @@ Sub HIPToUnicode
 	Dim aFind, aReplace
 
 	aFind = Array("A", "a", "B", "b", "E", "e", "K", "k", "M", "m", "H", "h", "O", "o", "P", "p", "C", "c", "T", "t", "Y", "y", "X", "x", "І", "і", "jь", "Jь", "JЬ", "<кс>", "<КС>", "<Кс>", "ju", "<е>", "<Е>", "s", "S", "v""", "V""", "v", "V", "f", "F", "u", "<i>", "_i", "i", "<i_>", "_е", "_Е", "_кс", "_КС", "_Кс", "<о>", "<О>", "_о", "_О", "w\т", "W\т", "W\Т", "<w>", "<W>", "_w", "_W", "w", "W", "<пс>", "<ПС>", "<Пс>", "_пс", "_ПС", "_Пс", "о<у>", "о_у", "О<у>", "О_у", "<у>", "_у", "у", "У", "jа", "JА", "Jа", "я", "Я", "<а>", "<г>", "<Г>", "<д>", "<дг>", "<ДГ>", "<дж>", "<ДЖ>", "jе", "JЕ", "Jе", "jjь", "JJЬ", "<jь>", "</jь>", "<sг>", "<s->", "<s>", "<з>", "g", "<лг>", "<нг>", "<оо>", "<о+>", "<о.о.>", "<о.>", "<о:>", "<о_>", "<_w>", "<с>", "<т>", "<|т|>", "<оv>", "<ч>", "q", "<ъ>", "<ы>", "<ьi_>", "<ъi_>", "<ьи>", "<ъи>", "<ь-i>", "<ъ-i>", "<ь-i_>", "<ъ-i_>", "<ь-и>", "<ъ-и>", "э", "Э", "<ю>", "ю@", "I", "<jа>", "jя", "<яu>", "<я.>", "<я>", "<я_>", "<u>", "<ын>", "=", "'", "^", "`", "~", """", "\ъ", "\Ъ", "\б", "\Б", "\в", "\В", "\г", "\Г", "\д", "\Д", "\ж", "\Ж", "\з", "\З", "\к", "\К", "\л", "\Л", "\м", "\М", "\н", "\Н", "\о", "\О", "\п", "\П", "\р", "\Р", "\с", "\С", "\т", "\Т", "\х", "\Х", "\ф", "\Ф", "\ц", "\Ц", "\ч", "\Ч", "\ш", "\Ш", "\щ", "\Щ", "\f", "\F", "\а", "\А", "\е", "\Е", "\g", "\G", "\у", "\У", "\jе", "\ю", "\Ю", "\jа", "\я", "\Я", "\u", "\U", "\ju", "\и", "\И", "\^", "\-", "#", "@", "+", "*", "<*>", "<тьматем>", "<->", "<тьма>&", "<легион>&", "<леодр>&", "<вран>&", "<колода>&", "<>", "_/", "<_>", "__", "<|>", "&", "%-", "<((>", "<))>")
-	aReplace = Array(chr(&H0410), chr(&H0430), chr(&H0412), chr(&H0432), chr(&H0045), chr(&H0435), chr(&H041A), chr(&H043A), chr(&H041C), chr(&H043C), chr(&H041D), chr(&H043D), chr(&H041E), chr(&H043E), chr(&H0420), chr(&H0440), chr(&H0421), chr(&H0441), chr(&H0422), chr(&H0442), chr(&H0423), chr(&H0443), chr(&H0425), chr(&H0445), chr(&H0049), chr(&H0069), chr(&H0463), chr(&H0462), chr(&H0462), chr(&H046F), chr(&H046E), chr(&H046E), chr(&H046D), chr(&H0454), chr(&H0404), chr(&H0455), chr(&H0405), chr(&H0477), chr(&H0476), chr(&H0475), chr(&H0474), chr(&H0473), chr(&H0472), chr(&H046B), chr(&H0456), chr(&HF8FF), chr(&H0456), chr(&HA647), chr(&H0454), chr(&H0404), chr(&H046F), chr(&H046E), chr(&H046E), chr(&H047B), chr(&H047A), chr(&H047B), chr(&H047A), chr(&H047F), chr(&H047E), chr(&H047E), chr(&H047D), chr(&H047C), chr(&H047D), chr(&H047C), chr(&H0461), chr(&H0460), chr(&H0471), chr(&H0470), chr(&H0470), chr(&H0471), chr(&H0470), chr(&H0470), chr(&H1C82) & chr(&H0443), chr(&H1C82) & chr(&H0443), chr(&H041E) & chr(&H0443), chr(&H041E) & chr(&H0443), chr(&H0443), chr(&H0443), chr(&HA64B), chr(&HA64A), chr(&HA657), chr(&HA656), chr(&HA656), chr(&H0467), chr(&H0466), chr(&HFFFD), chr(&H0491), chr(&H0490), chr(&H1C81), chr(&HA663), chr(&HA662), chr(&H045F), chr(&H040F), chr(&H0465), chr(&H0464), chr(&H0464), chr(&HA653), chr(&HA652), chr(&H1C87), chr(&HFFFD), chr(&HA643), chr(&HA643), chr(&HA645), chr(&HA641), chr(&HA649), chr(&HA665), chr(&H04A5), chr(&HA699), chr(&HA69B), chr(&HA66D), chr(&HA669), chr(&HA66B), chr(&H1C82), chr(&HA64D), chr(&H1C83), chr(&H1C84), chr(&H1C85), chr(&H1C88), chr(&H0447), chr(&H0481), chr(&H1C86), chr(&HA651), chr(&H044C) & chr(&HA647), chr(&H044A) & chr(&HA647), chr(&H044C) & chr(&H0438), chr(&H044A) & chr(&H0438), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&H044D), chr(&H042D), chr(&HA655), chr(&H044E) & chr(&H0306), chr(&H0406), chr(&HA657), chr(&H0469), chr(&HA65B), chr(&HFFFD), chr(&HA659), chr(&HFFFD), chr(&HFFFD), chr(&HA65F), chr(&H0486), chr(&H0301), chr(&H0311), chr(&H0300), chr(&H0483), chr(&H030F), chr(&H033E), chr(&H033E), chr(&H2DE0) & chr(&H0487), chr(&H2DE0) & chr(&H0487), chr(&H2DE1) & chr(&H0487), chr(&H2DE1) & chr(&H0487), chr(&H2DE2) & chr(&H0487), chr(&H2DE2) & chr(&H0487), chr(&H2DE3), chr(&H2DE3), chr(&H2DE4), chr(&H2DE4), chr(&H2DE5), chr(&H2DE5), chr(&H2DE6) & chr(&H0487), chr(&H2DE6) & chr(&H0487), chr(&H2DE7) & chr(&H0487), chr(&H2DE7) & chr(&H0487), chr(&H2DE8), chr(&H2DE8), chr(&H2DE9) & chr(&H0487), chr(&H2DE9) & chr(&H0487), chr(&H2DEA) & chr(&H0487), chr(&H2DEA) & chr(&H0487), chr(&H2DEB), chr(&H2DE8), chr(&H2DEC) & chr(&H0487), chr(&H2DEC) & chr(&H0487), chr(&H2DED) & chr(&H0487), chr(&H2DED) & chr(&H0487), chr(&H2DEE), chr(&H2DEE), chr(&H2DEF), chr(&H2DEF), chr(&HA69E) & chr(&H0487), chr(&HA69E) & chr(&H0487), chr(&H2DF0), chr(&H2DF0), chr(&H2DF1) & chr(&H0487), chr(&H2DF1) & chr(&H0487), chr(&H2DF2) & chr(&H0487), chr(&H2DF2) & chr(&H0487), chr(&H2DF3) & chr(&H0487), chr(&H2DF3) & chr(&H0487), chr(&H2DF4) & chr(&H0487), chr(&H2DF4) & chr(&H0487), chr(&H2DF6) & chr(&H0487), chr(&H2DF6) & chr(&H0487), chr(&H2DF7), chr(&H2DF7), chr(&H2DF8), chr(&H2DF8), chr(&H2DF9), chr(&H2DF9), chr(&H2DFA), chr(&H2DFB), chr(&H2DFB), chr(&H2DFC), chr(&H2DFD), chr(&H2DFD), chr(&H2DFE), chr(&H2DFE), chr(&H2DFF), chr(&HA675), chr(&HA675), chr(&H0487), chr(&H0487), chr(&H0482), chr(&HA67E), chr(&H2020), chr(&HA673), chr(&HA673), chr(&H044B) & chr(&HA672), chr(&H2013), chr(&H20DD), chr(&H0488), chr(&H0489), chr(&HA670), chr(&HA671), chr(&H000A) & chr(&H000A), chr(&H000A) & chr(&H000A), chr(&H200B), chr(&H200B), chr(&H034F), chr(&H200D), chr(&H00AD), chr(&H00AB), chr(&H00BB))
+	aReplace = Array(chr(&H0410), chr(&H0430), chr(&H0412), chr(&H0432), chr(&H0045), chr(&H0435), chr(&H041A), chr(&H043A), chr(&H041C), chr(&H043C), chr(&H041D), chr(&H043D), chr(&H041E), chr(&H043E), chr(&H0420), chr(&H0440), chr(&H0421), chr(&H0441), chr(&H0422), chr(&H0442), chr(&H0423), chr(&H0443), chr(&H0425), chr(&H0445), chr(&H0049), chr(&H0069), chr(&H0463), chr(&H0462), chr(&H0462), chr(&H046F), chr(&H046E), chr(&H046E), chr(&H046D), chr(&H0454), chr(&H0404), chr(&H0455), chr(&H0405), chr(&H0477), chr(&H0476), chr(&H0475), chr(&H0474), chr(&H0473), chr(&H0472), chr(&H046B), chr(&H0456), chr(&H0456), chr(&H0456), chr(&HA647), chr(&H0454), chr(&H0404), chr(&H046F), chr(&H046E), chr(&H046E), chr(&H047B), chr(&H047A), chr(&H047B), chr(&H047A), chr(&H047F), chr(&H047E), chr(&H047E), chr(&H047D), chr(&H047C), chr(&H047D), chr(&H047C), chr(&H0461), chr(&H0460), chr(&H0471), chr(&H0470), chr(&H0470), chr(&H0471), chr(&H0470), chr(&H0470), chr(&H1C82) & chr(&H0443), chr(&H1C82) & chr(&H0443), chr(&H041E) & chr(&H0443), chr(&H041E) & chr(&H0443), chr(&H0443), chr(&H0443), chr(&HA64B), chr(&HA64A), chr(&HA657), chr(&HA656), chr(&HA656), chr(&H0467), chr(&H0466), chr(&HFFFD), chr(&H0491), chr(&H0490), chr(&H1C81), chr(&HA663), chr(&HA662), chr(&H045F), chr(&H040F), chr(&H0465), chr(&H0464), chr(&H0464), chr(&HA653), chr(&HA652), chr(&H1C87), chr(&HFFFD), chr(&HA643), chr(&HA643), chr(&HA645), chr(&HA641), chr(&HA649), chr(&HA665), chr(&H04A5), chr(&HA699), chr(&HA69B), chr(&HA66D), chr(&HA669), chr(&HA66B), chr(&H1C82), chr(&HA64D), chr(&H1C83), chr(&H1C84), chr(&H1C85), chr(&H1C88), chr(&H0447), chr(&H0481), chr(&H1C86), chr(&HA651), chr(&H044C) & chr(&HA647), chr(&H044A) & chr(&HA647), chr(&H044C) & chr(&H0438), chr(&H044A) & chr(&H0438), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&HFFFD), chr(&H044D), chr(&H042D), chr(&HA655), chr(&H044E) & chr(&H0306), chr(&H0406), chr(&HA657), chr(&H0469), chr(&HA65B), chr(&HFFFD), chr(&HA659), chr(&HFFFD), chr(&HFFFD), chr(&HA65F), chr(&H0486), chr(&H0301), chr(&H0311), chr(&H0300), chr(&H0483), chr(&H030F), chr(&H033E), chr(&H033E), chr(&H2DE0) & chr(&H0487), chr(&H2DE0) & chr(&H0487), chr(&H2DE1) & chr(&H0487), chr(&H2DE1) & chr(&H0487), chr(&H2DE2) & chr(&H0487), chr(&H2DE2) & chr(&H0487), chr(&H2DE3), chr(&H2DE3), chr(&H2DE4), chr(&H2DE4), chr(&H2DE5), chr(&H2DE5), chr(&H2DE6) & chr(&H0487), chr(&H2DE6) & chr(&H0487), chr(&H2DE7) & chr(&H0487), chr(&H2DE7) & chr(&H0487), chr(&H2DE8), chr(&H2DE8), chr(&H2DE9) & chr(&H0487), chr(&H2DE9) & chr(&H0487), chr(&H2DEA) & chr(&H0487), chr(&H2DEA) & chr(&H0487), chr(&H2DEB), chr(&H2DE8), chr(&H2DEC) & chr(&H0487), chr(&H2DEC) & chr(&H0487), chr(&H2DED) & chr(&H0487), chr(&H2DED) & chr(&H0487), chr(&H2DEE), chr(&H2DEE), chr(&H2DEF), chr(&H2DEF), chr(&HA69E) & chr(&H0487), chr(&HA69E) & chr(&H0487), chr(&H2DF0), chr(&H2DF0), chr(&H2DF1) & chr(&H0487), chr(&H2DF1) & chr(&H0487), chr(&H2DF2) & chr(&H0487), chr(&H2DF2) & chr(&H0487), chr(&H2DF3) & chr(&H0487), chr(&H2DF3) & chr(&H0487), chr(&H2DF4) & chr(&H0487), chr(&H2DF4) & chr(&H0487), chr(&H2DF6) & chr(&H0487), chr(&H2DF6) & chr(&H0487), chr(&H2DF7), chr(&H2DF7), chr(&H2DF8), chr(&H2DF8), chr(&H2DF9), chr(&H2DF9), chr(&H2DFA), chr(&H2DFB), chr(&H2DFB), chr(&H2DFC), chr(&H2DFD), chr(&H2DFD), chr(&H2DFE), chr(&H2DFE), chr(&H2DFF), chr(&HA675), chr(&HA675), chr(&H0487), chr(&H0487), chr(&H0482), chr(&HA67E), chr(&H2020), chr(&HA673), chr(&HA673), chr(&H044B) & chr(&HA672), chr(&H2013), chr(&H20DD), chr(&H0488), chr(&H0489), chr(&HA670), chr(&HA671), chr(&H000A) & chr(&H000A), chr(&H000A) & chr(&H000A), chr(&H200B), chr(&H200B), chr(&H034F), chr(&H200D), chr(&H00AD), chr(&H00AB), chr(&H00BB))
 	Convert(aFind, aReplace)
 End Sub
 
 
-</script:module>
+</script:module>

README.md

@@ -5,3 +5,23 @@ Church Slavonic codepage conversion for LibreOffice
 ```
 make
 ```
+
+Install the resulting oxt file into LibreOffice.
+
+## To Use
+Once installed, the Extension will add a submenu under Tools -> Add-Ons
+
+To convert an entire document, just select the necessary conversion
+from Tools -> Add-Ons -> Church Slavonic Conversion
+(for example, UCS to Unicode).
+
+You may also convert a selection of text: make a selection, and choose
+the conversion option from Tools -> Add-Ons -> Church Slavonic Conversion.
+
+### Supported Conversion formats
+Converts between the following formats:
+
+1. HIP to Unicode [http://orthlib.ru/hip/](description of HIP format) 
+2. UCS to Unicode [http://irmologion.ru/ucsenc/ucsenc.html](description of UCS, that is -- Irmologion)
+3. Old Cyrillic Times font to Unicode (a legacy codepage used by some in the USA in the 90s)
+