From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- .../contrib/unicode-alphabets/docs/example.pdf | Bin 0 -> 46017 bytes .../contrib/unicode-alphabets/docs/example.tex | 91 +++++ .../contrib/unicode-alphabets/docs/license.txt | 435 +++++++++++++++++++++ .../contrib/unicode-alphabets/docs/specimen.pdf | Bin 0 -> 650744 bytes .../contrib/unicode-alphabets/docs/specimen.tex | 128 ++++++ .../unicode-alphabets/docs/unicode-alphabets.bib | 46 +++ .../unicode-alphabets/docs/unicode-alphabets.pdf | Bin 0 -> 71574 bytes .../unicode-alphabets/docs/unicode-alphabets.tex | 119 ++++++ 8 files changed, 819 insertions(+) create mode 100644 macros/latex/contrib/unicode-alphabets/docs/example.pdf create mode 100644 macros/latex/contrib/unicode-alphabets/docs/example.tex create mode 100644 macros/latex/contrib/unicode-alphabets/docs/license.txt create mode 100644 macros/latex/contrib/unicode-alphabets/docs/specimen.pdf create mode 100644 macros/latex/contrib/unicode-alphabets/docs/specimen.tex create mode 100644 macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.bib create mode 100644 macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.pdf create mode 100644 macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.tex (limited to 'macros/latex/contrib/unicode-alphabets/docs') diff --git a/macros/latex/contrib/unicode-alphabets/docs/example.pdf b/macros/latex/contrib/unicode-alphabets/docs/example.pdf new file mode 100644 index 0000000000..995cffa52a Binary files /dev/null and b/macros/latex/contrib/unicode-alphabets/docs/example.pdf differ diff --git a/macros/latex/contrib/unicode-alphabets/docs/example.tex b/macros/latex/contrib/unicode-alphabets/docs/example.tex new file mode 100644 index 0000000000..7c7d774d05 --- /dev/null +++ b/macros/latex/contrib/unicode-alphabets/docs/example.tex @@ -0,0 +1,91 @@ +% !TEX TS-program = lualatex +\documentclass{article} + +\usepackage{fontspec} +\newfontfamily\mufifont{Palemonas MUFI} +\newfontfamily\titusfont{TITUS Cyberbit Basic} + +\usepackage[ + CYFI, + MUFI, + TITUS, +% disable entity macros, + fonts={ + CYFI=\titusfont, + MUFI=\mufifont, + TITUS=\titusfont, + }, +]{unicode-alphabets} + +\setlength{\parindent}{0pt} + +\newcommand\display[1]{% + \texttt{\ignorespaces\detokenize{#1}}: \fbox{#1}% +} + +\begin{document} + +\section{Normal Unicode characters} +\display{Ā} --- +\display{B} --- +\display{Ċ} --- +\display{ā} --- +\display{b} --- +\display{ċ} --- + +\section{MUFI 3.0 characters} +\display{\mufi{FLOURISHED SMALL LETTER M SIGN}}\\ +\display{\msignflour{}} --- +\display{\mufi{msignflour}} --- +\display{\mufi{F2F3}} + +\vspace{8pt} +\display{\mufi{LATIN SMALL LETTER Y WITH RIGHT MAIN STROKE}}\\ +\display{\yrgmainstrok{}} --- +\display{\mufi{yrgmainstrok}} --- +\display{\mufi{F233}} + +\section{MUFI 4.0 characters} +Note that the currently installed Palemonas MUFI font on this machine does not have the OEligogon character. + +\vspace{12pt} +\display{\mufi{LATIN CAPITAL LIGATURE OE WITH OGONEK}}\\ +\display{\OEligogon{}} --- +\display{\mufi{OEligogon}} --- +\display{\mufi{E262}} + +\vspace{8pt} +\display{\mufi{LATIN CAPITAL LIGATURE UU}}\\ +\display{\UUlig{}} --- +\display{\mufi{UUlig}} --- +\display{\mufi{E8C6}} + +\vspace{8pt} +\display{\mufi{HELBING SIGN}}\\ +\display{\helbing{}} --- +\display{\mufi{helbing}} --- +\display{\mufi{F2FB}} + + +\section{Starred vs. unstarred} +The unstarred commands use the configured font, whereas the starred version simply uses the current document font. Note the difference in the \@ signs as well as the missing \texttt{msignflour} in the document font. + +\vspace{12pt} +\display{\mufi{0040}} --- +\display{\mufi*{0040}} + +\display{\mufi{0041}} --- +\display{\mufi*{0041}} + +\display{\msignflour{}} --- +\display{\msignflour*{}} + +\section{CYFI characters} +\display{\cyfi{CYRILLIC CAPITAL LETTER REVERSED A}}\\ +\display{\cyfi{F330}} + +\section{TITUS characters} +\display{\titus{LATIN CAPITAL LETTER SCHWA WITH MACRON}}\\ +\display{\titus{E3EC}} + +\end{document} diff --git a/macros/latex/contrib/unicode-alphabets/docs/license.txt b/macros/latex/contrib/unicode-alphabets/docs/license.txt new file mode 100644 index 0000000000..9cc9c67904 --- /dev/null +++ b/macros/latex/contrib/unicode-alphabets/docs/license.txt @@ -0,0 +1,435 @@ +This LaTeX package and associated files is hereby released under the +CC-BY-SA 4.0 license. + +Mikkel Eide Eriksen, July 19, 2019 +mikkel.eriksen@gmail.com + +======================================================================= + +Attribution-ShareAlike 4.0 International + +======================================================================= + +Creative Commons Corporation ("Creative Commons") is not a law firm and +does not provide legal services or legal advice. Distribution of +Creative Commons public licenses does not create a lawyer-client or +other relationship. Creative Commons makes its licenses and related +information available on an "as-is" basis. Creative Commons gives no +warranties regarding its licenses, any material licensed under their +terms and conditions, or any related information. Creative Commons +disclaims all liability for damages resulting from their use to the +fullest extent possible. + +Using Creative Commons Public Licenses + +Creative Commons public licenses provide a standard set of terms and +conditions that creators and other rights holders may use to share +original works of authorship and other material subject to copyright +and certain other rights specified in the public license below. The +following considerations are for informational purposes only, are not +exhaustive, and do not form part of our licenses. + + Considerations for licensors: Our public licenses are + intended for use by those authorized to give the public + permission to use material in ways otherwise restricted by + copyright and certain other rights. Our licenses are + irrevocable. Licensors should read and understand the terms + and conditions of the license they choose before applying it. + Licensors should also secure all rights necessary before + applying our licenses so that the public can reuse the + material as expected. Licensors should clearly mark any + material not subject to the license. This includes other CC- + licensed material, or material used under an exception or + limitation to copyright. More considerations for licensors: + wiki.creativecommons.org/Considerations_for_licensors + + Considerations for the public: By using one of our public + licenses, a licensor grants the public permission to use the + licensed material under specified terms and conditions. If + the licensor's permission is not necessary for any reason--for + example, because of any applicable exception or limitation to + copyright--then that use is not regulated by the license. Our + licenses grant only permissions under copyright and certain + other rights that a licensor has authority to grant. Use of + the licensed material may still be restricted for other + reasons, including because others have copyright or other + rights in the material. A licensor may make special requests, + such as asking that all changes be marked or described. + Although not required by our licenses, you are encouraged to + respect those requests where reasonable. More considerations + for the public: + wiki.creativecommons.org/Considerations_for_licensees + +======================================================================= + +Creative Commons Attribution-ShareAlike 4.0 International Public +License + +By exercising the Licensed Rights (defined below), You accept and agree +to be bound by the terms and conditions of this Creative Commons +Attribution-ShareAlike 4.0 International Public License ("Public +License"). To the extent this Public License may be interpreted as a +contract, You are granted the Licensed Rights in consideration of Your +acceptance of these terms and conditions, and the Licensor grants You +such rights in consideration of benefits the Licensor receives from +making the Licensed Material available under these terms and +conditions. + + +Section 1 -- Definitions. + + a. Adapted Material means material subject to Copyright and Similar + Rights that is derived from or based upon the Licensed Material + and in which the Licensed Material is translated, altered, + arranged, transformed, or otherwise modified in a manner requiring + permission under the Copyright and Similar Rights held by the + Licensor. For purposes of this Public License, where the Licensed + Material is a musical work, performance, or sound recording, + Adapted Material is always produced where the Licensed Material is + synched in timed relation with a moving image. + + b. Adapter's License means the license You apply to Your Copyright + and Similar Rights in Your contributions to Adapted Material in + accordance with the terms and conditions of this Public License. + + c. BY-SA Compatible License means a license listed at + creativecommons.org/compatiblelicenses, approved by Creative + Commons as essentially the equivalent of this Public License. + + d. Copyright and Similar Rights means copyright and/or similar rights + closely related to copyright including, without limitation, + performance, broadcast, sound recording, and Sui Generis Database + Rights, without regard to how the rights are labeled or + categorized. For purposes of this Public License, the rights + specified in Section 2(b)(1)-(2) are not Copyright and Similar + Rights. + + e. Effective Technological Measures means those measures that, in the + absence of proper authority, may not be circumvented under laws + fulfilling obligations under Article 11 of the WIPO Copyright + Treaty adopted on December 20, 1996, and/or similar international + agreements. + + f. Exceptions and Limitations means fair use, fair dealing, and/or + any other exception or limitation to Copyright and Similar Rights + that applies to Your use of the Licensed Material. + + g. License Elements means the license attributes listed in the name + of a Creative Commons Public License. The License Elements of this + Public License are Attribution and ShareAlike. + + h. Licensed Material means the artistic or literary work, database, + or other material to which the Licensor applied this Public + License. + + i. Licensed Rights means the rights granted to You subject to the + terms and conditions of this Public License, which are limited to + all Copyright and Similar Rights that apply to Your use of the + Licensed Material and that the Licensor has authority to license. + + j. Licensor means the individual(s) or entity(ies) granting rights + under this Public License. + + k. Share means to provide material to the public by any means or + process that requires permission under the Licensed Rights, such + as reproduction, public display, public performance, distribution, + dissemination, communication, or importation, and to make material + available to the public including in ways that members of the + public may access the material from a place and at a time + individually chosen by them. + + l. Sui Generis Database Rights means rights other than copyright + resulting from Directive 96/9/EC of the European Parliament and of + the Council of 11 March 1996 on the legal protection of databases, + as amended and/or succeeded, as well as other essentially + equivalent rights anywhere in the world. + + m. You means the individual or entity exercising the Licensed Rights + under this Public License. Your has a corresponding meaning. + + +Section 2 -- Scope. + + a. License grant. + + 1. Subject to the terms and conditions of this Public License, + the Licensor hereby grants You a worldwide, royalty-free, + non-sublicensable, non-exclusive, irrevocable license to + exercise the Licensed Rights in the Licensed Material to: + + a. reproduce and Share the Licensed Material, in whole or + in part; and + + b. produce, reproduce, and Share Adapted Material. + + 2. Exceptions and Limitations. For the avoidance of doubt, where + Exceptions and Limitations apply to Your use, this Public + License does not apply, and You do not need to comply with + its terms and conditions. + + 3. Term. The term of this Public License is specified in Section + 6(a). + + 4. Media and formats; technical modifications allowed. The + Licensor authorizes You to exercise the Licensed Rights in + all media and formats whether now known or hereafter created, + and to make technical modifications necessary to do so. The + Licensor waives and/or agrees not to assert any right or + authority to forbid You from making technical modifications + necessary to exercise the Licensed Rights, including + technical modifications necessary to circumvent Effective + Technological Measures. For purposes of this Public License, + simply making modifications authorized by this Section 2(a) + (4) never produces Adapted Material. + + 5. Downstream recipients. + + a. Offer from the Licensor -- Licensed Material. Every + recipient of the Licensed Material automatically + receives an offer from the Licensor to exercise the + Licensed Rights under the terms and conditions of this + Public License. + + b. Additional offer from the Licensor -- Adapted Material. + Every recipient of Adapted Material from You + automatically receives an offer from the Licensor to + exercise the Licensed Rights in the Adapted Material + under the conditions of the Adapter's License You apply. + + c. No downstream restrictions. You may not offer or impose + any additional or different terms or conditions on, or + apply any Effective Technological Measures to, the + Licensed Material if doing so restricts exercise of the + Licensed Rights by any recipient of the Licensed + Material. + + 6. No endorsement. Nothing in this Public License constitutes or + may be construed as permission to assert or imply that You + are, or that Your use of the Licensed Material is, connected + with, or sponsored, endorsed, or granted official status by, + the Licensor or others designated to receive attribution as + provided in Section 3(a)(1)(A)(i). + + b. Other rights. + + 1. Moral rights, such as the right of integrity, are not + licensed under this Public License, nor are publicity, + privacy, and/or other similar personality rights; however, to + the extent possible, the Licensor waives and/or agrees not to + assert any such rights held by the Licensor to the limited + extent necessary to allow You to exercise the Licensed + Rights, but not otherwise. + + 2. Patent and trademark rights are not licensed under this + Public License. + + 3. To the extent possible, the Licensor waives any right to + collect royalties from You for the exercise of the Licensed + Rights, whether directly or through a collecting society + under any voluntary or waivable statutory or compulsory + licensing scheme. In all other cases the Licensor expressly + reserves any right to collect such royalties. + + +Section 3 -- License Conditions. + +Your exercise of the Licensed Rights is expressly made subject to the +following conditions. + + a. Attribution. + + 1. If You Share the Licensed Material (including in modified + form), You must: + + a. retain the following if it is supplied by the Licensor + with the Licensed Material: + + i. identification of the creator(s) of the Licensed + Material and any others designated to receive + attribution, in any reasonable manner requested by + the Licensor (including by pseudonym if + designated); + + ii. a copyright notice; + + iii. a notice that refers to this Public License; + + iv. a notice that refers to the disclaimer of + warranties; + + v. a URI or hyperlink to the Licensed Material to the + extent reasonably practicable; + + b. indicate if You modified the Licensed Material and + retain an indication of any previous modifications; and + + c. indicate the Licensed Material is licensed under this + Public License, and include the text of, or the URI or + hyperlink to, this Public License. + + 2. You may satisfy the conditions in Section 3(a)(1) in any + reasonable manner based on the medium, means, and context in + which You Share the Licensed Material. For example, it may be + reasonable to satisfy the conditions by providing a URI or + hyperlink to a resource that includes the required + information. + + 3. If requested by the Licensor, You must remove any of the + information required by Section 3(a)(1)(A) to the extent + reasonably practicable. + + b. ShareAlike. + + In addition to the conditions in Section 3(a), if You Share + Adapted Material You produce, the following conditions also apply. + + 1. The Adapter's License You apply must be a Creative Commons + license with the same License Elements, this version or + later, or a BY-SA Compatible License. + + 2. You must include the text of, or the URI or hyperlink to, the + Adapter's License You apply. You may satisfy this condition + in any reasonable manner based on the medium, means, and + context in which You Share Adapted Material. + + 3. You may not offer or impose any additional or different terms + or conditions on, or apply any Effective Technological + Measures to, Adapted Material that restrict exercise of the + rights granted under the Adapter's License You apply. + + +Section 4 -- Sui Generis Database Rights. + +Where the Licensed Rights include Sui Generis Database Rights that +apply to Your use of the Licensed Material: + + a. for the avoidance of doubt, Section 2(a)(1) grants You the right + to extract, reuse, reproduce, and Share all or a substantial + portion of the contents of the database; + + b. if You include all or a substantial portion of the database + contents in a database in which You have Sui Generis Database + Rights, then the database in which You have Sui Generis Database + Rights (but not its individual contents) is Adapted Material, + + including for purposes of Section 3(b); and + c. You must comply with the conditions in Section 3(a) if You Share + all or a substantial portion of the contents of the database. + +For the avoidance of doubt, this Section 4 supplements and does not +replace Your obligations under this Public License where the Licensed +Rights include other Copyright and Similar Rights. + + +Section 5 -- Disclaimer of Warranties and Limitation of Liability. + + a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE + EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS + AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF + ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, + IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, + WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR + PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, + ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT + KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT + ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. + + b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE + TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, + NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, + INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, + COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR + USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN + ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR + DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR + IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. + + c. The disclaimer of warranties and limitation of liability provided + above shall be interpreted in a manner that, to the extent + possible, most closely approximates an absolute disclaimer and + waiver of all liability. + + +Section 6 -- Term and Termination. + + a. This Public License applies for the term of the Copyright and + Similar Rights licensed here. However, if You fail to comply with + this Public License, then Your rights under this Public License + terminate automatically. + + b. Where Your right to use the Licensed Material has terminated under + Section 6(a), it reinstates: + + 1. automatically as of the date the violation is cured, provided + it is cured within 30 days of Your discovery of the + violation; or + + 2. upon express reinstatement by the Licensor. + + For the avoidance of doubt, this Section 6(b) does not affect any + right the Licensor may have to seek remedies for Your violations + of this Public License. + + c. For the avoidance of doubt, the Licensor may also offer the + Licensed Material under separate terms or conditions or stop + distributing the Licensed Material at any time; however, doing so + will not terminate this Public License. + + d. Sections 1, 5, 6, 7, and 8 survive termination of this Public + License. + + +Section 7 -- Other Terms and Conditions. + + a. The Licensor shall not be bound by any additional or different + terms or conditions communicated by You unless expressly agreed. + + b. Any arrangements, understandings, or agreements regarding the + Licensed Material not stated herein are separate from and + independent of the terms and conditions of this Public License. + + +Section 8 -- Interpretation. + + a. For the avoidance of doubt, this Public License does not, and + shall not be interpreted to, reduce, limit, restrict, or impose + conditions on any use of the Licensed Material that could lawfully + be made without permission under this Public License. + + b. To the extent possible, if any provision of this Public License is + deemed unenforceable, it shall be automatically reformed to the + minimum extent necessary to make it enforceable. If the provision + cannot be reformed, it shall be severed from this Public License + without affecting the enforceability of the remaining terms and + conditions. + + c. No term or condition of this Public License will be waived and no + failure to comply consented to unless expressly agreed to by the + Licensor. + + d. Nothing in this Public License constitutes or may be interpreted + as a limitation upon, or waiver of, any privileges and immunities + that apply to the Licensor or You, including from the legal + processes of any jurisdiction or authority. + + +======================================================================= + +Creative Commons is not a party to its public +licenses. Notwithstanding, Creative Commons may elect to apply one of +its public licenses to material it publishes and in those instances +will be considered the “Licensor.” The text of the Creative Commons +public licenses is dedicated to the public domain under the CC0 Public +Domain Dedication. Except for the limited purpose of indicating that +material is shared under a Creative Commons public license or as +otherwise permitted by the Creative Commons policies published at +creativecommons.org/policies, Creative Commons does not authorize the +use of the trademark "Creative Commons" or any other trademark or logo +of Creative Commons without its prior written consent including, +without limitation, in connection with any unauthorized modifications +to any of its public licenses or any other arrangements, +understandings, or agreements concerning use of licensed material. For +the avoidance of doubt, this paragraph does not form part of the +public licenses. + +Creative Commons may be contacted at creativecommons.org. diff --git a/macros/latex/contrib/unicode-alphabets/docs/specimen.pdf b/macros/latex/contrib/unicode-alphabets/docs/specimen.pdf new file mode 100644 index 0000000000..94386650f8 Binary files /dev/null and b/macros/latex/contrib/unicode-alphabets/docs/specimen.pdf differ diff --git a/macros/latex/contrib/unicode-alphabets/docs/specimen.tex b/macros/latex/contrib/unicode-alphabets/docs/specimen.tex new file mode 100644 index 0000000000..9962b8a81b --- /dev/null +++ b/macros/latex/contrib/unicode-alphabets/docs/specimen.tex @@ -0,0 +1,128 @@ +% !TEX TS-program = lualatex +\documentclass{book} +\usepackage[ + a4paper, + margin=1in, + landscape +]{geometry} + +\usepackage{csvsimple} +\usepackage{xltabular} +\usepackage{booktabs} +\usepackage{pgfkeys} +\usepackage{stringstrings} +\usepackage[ + hidelinks, +]{hyperref} + +\include{csvsimple.tmp.patch} + +\title{Unicode Alphabets for \LaTeX\\\bigskip\large Specimen} +\author{Mikkel Eide Eriksen} + +\usepackage{fontspec} +\newfontfamily\mufifont{Palemonas MUFI} +\newfontfamily\silfont{Doulos SIL} +\newfontfamily\titusfont{TITUS Cyberbit Basic} +\newfontfamily\unzfont{LUC.EnsisheimU1A} + +\usepackage[ +% CYFI, + MUFI, + SIL, + TITUS, + UNZ, +% disable entity macros, + fonts={ +% CYFI=\titusfont, + MUFI=\mufifont, + SIL=\silfont, + TITUS=\titusfont, + UNZ=\unzfont, + }, +]{unicode-alphabets} + +\makeatletter +\newcommand\specset[1]{\pgfkeys{/specimen/.cd,#1}} + +\newcommand\spec@showfont[1]{% + {% + #1% + \edef\currentfontname{\f@family}\currentfontname + }% +} + +\specset{ + character set/.code={ + \csedef{spec@charset}{#1}% + \caselower[q]{\spec@charset}% + \csedef{spec@code}{\thestring}% + \csedef{spec@csvfile}{unicode-alphabets.\spec@code.csv}% + }, + font url/.store in=\spec@font@url, +} + +\newcommand\specimen[1]{% + \specset{#1}% + \chapter*{\spec@charset} + \addcontentsline{toc}{chapter}{\spec@charset} + + Using the font \spec@showfont{\csuse{alph@font@\spec@code}} from \url{\spec@font@url}. + + \begingroup + \def\mytablerow{\texttt{\csvcoli} & \csuse{\csuse{spec@code}}{\csvcoli} & \ifbool{alph@\spec@code @has@entities}{\csvcolii & \csvcoliii}{\csvcolii}} + \ifbool{alph@\spec@code @has@entities}{% + \def\spec@columns{r @{ } c @{ } l @{ } X}% + }{% + \def\spec@columns{r @{ } c @{ } X}% + }% + \expanded{\unexpanded{\begin{xltabular}{\linewidth}}{\spec@columns}} + \toprule + Code & & \ifbool{alph@\spec@code @has@entities}{&}{} \hfill \spec@charset\\ + Point & Glyph & \ifbool{alph@\spec@code @has@entities}{ Entity Name &}{} Unicode Name\\ + \midrule + \endhead + \bottomrule + \endfoot + \csvloop{ + file={\spec@csvfile}, + late after line=\\, + head to column names prefix=spec@, + command=\mytablerow, + } + \end{xltabular} + \endgroup +} + +\makeatother + +\begin{document} + +\maketitle +\tableofcontents + +\specimen{ + character set=MUFI, + font url=http://mufi.info/, +} + +\specimen{ + character set=SIL, + font url=https://software.sil.org/charis/download/, +} + +\specimen{ + character set=TITUS, + font url=http://titus.fkidg1.uni-frankfurt.de/unicode/tituut.asp, +} + +\begingroup +\catcode`\_=12 % unz entities have underscores +\specimen{ + character set=UNZ, + font url=http://www.ligafaktur.de/, +} +\catcode`\_=8 +\endgroup + +\end{document} \ No newline at end of file diff --git a/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.bib b/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.bib new file mode 100644 index 0000000000..2180c3b768 --- /dev/null +++ b/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.bib @@ -0,0 +1,46 @@ +@article{LINCUA, + title={LINCUA: A Unicode-PUA harmonization scheme}, + author={Stötzner, Andreas}, + year={2012} +} +@online{MUFI, + title = {MUFI: The Medieval Unicode Font Initiative}, + url = {https://mufi.info/}, + urldate = {2019-07-12} +} +@article{CYFI, + title={Proposal for a unified encoding of Early Cyrillic glyphs in the Unicode Private Use Area}, + author={Baranov, Victor and Birnbaum, David J and Cleminson, Ralph and Miklas, Heinz and Rabus, Achim}, + journal={Scripta \& e-scripta}, + volume={8}, + pages={9--26}, + year={2010} +} +@online{UNZ, + title = {Normung von Sonderzeichen}, + author = {Bund für deutsche Schrift und Sprache e. V.}, + url = {https://www.bfds.de/der-bund/normung-von-sonderzeichen-unicode/}, + urldate = {2019-07-12} +} +@online{SIL, + title={SIL PUA 9.0}, + author={Evans, Lorna}, + date={2016-07-05}, + url={https://scripts.sil.org/SILPUAassignments} +} +@online{TITUS, + title = {Thesaurus Indogermanischer Text- und Sprachmaterialien}, + date = {2017-07-10}, + url = {http://titus.uni-frankfurt.de/indexe.htm}, + urldate = {2019-07-12} +} +@online{AGL, + title = {adobe-type-tools/agl-aglfn}, + url = {https://github.com/adobe-type-tools/agl-aglfn/blob/master/glyphlist.txt}, + urldate = {2019-07-20} +} +@online{UCSUR, + title = {Under-ConScript Unicode Registry}, + url = {http://www.kreativekorp.com/ucsur/}, + urldate = {2019-07-20} +} \ No newline at end of file diff --git a/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.pdf b/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.pdf new file mode 100644 index 0000000000..cd9afaaa8a Binary files /dev/null and b/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.pdf differ diff --git a/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.tex b/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.tex new file mode 100644 index 0000000000..ada84e780f --- /dev/null +++ b/macros/latex/contrib/unicode-alphabets/docs/unicode-alphabets.tex @@ -0,0 +1,119 @@ +% !TEX TS-program = lualatex +\documentclass{article} + +\usepackage[english]{babel} +\usepackage[ + backend=biber, + urldate=long, + date=long, +]{biblatex} +\addbibresource{unicode-alphabets.bib} + +\usepackage{showexpl} +\usepackage{float} +\usepackage{moreverb} +\usepackage{csvsimple} +\usepackage{enumitem} +\usepackage{xltabular} +\usepackage{booktabs} +\usepackage[ + hidelinks, +]{hyperref} + +\include{csvsimple.tmp.patch} + +\title{Unicode Alphabets for \LaTeX} +\author{Mikkel Eide Eriksen\\\href{mailto:mikkel.eriksen@gmail.com}{mikkel.eriksen@gmail.com}} + +\usepackage{fontspec} +\newfontfamily\mufifont{Palemonas MUFI} + +\usepackage[ + MUFI, + fonts={ + MUFI=\mufifont, + }, +]{unicode-alphabets} + +\begin{document} + +\maketitle + +\section{Preface} + +While Unicode supports the vast majority of use cases, there are certain specialized niches which require characters and glyphs not (yet) represented in the standard. + +Thus the Private Use Area (PUA) at code points \texttt{E000}--\texttt{F8FF}, which enables third parties to define arbitrary character sets. + +This package allows configuring a number of macros to enter characters from the PUA by name or code point. + +\section{Setup} + +The package is configured in the following manner: + +\begin{verbatim} +\usepackage[options]{unicode-alphabets} +\end{verbatim} + +Where \verb|options| must be one or more of the following character sets. See references for further detail on each, as well as usable fonts. + +\begin{description}[labelindent=1cm, leftmargin=*, rightmargin=\leftmargin] + +\item[AGL] Adobe Glyph List\cite{AGL}. +% \item[CSUR] - https://www.evertype.com/standards/csur/ +\item[CYFI] Early Cyrillic glyphs\cite{CYFI}. +% DANIA ??? +\item[LINCUA] Shortcut for enabling the character sets CYFI, MUFI, and TITUS\cite{LINCUA}. +\item[MUFI] The Medieval Unicode Font Initiative\cite{MUFI}. +\item[SIL] SIL International\cite{SIL}. +\item[TITUS] Thesaurus Indogermanischer Text- und Sprachmaterialien\cite{TITUS}. +\item[UCSUR] Under-ConScript Unicode Registry\cite{UCSUR}. +\item[UNZ] Normung von Sonderzeichen\cite{UNZ}. + +\end{description} + +There is no default, since future versions of this package may supply more character sets that are incompatible with the above. + +Additionally, one may configure different fonts for each character set, as in the following example: + +\begin{figure}[H] +\centering +\begin{verbatimtab} +\usepackage[ + MUFI, + TITUS, + fonts={ + MUFI=\mufifont, + TITUS=\titusfont, + }, +]{unicode-alphabets} +\end{verbatimtab} +\caption{Example setup} +\end{figure} + +If no fonts are configured, the document font will be used (note that this may give undesirable results, as few fonts support multiple character sets\footnote{I believe Andreas Stötzner's \emph{Andron Mega} does, albeit I haven't tried it as it is somewhat expensive.}). + +Finally, the \verb|MUFI| and \verb|UNZ| character sets have defined entity names, which result in the creation of macros for each character (see \verb|msignfour| in the following example). These can be suppressed with the \verb|disableentitymacros| option. + +\section{Usage} + +Each set defines a macro in the following manner. Let's use \verb|MUFI| as an example. + +By default, a macro with the lower-case name of the character set is defined: \verb|\mufi{}|. It can then be used to display characters from the given set (the below uses the \emph{Palemonas MUFI} font available from the MUFI project): + +\begin{figure}[H] +\centering +\begin{LTXexample}[varwidth=true] +\mufi{FLOURISHED SMALL LETTER M SIGN}\\ +\msignflour{} +\mufi{msignflour} +\mufi{F2F3} +\end{LTXexample} +\caption{Example usage} +\end{figure} + +Additionally, starred versions of each macro are defined, which suppress using the configured font, falling back to the document font. + +\printbibliography + +\end{document} -- cgit v1.2.3