diff options
Diffstat (limited to 'Master/texmf-dist/doc/luatex/nodetree/README.md')
-rw-r--r-- | Master/texmf-dist/doc/luatex/nodetree/README.md | 131 |
1 files changed, 97 insertions, 34 deletions
diff --git a/Master/texmf-dist/doc/luatex/nodetree/README.md b/Master/texmf-dist/doc/luatex/nodetree/README.md index 4f82f1e5e24..e9f8bb0ee06 100644 --- a/Master/texmf-dist/doc/luatex/nodetree/README.md +++ b/Master/texmf-dist/doc/luatex/nodetree/README.md @@ -1,41 +1,104 @@ -# nodetree -Inspired by a [gist from Patrick Gundlach](https://gist.github.com/pgundlach/556247). + -`nodetree` displays some debug informations of the node list in the -terminal, when you render a Latex document. +# Abstract +`nodetree` is a development package that visualizes the structure of +node lists. `nodetree` shows its debug informations in the consoles’ +output when you compile a LuaTeX file. It uses a similar visual +representation for node lists as the UNIX `tree` command uses for a +folder structure. + +Node lists are the main building blocks of each document generated by +the TeX engine LuaTeX. The package `nodetree` doesn‘t change +the rendered document. The tree view can only be seen when using a +terminal to generate the document. + +`nodetree` is inspired by a +[gist from Patrick Gundlach](https://gist.github.com/pgundlach/556247). + +# License + +Copyright (C) 2016 by Josef Friedrich <josef@friedrich.rocks> +------------------------------------------------------------------------ +This work may be distributed and/or modified under the conditions of +the LaTeX Project Public License, either version 1.3 of this license +or (at your option) any later version. The latest version of this +license is in: + + http://www.latex-project.org/lppl.txt + +and version 1.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +# CTAN + +Since July 2016 the cloze package is included in the Comprehensive TeX +Archive Network (CTAN). + +* TeX archive: http://mirror.ctan.org/tex-archive/macros/luatex/generic/nodetree +* Package page: http://www.ctan.org/pkg/nodetree + +# Repository + +https://github.com/Josef-Friedrich/nodetree + +# Installation + +Get source: + + git clone git@github.com:Josef-Friedrich/nodetree.git + cd nodetree + +Compile: + + make + +or manually: + + luatex nodetree.ins + lualatex nodetree.dtx + makeindex -s gglo.ist -o nodetree.gls nodetree.glo + makeindex -s gind.ist -o nodetree.ind nodetree.idx + lualatex nodetree.dtx + +# Examples + +## The node list of the package name + +```latex +\documentclass{article} +\usepackage{nodetree} +\begin{document} +nodetree +\end{document} +``` + + + +## The node list of a mathematical formula + +```latex +\documentclass{article} +\usepackage[callback={mhlist}]{nodetree} +\begin{document} +\[\left(a\right)\left[\frac{b}{a}\right]=a\,\] +\end{document} ``` -post_linebreak_filter: -│ -├─GLUE subtype: baselineskip; width: 5.06pt; -└─HLIST subtype: line; width: 345pt; height: 6.94pt; dir: TLT; glue_order: 2; glue_sign: 1; glue_set: 304.99993896484; - ╚═head: - ├─LOCAL_PAR dir: TLT; - ├─HLIST subtype: indent; width: 15pt; dir: TLT; - ├─GLYPH char: "O"; font: 15; left: 2; right: 3; uchyph: 1; width: 7.78pt; height: 6.83pt; - ├─DISC subtype: regular; penalty: 50; - │ ╠═post: - │ ║ └─GLYPH subtype: ghost; char: "\12"; font: 15; width: 5.56pt; height: 6.94pt; - │ ║ ╚═components: - │ ║ ├─GLYPH subtype: ligature; char: "f"; font: 15; left: 2; right: 3; uchyph: 1; width: 3.06pt; height: 6.94pt; - │ ║ └─GLYPH subtype: ligature; char: "i"; font: 15; left: 2; right: 3; uchyph: 1; width: 2.78pt; height: 6.68pt; - │ ╠═pre: - │ ║ ├─GLYPH char: "f"; font: 15; left: 2; right: 3; uchyph: 1; width: 3.06pt; height: 6.94pt; - │ ║ └─GLYPH char: "-"; font: 15; left: 2; right: 3; uchyph: 1; width: 3.33pt; height: 4.31pt; - │ ╚═replace: - │ └─GLYPH subtype: ghost; char: "\14"; font: 15; width: 8.33pt; height: 6.94pt; - │ ╚═components: - │ ├─GLYPH subtype: ghost; char: "\11"; font: 15; width: 5.83pt; height: 6.94pt; - │ │ ╚═components: - │ │ ├─GLYPH subtype: ligature; char: "f"; font: 15; left: 2; right: 3; uchyph: 1; width: 3.06pt; height: 6.94pt; - │ │ └─GLYPH subtype: ligature; char: "f"; font: 15; left: 2; right: 3; uchyph: 1; width: 3.06pt; height: 6.94pt; - │ └─GLYPH subtype: ligature; char: "i"; font: 15; left: 2; right: 3; uchyph: 1; width: 2.78pt; height: 6.68pt; - ├─GLYPH char: "c"; font: 15; left: 2; right: 3; uchyph: 1; width: 4.44pt; height: 4.31pt; - ├─GLYPH char: "e"; font: 15; left: 2; right: 3; uchyph: 1; width: 4.44pt; height: 4.31pt; - ├─PENALTY penalty: 10000; - ├─GLUE subtype: parfillskip; stretch: 65536; stretch_order: 2; - └─GLUE subtype: rightskip; + + +## The node list of the word 'Office' + +The characters 'ffi' are deeply nested in a discretionary node. + +```latex +\documentclass{article} +\usepackage{nodetree} +\begin{document} +Office +\end{document} ``` + + |