diff options
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/lualatex/cstypo/LICENSE | 21 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/cstypo/README.md | 11 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/cstypo/cstypo.pdf | bin | 0 -> 67456 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/cstypo/cstypo.tex | 114 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/cstypo/cstypotest.pdf | bin | 0 -> 21174 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/cstypo/cstypotest.tex | 80 |
6 files changed, 226 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/lualatex/cstypo/LICENSE b/Master/texmf-dist/doc/lualatex/cstypo/LICENSE new file mode 100644 index 00000000000..872ab4f9e10 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/cstypo/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2016 Václav Haisman + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/Master/texmf-dist/doc/lualatex/cstypo/README.md b/Master/texmf-dist/doc/lualatex/cstypo/README.md new file mode 100644 index 00000000000..db71a70026b --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/cstypo/README.md @@ -0,0 +1,11 @@ +# cstypo + +This package provides macros for Czech language typography rules using +Lua(La)TeX. + +- License is MIT license. See `LICENSE` file. + +- Author is [Václav Haisman](mailto:vhaisman+cstypo@gmail.com?subject=[cstypo]) + +- Source code on GitHub in [`wilx/cstypo`](https://github.com/wilx/cstypo) + repository. diff --git a/Master/texmf-dist/doc/lualatex/cstypo/cstypo.pdf b/Master/texmf-dist/doc/lualatex/cstypo/cstypo.pdf Binary files differnew file mode 100644 index 00000000000..98610d9d79e --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/cstypo/cstypo.pdf diff --git a/Master/texmf-dist/doc/lualatex/cstypo/cstypo.tex b/Master/texmf-dist/doc/lualatex/cstypo/cstypo.tex new file mode 100644 index 00000000000..9e87d617b90 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/cstypo/cstypo.tex @@ -0,0 +1,114 @@ +\documentclass[paper=B5,DIV=calc,parskip=half]{scrartcl} +\usepackage{ifluatex} + +\usepackage{fontspec} +%\defaultfontfeatures{Ligatures={TeX,Common},Scale=MatchLowercase} +\setmainfont[]{Charis SIL} +\setsansfont[Ligatures={TeX,Common}, Scale=MatchLowercase]{TeX Gyre Heros} +\setmonofont[Ligatures=,Scale=MatchLowercase]{DejaVu Sans Mono} + +\usepackage{listings} +\usepackage{enumitem} +%\usepackage{enumitem-zref} +\usepackage{polyglossia} +\setmainlanguage[]{english} + +\author{Václav Haisman\texorpdfstring{% + \\{\small\href{mailto:vhaisman+cstypo@gmail.com?subject=[cstypo]}{vhaisman@gmail.com}}}{}} +\date{\today} +\title{\texttt{cstypo} user manual} + +\PassOptionsToPackage{unicode}{hyperref} +\usepackage{bookmark} +\usepackage{xcolor} +\hypersetup{ + colorlinks, + linkcolor={red!50!black}, + citecolor={blue!50!black}, + urlcolor={blue!80!black}, + breaklinks=true} +\urlstyle{same} % don't use monospace font for urls + +\usepackage{microtype} +\usepackage{metalogo} + +\setlength{\emergencystretch}{3em} % prevent overfull lines + +\lstdefinestyle{myLatexStyle}{ + language=[LaTeX]{Tex}, + basicstyle=\ttfamily +} + + +\begin{document} +\begin{titlepage} + \maketitle +\end{titlepage} + +\tableofcontents + +\section{Introduction} +The \href{https://www.ctan.org/pkg/cstypo}{\texttt{cstypo}}\footnote{Source + code is on GitHub in + \href{https://github.com/wilx/cstypo}{\texttt{wilx/cstypo}} repository.} +package provides macros that enforce basic Czech typography rules through Lua +hooks available in \LuaTeX{}. + +\begin{enumerate}%[name=rulesList] +\item\label{itm:singleletter} There should be no line break between single + letter preprosition and single letter conjugations and word following them. +\item\label{itm:percents} There should be no line break between number and \% + symbol. +\end{enumerate} + +There are obviously more rules than these two but only the above rules are +enforcable through this package. + +\section{User interface} + +The following two macros allow to enable and disable hook that enforces +penalization of line breaks after single letter words: +%(\refitem{rulesList{itm:singleletter}): + +\begin{lstlisting}[style=myLatexStyle] +\cstypoSingleLetterEnable +\cstypoSingleLetterDisable +\end{lstlisting} + +The following two macros allow to enable and disable hook that enforces the +same rule as above but for ‘a’ conjugation. The reason that this is separete +from the rest of the single letter prepositions and conjugations is that line +break after ‘a’ is tolerated for narrow column texts. It might be desirable +to have this rule enforced for all of the single letter words except for the +‘a’. + +\begin{lstlisting}[style=myLatexStyle] +\cstypoALetterEnable +\cstypoALetterDisable +\end{lstlisting} + +The following two macros allow to enable and disable hook that enforces +penalization of line breaks between number and \% symbol. + +\begin{lstlisting}[style=myLatexStyle] +\cstypoPercentsEnable +\cstypoPercentsDisable +\end{lstlisting} + +\section{History} + +This package was inspired by +\texttt{\href{http://www.ctan.org/pkg/impnattypo}{impnattypo}} French +typography package. It would not be possible without help and comments from +people of +\href{http://chat.stackexchange.com/rooms/41/tex-latex-and-friends}{\TeX{}, + \LaTeX{} and Friends} StackExchange chat room and the +\href{http://tex.stackexchange.com/}{\TeX.SE} site itself. + +\begin{description}[style=nextline, labelwidth=4.5em, leftmargin=!, labelindent=0em] +\item[\texttt{v0.02}] Fixed some packaging and documentation issues found by + CTAN submission review. +\item[\texttt{v0.01}] First published version of this package. +\end{description} + +\end{document} diff --git a/Master/texmf-dist/doc/lualatex/cstypo/cstypotest.pdf b/Master/texmf-dist/doc/lualatex/cstypo/cstypotest.pdf Binary files differnew file mode 100644 index 00000000000..9752e42b352 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/cstypo/cstypotest.pdf diff --git a/Master/texmf-dist/doc/lualatex/cstypo/cstypotest.tex b/Master/texmf-dist/doc/lualatex/cstypo/cstypotest.tex new file mode 100644 index 00000000000..bd94218c940 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/cstypo/cstypotest.tex @@ -0,0 +1,80 @@ +\documentclass{article} +\usepackage{lmodern} +\usepackage{ifluatex} +\usepackage[a6paper]{geometry} +\usepackage{parskip} +\usepackage{polyglossia} +\setmainlanguage[]{czech} +\setotherlanguage{english} +\usepackage{microtype} + +\setlength{\emergencystretch}{3em} % prevent overfull lines +\newcommand{\expl}[1]{\begin{english}\sffamily #1\end{english}} + +\usepackage{cstypo} + +\begin{document} +\section{Bad line breaks} +\expl{The follwing text has prepostions `O' and `k' at end of line which + is incorrect according to Czech language typography standards:} + +Mezi oblíbené dětské pohádky patří pohádky \emph{O Palečkovi, Alenka v říši + divů} a \emph{Socialismem k lepším zítřkům.} + +\expl{The follwing text is the same as above but parentheses are used to test + that a preposition stay (or not stay, in this case) with following word + even if the prepostion is preceeded with a parenthesis:} + +Mezi oblíbené dětské pohádky patří pohádky \emph{[O Palečkovi], Alenka v říši + divů} a \emph{Socialismem (k lepším zítřkům).} + +\expl{Next line shows bad line break between number and the \% symbol.} + +Se správným nastavením fontů znak \% v `na 100 \%' skončí na další řádce. + +\section{Better line breaks} +\expl{And here we add Lua code to penalize single letter words. It results in +following line layout:} + +\cstypoSingleLetterEnable{} +\cstypoPercentsEnable{} +\cstypoALetterEnable{} +Mezi oblíbené dětské pohádky patří pohádky \emph{O Palečkovi, Alenka v říši + divů} a \emph{Socialismem k lepším zítřkům.} + +\expl{The follwing text is the same as above but parentheses are used to test + that a preposition stay with following word even if the prepostion is + preceeded with a parenthesis:} + +Mezi oblíbené dětské pohádky patří pohádky \emph{[O Palečkovi], Alenka v říši + divů} a \emph{Socialismem (k lepším zítřkům).} + +\expl{Here, the \% symbol should be together with the number.} + +Se správným nastavením fontů znak \% v `na 100 \%' skončí na další řádce. + +\section{Bad line breaks again} +\expl{This section shows that disabling of the hook works and that the + prepositions are again left at the end of their line.} + +\cstypoSingleLetterDisable{} +\cstypoPercentsDisable{} +\cstypoALetterDisable{} + +Mezi oblíbené dětské pohádky patří pohádky \emph{O Palečkovi, Alenka v říši + divů} a \emph{Socialismem k lepším zítřkům.} + +\expl{The follwing text is the same as above but parentheses are used to test + that a preposition stay (or not stay, in this case) with following word + even if the prepostion is preceeded with a parenthesis:} + +Mezi oblíbené dětské pohádky patří pohádky \emph{[O Palečkovi], Alenka v říši + divů} a \emph{Socialismem (k lepším zítřkům).} + +\expl{And here, line break is inserted before the \% symbol again.} + +Se správným nastavením fontů znak \% v `na 100 \%' skončí na další řádce. + + + +\end{document} |