# pas-tableur

**Version 3.01 – 2026/09/04**  
**Author:** Stéphane Pasquet - Cédric Pierquet

A LaTeX package that uses TikZ to imitate the appearance of spreadsheets.

> *Thanks to Susumu Tanimura for his contribution to the improvement of this package.*  
> *Thanks to Emiel van Miltenburg for his contribution with the `\multimultiSelec` macro.*

---

## Description

`pas-tableur` allows you to draw spreadsheet-like tables in LaTeX documents. It does **not** perform any spreadsheet calculations — it only reproduces the visual appearance of a spreadsheet.

---

## Dependencies

This package automatically loads the following packages:

- `tikz` (with the `calc` library)
- `xkeyval`
- `xstring`
- `customenvs-macros`

---

## Installation

Decompress `pas-tableur.zip` so that the files are placed as follows:

**Ubuntu / Linux:**
```
./texlive/texmf-local/tex/latex/pas-tableur/pas-tableur.sty
./texlive/texmf-local/doc/latex/pas-tableur/pas-tableur.tex
./texlive/texmf-local/doc/latex/pas-tableur/pas-tableur.pdf
./texlive/texmf-local/doc/latex/pas-tableur/doc.codes.tex
./texlive/texmf-local/doc/latex/pas-tableur/doc.styles.tex
```

**Windows:**
```
C:\texmf\latex\pas-tableur\pas-tableur.sty
C:\texmf\doc\pas-tableur\pas-tableur.tex
C:\texmf\doc\pas-tableur\pas-tableur.pdf
C:\texmf\doc\pas-tableur\doc.codes.tex
C:\texmf\doc\pas-tableur\doc.styles.tex
```

After installation, run `texhash` in the terminal to update the package database.

---

## Usage

The main commands are:

| Command | Description |
|---|---|
| `\tableur[n]{A-F}` | Draw a spreadsheet with `n` rows and columns A to F |
| `\tableur[n]{A,B,C}` | Draw a spreadsheet with `n` rows and named columns |
| `\gentableur[n]{A/a,B/b,C/c}[X/Y/Z]` | Draw a spreadsheet with `n` rows and named columns with widths a, b, c width and with X,Y,Z height lines |
| `\tableur*[n]{A/2cm,B/5cm}` | Draw a spreadsheet with columns of different widths |
| `\celtxt[options]{col}{row}{text}` | Insert text or a formula into a cell |
| `\celtxt*[options]{col}{row}{text}` | Insert text in math mode |
| `\selecCell{A}{1}` | Highlight cell A1 as selected |
| `\multiSelec{A-1}{C-2}` | Highlight a range of cells from A1 to C2 |
| `\multimultiSelec{A-1}{A-3}{A-6}` | Visualise cell stretching from A1–A3 extended to A6 |
| `\renumLine{5}{text}` | Replace row label 5 with custom text (grey background) |
| `\renumLineSelect{5}{text}` | Replace row label 5 with custom text (blue background) |
| `\plagecouleur[color]{colStart-rowStart}{colEnd-rowEnd}` | draw background color for cells |
| `\plagebordures{colStart-rowStart}{colEnd-rowEnd}` | draw columns borders on cells |

### Quick example

```latex
\begin{tikzpicture}
  \tableur[2]{A,B,C}
  \celtxt[align=center]{A}{1}{=B1^2}
  \celtxt[align=right]{B}{2}{Some text}
\end{tikzpicture}
```

---

## Documentation

The full documentation (in French) is available:

- In the ZIP archive, under the `/doc/` directory
- Online: https://mirrors.ctan.org/macros/latex/contrib/pas-tableur/doc/pas-tableur.pdf

---

## Licence

This package may be redistributed and/or modified under the terms of the
[LaTeX Project Public License (LPPL)](https://www.latex-project.org/lppl/),
as distributed from CTAN archives in `macros/latex/base/lppl.txt`.
