CTAN Comprehensive TeX Archive Network

Directory macros/luatex/generic/nodetree

README.md
nodetree

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 Lua 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 engine Lua. 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.

License

Copyright (C) 2016-2024 by Josef Friedrich <josef@friedrich.rocks>

This work may be distributed and/or modified under the conditions of the 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 version 2005/12/01 or later.

CTAN

Since July 2016 the nodetree package is included in the Comprehensive Archive Network (CTAN).

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

\documentclass{article}
\usepackage{nodetree}
\begin{document}
nodetree
\end{document}
nodetree

The node list of a mathematical formula

\documentclass{article}
\usepackage[callback={mhlist}]{nodetree}
\begin{document}
\[\left(a\right)\left[\frac{b}{a}\right]=a\,\]
\end{document}
nodetree

The node list of the word 'Office'

The characters 'ffi' are deeply nested in a discretionary node.

\documentclass{article}
\usepackage{nodetree}
\begin{document}
Office
\end{document}
nodetree

Development

First delete the stable version installed by Live. Because the package nodetree belongs to the collection collection-latexextra, the option --force must be used to delete the package.

tlmgr remove --force nodetree

Deploying a new version

Update the version number in the file nodetree.dtx on this locations:

In the markup for the file nodetree.sty (approximately at the line number 30)

%<*package>
[2016/07/18 v1.2 Visualize node lists in a tree view]
%<*package>

In the markup for the file nodetree-embed.sty (approximately at the line number 220)

%<*package>
[2016/07/18 v1.2 Visualize node lists in a tree view]
%<*package>

In the markup for the package documentation (approximately at the line number 50)

Add a changes entry:

\changes{v1.2}{2020/05/20}{...}

In documentation (documentation.tex) (approximately at the line number 70)

\date{v2.0 from 2020/05/29}

In the file nodetree.lua (approximately at the line number 20)

if not modules then modules = { } end modules ['nodetree'] = {
  version   = '1.2'
}

Update the copyright year:

sed -i 's/(C) 2016-2024/(C) 2016-2021/g' nodetree.ins
sed -i 's/(C) 2016-2024/(C) 2016-2021/g' nodetree.dtx

Command line tasks:

git tag -a v1.4
make
make ctan

Download the contents of this package in one zip archive (300.1k).

nodetree – Visualize node lists in a tree view

nodetree is a development package that visualizes the structure of node lists. nodetree shows its debug informations in the console output when you compile a Lua file. It uses a similar visual representation for node lists as the UNIX tree command for a folder structure.

Packagenodetree
Bug trackerhttps://github.com/Josef-Friedrich/nodetree/issues
Repositoryhttps://github.com/Josef-Friedrich/nodetree
Developershttps://josef-friedrich.github.io/nodetree
Version2.4.0 2024-09-17
LicensesThe Project Public License 1.3
Copyright2016–2024 Josef Friedrich
MaintainerJosef Friedrich
Contained inTeX Live as nodetree
MiKTeX as nodetree
TopicsLua supp
...
Guest Book Sitemap Contact Contact Author