summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/gridpapers
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-03-16 22:10:31 +0000
committerKarl Berry <karl@freefriends.org>2021-03-16 22:10:31 +0000
commit3b2fc42641eb10e70aacf8e8f281086cc2c420eb (patch)
treee8a8ac0b0bb7ffcddb2ee420cb006ba2fa24837c /Master/texmf-dist/doc/latex/gridpapers
parent118c5da4a566b493ffe01f96d740ffdf2809e3c7 (diff)
gridpapers (16mar21)
git-svn-id: svn://tug.org/texlive/trunk@58439 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/gridpapers')
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/README.md113
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/custom-colors.tex18
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-10spi.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-5spi.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/engineer-pad.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/engineer-paper-8spi.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper-8spi.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/grid-with-light-cones.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-large.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-small.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/isometric-grid.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/plum-graph-paper.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/precocious-young-engineer.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-10spi.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-8spi.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/red-graph.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/examples/triangular-grid.tex8
-rw-r--r--Master/texmf-dist/doc/latex/gridpapers/gridpapers.pdfbin0 -> 220081 bytes
20 files changed, 267 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/gridpapers/README.md b/Master/texmf-dist/doc/latex/gridpapers/README.md
new file mode 100644
index 00000000000..a9be615209d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/README.md
@@ -0,0 +1,113 @@
+# The *gridpapers* package
+Make your own quadrille, graph, hex, etc. paper! Uses the [PGF/TikZ](https://en.wikipedia.org/wiki/PGF/TikZ) package for LaTeX, which should be part of any modern TeX installation. All colors and spacing are customizable.
+
+There are .tex files in the examples/
+directory to help get you started with customization.
+Each tex file has an almost-empty body, with a `\usepackage` statement
+that you can customize. For example,
+examples/engineer-pad.tex looks like this:
+```latex
+\documentclass{article}
+\usepackage[pattern=majmin, colorset=engineer]{gridpapers}
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
+```
+(The `~` in the body forces a non-empty body, or else latex wouldn't
+generate a PDF).
+
+Note: This package is distinct from a different package with a similar
+name, [graphpaper (on CTAN)](https://www.ctan.org/pkg/graphpaper).
+
+Installation
+------------
+If `gridpapers` is already provided in your TeX distribution, skip
+this section. You should be able to install `gridpapers` [from the
+CTAN](https://www.ctan.org/pkg/gridpapers) via your distribution's
+utility (e.g. the TeX Live Utility). Alternatively, you can get the
+package from the [source repository on
+GitHub](https://github.com/mcnees/LaTeX-Graph-Paper). If you do not
+want to do a "full" installation, just copy gridpapers.sty into the
+same directory as your LaTeX source.
+
+Usage
+-----
+
+All the configuration happens via the `\usepackage` command. The
+current valid options are:
+
+* `pattern=<name>`:
+Valid pattern names are:
+`std,stdeight,majmin,dot,hex,tri,iso,lightcone,ruled,doubleruled`. Default
+is `std`. Patterns come with default page geometry (size and margins;
+see `geometry`), and default 'fullness' (whether they fill the page or
+not; see options `fullpage` and `textarea`).
+* `colorset=<name>`:
+Valid color preset names are:
+`std,precocious,brickred,engineer,plumpad`. Default is `std`. A
+preset determines the `majorcolor`, `minorcolor`, and `bgcolor` all at
+once. But, you can start from a preset and then override some colors.
+* `majorcolor=<color>`: Override the preset "major" color. This can
+ be a named color, or using the syntax from xcolor to mix colors
+ together.
+* `minorcolor=<color>`: Override the preset "minor" color. As above.
+* `bgcolor=<color>`: Override the preset background color. As above.
+* `patternsize=<length>`: Override the preset pattern size. The
+ meaning of this length argument is different for each pattern; see
+ PDF documentation for full details..
+* `dotsize=<length>`: Controls the size of the dots themselves for
+ `pattern=dot`. Default: `.7pt`
+* `fullpage`: Make the pattern fill the whole page.
+* `textarea`: Make the pattern fill only the text area of the
+ document. At most one of the `fullpage` or `textarea` can be
+ specified. If one is specified, it will override the default
+ 'fullness' setting of the pattern.
+* `geometry={<geometry spec>}`: Page geometry specification, using the
+ syntax of the geometry package. If the geometry package was loaded
+ before gridpapers, this option will be ignored. This specification
+ will override the pattern's default page geometry.
+
+For example, let's say you want to use the `tri` pattern, which by
+default fills the page. But you want it to fill just the textarea of
+an A4 page with 2cm margins, and you want the triangles to be .75cm long.
+Finally, you like the colors of the `engineer` set, but want a white
+background. Then you would write:
+```latex
+\usepackage[pattern=tri,
+ patternsize=0.75cm,
+ textarea,
+ colorset=engineer,
+ bgcolor=white,
+ geometry={a4paper, margin=2cm}]{gridpapers}
+```
+
+Gallery
+-------
+
+Some example styles:
+
+![Standard](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/std.jpg "Standard")
+
+![Quad](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/quad.jpg "Quadrille")
+
+![Hex](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/hex.jpg "Hex")
+
+![Dots](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/dot.jpg "Dots")
+
+![Light cone](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/lightcone.jpg "Light cone")
+
+![Precocious Engineer](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/rosie.png "Precocious Engineer color scheme")
+
+![Hex Engineer](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/hexengineer.png "Hex grid with Engineering Pad color scheme")
+
+Credits
+-------
+
+This package was created by [Robert McNees](http://jacobi.luc.edu/)
+with additional contributions from [Leo
+C. Stein](http://duetosymmetry.com/), and is maintained by both. This
+material is subject to the [LaTeX Project Public License
+1.3c](https://www.ctan.org/license/lppl1.3), (c) 2017-2021. The
+hexagon pattern code is [due to Philippe
+Goutet](https://tex.stackexchange.com/questions/6019/drawing-hexagons/6128#6128).
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/custom-colors.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/custom-colors.tex
new file mode 100644
index 00000000000..1dcc9404899
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/custom-colors.tex
@@ -0,0 +1,18 @@
+\documentclass{article}
+
+\usepackage{xcolor}
+
+% See the documentation of the xcolor package to learn about different
+% color models for specifying colors
+\definecolor{mydeepgreen}{rgb}{0.07, 0.56, 0.04}
+
+% You can easily mix colors by using the ! syntax from xcolor. Here
+% we use it to mix 40% of our color with 60% white.
+\usepackage[pattern=majmin,
+ majorcolor=mydeepgreen,
+ minorcolor={mydeepgreen!40}]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-10spi.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-10spi.tex
new file mode 100644
index 00000000000..083928b3f09
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-10spi.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=dot]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-5spi.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-5spi.tex
new file mode 100644
index 00000000000..6d9bb6a8dbe
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/dot-grid-5spi.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=dot, patternsize=0.2in]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/engineer-pad.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/engineer-pad.tex
new file mode 100644
index 00000000000..49bb2390595
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/engineer-pad.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=majmin, colorset=engineer]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/engineer-paper-8spi.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/engineer-paper-8spi.tex
new file mode 100644
index 00000000000..6260335d76a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/engineer-paper-8spi.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=majmin, colorset=engineer, bgcolor=white]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper-8spi.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper-8spi.tex
new file mode 100644
index 00000000000..5e01e04e8f5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper-8spi.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=majmin]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper.tex
new file mode 100644
index 00000000000..4474fc44ede
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/graph-paper.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=std]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/grid-with-light-cones.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/grid-with-light-cones.tex
new file mode 100644
index 00000000000..04cebdd74fa
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/grid-with-light-cones.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=lightcone]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex
new file mode 100644
index 00000000000..70d925fdd3f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=hex, colorset=engineer, fullpage, geometry={letterpaper}]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-large.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-large.tex
new file mode 100644
index 00000000000..0aaa4b18147
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-large.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=hex]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-small.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-small.tex
new file mode 100644
index 00000000000..8b532f90bb5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/hex-grid-small.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=hex, patternsize=0.0833in]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/isometric-grid.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/isometric-grid.tex
new file mode 100644
index 00000000000..7e0678d30d1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/isometric-grid.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=iso]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/plum-graph-paper.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/plum-graph-paper.tex
new file mode 100644
index 00000000000..09ef97cbea0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/plum-graph-paper.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=majmin, colorset=plumpad]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/precocious-young-engineer.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/precocious-young-engineer.tex
new file mode 100644
index 00000000000..1e33ba820c4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/precocious-young-engineer.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=majmin, colorset=precocious]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-10spi.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-10spi.tex
new file mode 100644
index 00000000000..4474fc44ede
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-10spi.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=std]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-8spi.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-8spi.tex
new file mode 100644
index 00000000000..fcc8b91ed77
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/quadrille-8spi.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=stdeight]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/red-graph.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/red-graph.tex
new file mode 100644
index 00000000000..8113ebca91e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/red-graph.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=majmin, colorset=brickred]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/examples/triangular-grid.tex b/Master/texmf-dist/doc/latex/gridpapers/examples/triangular-grid.tex
new file mode 100644
index 00000000000..2120eac2895
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/examples/triangular-grid.tex
@@ -0,0 +1,8 @@
+\documentclass{article}
+
+\usepackage[pattern=tri]{gridpapers}
+
+\begin{document}
+\thispagestyle{empty}
+~
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/gridpapers/gridpapers.pdf b/Master/texmf-dist/doc/latex/gridpapers/gridpapers.pdf
new file mode 100644
index 00000000000..2204f6fd67c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gridpapers/gridpapers.pdf
Binary files differ