% !TeX program = pdflatex
% Build from the repository root: l3build doc
\makeatletter
\def\input@path{{docs/}}
\makeatother
\documentclass[10pt,a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[margin=18mm,top=19mm,bottom=20mm,headheight=15pt]{geometry}
\usepackage{siunitx}
\usepackage{gradbars,booktabs,array,tabularx,amsmath}
\usepackage{tabularray}
\UseTblrLibrary{gradbars}
\usegradbarslibrary{distribution,legend,reports}
\usepackage{tcolorbox,fancyhdr}
\tcbuselibrary{listings,skins,breakable}
\usepackage[colorlinks=true,linkcolor=gradbarsBlue,urlcolor=gradbarsTeal,
  pdftitle={gradbars v1.1.0 English manual},pdfauthor={SuFan}]{hyperref}
\setcounter{tocdepth}{1}
\usepackage{indentfirst}
\setlength{\parindent}{2em}
\setlength{\emergencystretch}{2em}
% Tables occupy their declared width; only prose paragraphs are indented.
\AddToHook{env/tabular/before}{\noindent}
\AddToHook{env/tabularx/before}{\noindent}
\setlength{\parskip}{5pt}
\renewcommand{\arraystretch}{1.25}
\pagestyle{fancy}\fancyhf{}
\fancyhead[L]{\sffamily gradbars --- English manual}
\fancyhead[R]{v1.1.0}\fancyfoot[C]{\thepage}
\input{Chapter/en/code-style-en}
\lstdefinestyle{gradmanual}{language=[LaTeX]TeX,basicstyle=\gradbarscodefont\fontsize{8}{10}\selectfont,
  columns=fullflexible,keepspaces=true,breaklines=true,showstringspaces=false,
  moretexcs={gradheat,gradheader,gradspan,gradgroup,gradtablestyle,gradtableschema,graduseschema,gradcolumn,gradrow,gradbullet,gradintervals,gradbar,gradstack,graddumbbell,gradspark,gradcompare,gradrange,
    gradbarssetup,gradbarsstyle,gradbarscategory,gradbarslegend,
    gradbarscolumn,gradbarsloadcsv,gradbarcsv,gradbarscsvstyle,gradbarscsvtable},
  texcsstyle=*\color{gradbarsBlue},commentstyle=\color{black!55}}
\newtcblisting{demo}[1]{enhanced,listing engine=listings,
  listing options={style=gradmanual},text and listing,title={#1},
  colback=gradbarsTrack!50,colbacklower=blue!3,colframe=gradbarsInk!25,
  coltitle=gradbarsInk,colbacktitle=gradbarsTrack,fonttitle=\bfseries,
  boxrule=.4pt,arc=0pt,left=3mm,right=3mm,top=2mm,bottom=2mm,
  before upper={\setlength{\parskip}{6pt}\small}}
\lstnewenvironment{source}{\lstset{style=gradmanual}}{}

\definecolor{manualResult}{HTML}{FAFAE6}
\definecolor{manualCode}{HTML}{EEEEFF}
\newtcblisting{coverexample}[1]{enhanced,skin=bicolor,
  listing engine=listings,text side listing,
  listing options={style=gradmanual,basicstyle=\gradbarscodefont\fontsize{7.5}{9}\selectfont},
  title={#1},fonttitle=\scriptsize\bfseries,
  coltitle=gradbarsInk,colbacktitle=gradbarsTrack,
  colback=manualResult,colbacklower=manualCode,colframe=gradbarsInk!15,
  boxrule=.25pt,arc=0pt,lefthand width=59mm,sidebyside gap=4mm,
  left=2mm,right=2mm,top=1mm,bottom=1mm,
  before skip=3pt,after skip=3pt,sidebyside align=center,
  before upper={\small\setlength{\parskip}{2pt}}}
% Optional partial build after a full build (in the preamble):
% \includeonly{Chapter/en/install-en,Chapter/en/selection-en}
\gradbarsdeclarelibrary{manual-demo}{table}{docs/libraries/gradbars-contrib-demo.sty}
\usegradbarslibrary{manual-demo}
\begin{document}
\input{Chapter/en/cover-en}

\clearpage
\begingroup
\setlength{\parskip}{0pt}
\hypersetup{linkcolor=gradbarsInk}
\makeatletter
\renewcommand*{\l@part}[2]{\addpenalty\@secpenalty\addvspace{.7em}%
  {\bfseries\@dottedtocline{-1}{0pt}{0pt}{#1}{#2}}\nobreak}
\renewcommand*{\l@section}[2]{\@dottedtocline{1}{0pt}{2em}{#1}{#2}}
\makeatother
\small\tableofcontents
\endgroup
\medskip
\textbf{Reading this manual.} Start with data semantics, then choose a graphic.
Appearance and evaluation rules precede the dedicated table interface; complete
examples and the reference follow. Rendered examples use the source shown beside
or below them. All data are illustrative. The English and Chinese manuals cover
the same interfaces; their section and example numbers are independent.

% Chapters, in reading order.
\include{Chapter/en/install-en}
\include{Chapter/en/libraries-en}
\include{Chapter/en/extensions-en}
\include{Chapter/en/selection-en}
\include{Chapter/en/values-en}
\include{Chapter/en/signed-bars-en}
\include{Chapter/en/stack-en}
\include{Chapter/en/compare-en}
\include{Chapter/en/change-en}
\include{Chapter/en/spark-en}
\include{Chapter/en/distribution-en}
\include{Chapter/en/references-en}
\include{Chapter/en/heat-en}
\include{Chapter/en/legends-en}
\include{Chapter/en/themes-en}
\include{Chapter/en/overflow-en}
\include{Chapter/en/quality-en}
\include{Chapter/en/labels-en}
\include{Chapter/en/table-en}
\include{Chapter/en/table-graphics-en}
\include{Chapter/en/table-alignment-en}
\include{Chapter/en/column-scales-en}
\include{Chapter/en/table-width-en}
\include{Chapter/en/headers-en}
\include{Chapter/en/groups-en}
\include{Chapter/en/summaries-en}
\include{Chapter/en/table-themes-en}
\include{Chapter/en/table-definitions-en}
\include{Chapter/en/reports-en}
\include{Chapter/en/longtable-en}
\include{Chapter/en/tabularray-en}
\include{Chapter/en/csv-en}
\include{Chapter/en/research-numbers-en}
\include{Chapter/en/example-models-en}
\include{Chapter/en/layouts-en}
\include{Chapter/en/faq-en}
\include{Chapter/en/reference-en}
\include{Chapter/en/table-reference-en}

\end{document}