summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/fonts/xq/README42
-rw-r--r--Master/texmf-dist/doc/fonts/xq/xqexample.pdfbin64639 -> 76926 bytes
-rw-r--r--Master/texmf-dist/doc/fonts/xq/xqexample.tex106
3 files changed, 119 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/fonts/xq/README b/Master/texmf-dist/doc/fonts/xq/README
index 041d459413d..4a491be6215 100644
--- a/Master/texmf-dist/doc/fonts/xq/README
+++ b/Master/texmf-dist/doc/fonts/xq/README
@@ -1,25 +1,33 @@
-readme for the xq-package
+readme for the xq-package, version 0.3
-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.
+the xq.sty, 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 package contains 14 files:
+
+the style file - xq.sty
+
+basefont - xqbase.mf
+font file for "normal" sized boards - xqnormal.mf
+font file for "large" sized boards - xqlarge.mf
+basefont for western pieces - xqwestbase.mf
+font file for "normal" sized boards with western pieces - xqwestnormal.mf
+font file for "large" sized boards with western pieces - xqwestlarge.mf
+basefont for additional signs - xqaddsigns.mf
+font file for "normal" sized addsigns - xqaddsignsnormal.mf
+font file for "large" sized addsigns - xqaddsignslarge.mf
+hint file needed by xqbase, xqwestbase and xqaddsigns - xqhints.mf
-the style file - xq.sty
-basefont - xqbase.mf
-hint file needed by xqbase - xqhints.mf
-font file for "normal" sized boards - xqnormal.mf
-font file 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
+the example file in pdf format for taking a quick look - xqexample.pdf
+and finally this readme file - README
@@ -27,20 +35,23 @@ 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 + xqhints.mf
+/texmf/fonts/source/public/xq/*.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:
+run latex. That produces the .tfm files. Then copy these to:
-/texmf/fonts/tfm/public/xq/xqnormal.tfm + xqlarge.tfm
+/texmf/fonts/tfm/public/xq/*.tfm
Problems:
+Some things in the input file are rather uncomfortable. Hopefully i will improve the style by the time,
+but this requires more knowledge of the materia than i have now.
+
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.
@@ -50,6 +61,7 @@ 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
diff --git a/Master/texmf-dist/doc/fonts/xq/xqexample.pdf b/Master/texmf-dist/doc/fonts/xq/xqexample.pdf
index fbbf1009037..fb5f8f6d8d2 100644
--- a/Master/texmf-dist/doc/fonts/xq/xqexample.pdf
+++ b/Master/texmf-dist/doc/fonts/xq/xqexample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/fonts/xq/xqexample.tex b/Master/texmf-dist/doc/fonts/xq/xqexample.tex
index 7c8a56399de..ecf221df1d7 100644
--- a/Master/texmf-dist/doc/fonts/xq/xqexample.tex
+++ b/Master/texmf-dist/doc/fonts/xq/xqexample.tex
@@ -14,7 +14,24 @@
\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.
+%i ve tried to enable input of the language typical letters for the different pieces. By now there
+%are letters defined for:
+%
+%"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)
+%"english" (K,A,E,R,C,H,P);
+%"spanish" (R,O,E,T,B,C,P);
+%"italian" (R,M,E,T,B,C,P);
+%"french" (R,M,E,T,B,C,P);
+%"czech" (K,R,S,V,D,J,P) and
+%"dutch" (G,A,O,T,K,P,S)
+%
+%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
@@ -24,11 +41,12 @@
{\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
+%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
+\bigskip
+\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". By now there are letters defined for english, spanish, french, italian, czech, dutch and my mother tongue german. I created a pattern in the style file, where you can add your language typical letters, if the ones already defined do not match your preferences.} \\
+\bigskip
+
\move h1g3 h0g8
\move b1c3 i0h0
\move i1h1 h0h6
@@ -45,11 +63,13 @@
%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
+\newpage
+\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
+\texttt{The board is shown with a single command. The style finds the correct position depending on the moves you input.}
+\bigskip
\cb ?
%the same for next black move
\move xxxx c7a7
@@ -59,10 +79,9 @@ Black wins a major piece, but more important is that Red gets a strong attack on
\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
+
+It is not better for Red to play \bv 16.Ci0, for after 16|Kf0 17.Chh0+ Kf9 18.Rh9+ Kf8 19.Rg9 Hh6 20.Rg6 \ev Red gets back the major piece only\dots %between \bv and \ev "|" produces \ldots, "*" produces \times (the capturing symbol), if you need these to be output, use \makevisible*\makeactive
+
\move xxxx g8h0
\move h1h0 a0a9
\cr +
@@ -77,7 +96,12 @@ but in the game Red takes the whole defense of Black\dots
\move b1b9 c8c9
\move c0a0 e8d8
-\showboard
+\newpage
+
+\showwesternboard
+
+\texttt{You can also show the board with western pieces.}
+\bigskip
\move b9a9 d8d2
\move a0a8 xxxx
@@ -91,6 +115,8 @@ Black resigned the game.
{\bf{\large{1\,:\,0}}}
\end{center}
+\newpage
+\newpage
\texttt{Now we start playing from a special position, that is input in the tex file.}
@@ -189,6 +215,58 @@ In the diagram shown below both sides can checkmate the opponent, depending only
\cb \#
\move xxxx d6d1
+\newpage
+
+\texttt{I added a small font with some additional signs, f.e. to demonstrate legal moves of pieces. But by now this is not more than a first draft with only the four extra signs shown in the diagram}
+
+\resetboard
+
+\piece Ke1
+\addsign Ld1
+\addsign Lf1
+\addsign Le2
+
+\piece ng8
+\piece pg7
+\addsign Uf6
+\addsign Uh6
+\addsign Li7
+\addsign Li9
+\addsign Lh0
+\addsign Lf0
+\addsign Le9
+\addsign Le7
+
+\addsign Ra1
+\addsign Ba0
+
+\showboard
+%pieces in running text
+\newpage
+
+\texttt{pieces in running text}
+\bigskip
+
+\textpiece K \textpiece k
+the kings
+
+\vspace{2pt}
+
+\textpiece A \textpiece a
+the advisors/guards
+
+\makebox[21pt][c]{\vdots}
+
+\vspace{4pt}
+\westerntextpiece H \westerntextpiece h
+the knights/horses
+
+\vspace{2pt}
+
+\westerntextpiece P \westerntextpiece p
+the pawns/soldiers
+\vspace{2pt}
+
%finally a large board
\newpage
\onecolumn
@@ -196,7 +274,7 @@ In the diagram shown below both sides can checkmate the opponent, depending only
\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
+%shows a board in a size fitted to onecolumn on a4paper according to my personal preference. For western pieces input \showlargewesternboard
\texttt{Thats all! Hopefully everything works like it should!}