new font/latex package xq (29sep06)

git-svn-id: svn://tug.org/texlive/trunk@2226 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 262 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/fonts/xq/README b/Master/texmf-dist/doc/fonts/xq/README
new file mode 100644
index 00000000000..5469b94687a
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/xq/README
@@ -0,0 +1,56 @@
+readme for the xq-package
+
+
+this style is made for writing about chinese chess. Unfortunately, it has become a real monster, but i did 
+not find a better way to get what i wanted - which is probably due to the fact, that i never wrote something 
+like this before - so dont mind me my rather "simple" solution.
+
+
+xq is under the LaTeX project public license
+
+
+
+The package contains: 
+
+the style file - xq.sty
+basefont  - xqbase.mf
+hint file needed by xqbase - hints.mf
+font files for "normal" sized boards - xqnormal.mf  
+font files for "large" sized boards - xqlarge.mf  
+an example file demonstrating the abilities of the style - xqexample.tex
+the example file in pdf format for taking a quick look - xqexample.pdf
+and finally this readme file - README 
+
+
+
+On my local tree it works with the files copied to the following places:
+
+/texmf/tex/latex/xq/xq.sty
+
+/texmf/fonts/source/public/xq/xqbase.mf + xqnormal.mf + xqlarge.mf + hints.mf
+
+
+
+If problems occur, that the fonts are not loadable, put everything in one folder with the input file and
+run latex. That produces the .tfm then copy these to:
+
+/texmf/fonts/tfm/public/xq/xqnormal.tfm + xqlarge.tfm 
+
+
+
+
+Problems: 
+
+There are small gaps between pieces and boardlines in the diagrams, this is due to the font. You can avoid
+this by putting the unit length for the picture in the style file a little smaller. However, i found it 
+looks better like it is now.
+
+The boards are sometimes set a bit unclean on a pdf output file. I solved the problem by producing a pdf 
+via dvi and ps. After that procedure i always had a clean output in acroread.
+
+
+
+I hope everything works like it should, if not, please let me know...
+
+Stephan Weinhold, 09/2006
+stewei@surfeu.de
diff --git a/Master/texmf-dist/doc/fonts/xq/xqexample.pdf b/Master/texmf-dist/doc/fonts/xq/xqexample.pdf
new file mode 100644
index 00000000000..fbbf1009037
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/xq/xqexample.pdf
diff --git a/Master/texmf-dist/doc/fonts/xq/xqexample.tex b/Master/texmf-dist/doc/fonts/xq/xqexample.tex
new file mode 100644
index 00000000000..7c8a56399de
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/xq/xqexample.tex
@@ -0,0 +1,206 @@
+%example file for demonstrating the usage of xq.sty. 
+\documentclass[twocolumn,11pt]{article}
+\usepackage{xq}
+
+\parindent 0pt
+\setlength{\columnsep}{5mm}
+\setlength{\textheight}{220mm}
+\setlength{\headheight}{13.6pt}
+\setlength{\hoffset}{-3.0mm}
+\setlength{\voffset}{-6.0mm}
+
+\begin{document}
+
+\texttt{The xq package is made for writing about xiangqi or chinese chess. This file demonstrates what the package can do.}
+
+\mylanguage english
+%i ve tried to enable input of the language typical letters for the different pieces. By now there are letters defined for my mother tongue "german" (King=F, Advisor/Guard=M, Elephant=E, Chariot=W, Cannon=K, Horse=P, Soldier=S - for red pieces and corresponding lower cases for black pieces) and "english" K,A,E,R,C,H,P. If you want to add your language or do not like the letters I used goto xq.sty and use the pattern to define the letter definitions according to your preferences. Please rename the style file, if you make any changes. This selection affects on the one hand the letters for the pieces when setting up a position in the input file and on the other hand the letters for pieces shown in the move blocks in the output file. 
+\bigskip
+\texttt{First we write down a complete game.}
+\newgame
+%defines the board with the start position, the movecount, shown in the move blocks, is set to 0.
+
+\begin{center}
+{\bf\large{Player\,1\,--\,Player\,2}}
+\end{center}
+
+
+\texttt{Moves are input like this: "f1e2 h8e8", the letter for the piece that is moved is generated automatically and also, whether it is a capture or not. The piece letters shown depend on the language, you choose at the beginning of the tex file, in this case it is "english". However, by now there are only letters defined for english and my mother tongue german, but i created a pattern in the style file, where you can add your language typical letters.} \\
+
+\move f1e2 h8e8 
+%shows a move of first red and then black, note that there is absolutely no check for legal moves - this means, that on the one hand any piece can move to any place, even to the place it comes from and on the other hand a piece moved from/to a place that does not exist on the board will not be shown, selecting an empty square as start square produces an error - so everything has to be correct here
+\move h1g3 h0g8
+\move b1c3 i0h0
+\move i1h1 h0h6
+\move h3h5 b0a8
+\move c4c5 b8c8
+\move c1e3 c7c6
+\move c3b5 c6c5
+\move e3c5 h6c6
+\move c5e3 g7g6
+\move b5a7 c6c3
+\move b3b6 c3c7
+\move h5h7 e7e6
+\cr ! 
+%shows the comment you input here after the next red move 
+\move b6g6 xxxx 
+%shows a move only of red, actually, only the first letter of the side, that does not move, has to be a "x", but it have to be 4 letters
+\texttt{The board is shown with a single command. The style finds the correct position depending on the moves you input.}
+\showboard 
+%shows the board in a size fitted to twocolumn on a4paper according to my personal preference, the position shown should be the one the moves input are leading to
+
+
+\cb ? 
+%the same for next black move
+\move xxxx c7a7 
+%move only of black
+Black wins a major piece, but more important is that Red gets a strong attack on the right wing of the board.
+\cr + 
+\move g6g0 f0e9
+\cr +
+\move h7h0 xxxx 
+\texttt{By now there is no special environment for writing down variations within running text, so input equals output here.}\\
+\\
+It is not better for Red to play 16.Ci0, for after 16\dots Kf0 17.Chh0+ Kf9 18.Rh9+ Kf8 19.Rg9 Hh6 20.Rg6 Red gets back the major piece only\dots 
+%I did not input any special environment for writing down variations outside the move blocks so input equals output here   
+\move xxxx g8h0
+\move h1h0 a0a9
+\cr +
+\move g0d0 e9f0
+\move d0f0 a9f9
+\cr +
+\move f0c0 xxxx 
+but in the game Red takes the whole defense of Black\dots 
+\move xxxx e0e9
+\move a1b1 a7f7
+\cr + 
+\move b1b9 c8c9
+\move c0a0 e8d8
+
+\showboard
+
+\move b9a9 d8d2
+\move a0a8 xxxx
+\dots and the major piece.
+\move xxxx e9e8
+\cr +
+\move h0h8 f7f8
+\move a9c9 xxxx
+Black resigned the game.
+\begin{center}
+{\bf{\large{1\,:\,0}}}
+\end{center}
+
+
+\texttt{Now we start playing from a special position, that is input in the tex file.}
+
+\begin{center}
+{\bf{\large{Exercise}}}
+\end{center}
+In the diagram shown below both sides can checkmate the opponent, depending only on who is to move.
+
+\resetboard 
+%makes the board to show an empty one, recommended before setting up a position
+
+\piece Ec1
+%by now positions have to be input piece by piece which is not so cool, sorry :-) 
+\piece Ke1
+\piece Af1
+\piece Rh1
+\piece Ae2
+\piece Ha3
+\piece Ee3
+\piece Pc4
+\piece Pg4
+\piece Pi4
+\piece Pa5
+\piece ce5
+\piece Ci5
+\piece pc6
+\piece rd6
+\piece pg6
+\piece pa7
+\piece pe7
+\piece Cg7
+\piece hc8
+\piece ee8
+\piece hg8
+\piece ae9
+\piece ec0
+\piece ke0
+\piece af0
+
+\showboard
+
+1.\,Red to move checkmates in 3 moves\\
+2.\,Black to move checkmates in 4 moves\\
+
+\textit{Solution}\\
+
+1.\,Red to move
+\movecount=0
+\cr +
+\move i5i0 g8h0
+\cr +
+\move g7g0 e8g0
+\cr \#
+\move i0g0 xxxx
+
+\resetboard
+
+\piece Ec1
+\piece Ke1
+\piece Af1
+\piece Rh1
+\piece Ae2
+\piece Ha3
+\piece Ee3
+\piece Pc4
+\piece Pg4
+\piece Pi4
+\piece Pa5
+\piece ce5
+\piece Ci5
+\piece pc6
+\piece rd6
+\piece pg6
+\piece pa7
+\piece pe7
+\piece Cg7
+\piece hc8
+\piece ee8
+\piece hg8
+\piece ae9
+\piece ec0
+\piece ke0
+\piece af0
+
+\bigskip
+2.\,Black to move
+
+\movecount=1
+\move xxxx e0d0
+\cr +
+\move i5i0 d0d9
+\cr +
+\move i0i9 d9d8
+\move i9i6 xxxx
+\dots or any other move
+\cb \#
+\move xxxx d6d1 
+
+%finally a large board
+\newpage
+\onecolumn
+
+\newgame
+\texttt{I also included a large board.}
+\showlargeboard 
+%shows a board in a size fitted to onecolumn on a4paper according to my personal preference
+
+\texttt{Thats all! Hopefully everything works like it should!}
+
+\end{document}
+
+%Stephan Weinhold 09.2006
+%stewei@surfeu.de