\documentclass[a4paper,10pt,oneside,openany,fleqno]{article}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\usepackage[hyperref]{pgf-PeriodicTable}
\usepgfPTlibrary{colorschemes,fittowidth,override}%
\input{manualfiles/pgfPTmanual.macros.tex}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\title{Manual for pgf-PeriodicTable \pgfPTversion}
\author{Hugo Gomes\\
  \texttt{hugo.parelho@gmail.com}}
\date{\today}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}%
\usefont{T1}{verdana}{m}{n}%
\begin{titlepage}
\vspace{\stretch{1}}%
\maketitle\thispagestyle{empty}%
\vspace{-1cm}%
\makebox[\linewidth][c]{\scalebox{.6}{\pgfPT[show title=false,show legend=false]}}%
\\ [6pt]\makebox[\linewidth][c]{\bfseries\footnotesize\textsf{\pgfPTMmacro{pgfPT}[show title=false,show legend=false]}}%
\vspace{\stretch{6}}
\makebox[\linewidth][c]{\tikz{%
\node[text width=.9\linewidth+.5cm,text justified,draw=blue!10!black,rounded corners=10pt,fill=blue!5] at (0,0) {\color{blue!10!black}
\begin{abstract}
\noindent The purpose of this package is to provide the Periodic Table of Elements in a simple way. It relies on pgf/\txttikz{} to offer a full or partial periodic table with a variety of options and displaying the desired data. The data available, from all the actual 118 elements, is: atomic number, element name, chemical symbol, relative atomic mass, standard relative atomic mass, radioactivity, atomic radius (empirical), covalent radius, ionic radius, first ionization energy, electronegati\-vity (Pauling), electroaffinity, oxidation states, melting point (in Kelvin and Celsius degrees), boiling point (in Kelvin and Celsius degrees), electron distribution, electronic configuration (increasing $n$ and increasing $n+\ell$), density, specific heat capacity, thermal conductivity, lattice structure, lattice constants (a, b, c and c/a ratio), discovery year, discovery country and visible range spectral lines. It is possible to get the Periodic Table in different languages: English, French, German, Portuguese (from Portugal and from Brazil), Spanish, Italian and translations provided by user contributions -- currently in Dutch, Chinese, Russian, Ukrainian and Slovenian.
\\ [6pt]
\end{abstract}
};}}
\vspace{\stretch{3}}
\end{titlepage}
\newpage%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\pagestyle{empty}%
\pdfbookmark[1]{Table of contents}{pdfContents}%
\tableofcontents%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage\setcounter{page}{1}%
\pagestyle{pgfPTManual}%
\ \vfill%
\section{Getting started}
\subsection{Installation}
\noindent
\pack{} is placed under the terms of the \textrm{\LaTeX} Project Public License, version 1.3 or later (http://www.latex-project.org/lppl.txt). \pack{} loads and requires the \href{https://www.ctan.org/pkg/pgf}{\txttikz{}} and \href{https://ctan.org/pkg/fontenc}{fontenc} or \href{https://ctan.org/pkg/fontspec}{fontspec} (at least v2.7h -- 2020/02/03) packages.
\\ [6pt]You need to put the package files (pgf-PeriodicTable.sty \&\ \textit{friends}) in a location where \textrm{PDF\LaTeX}, \textrm{Lua\LaTeX} or \textrm{Xe\LaTeX} can find them. According to the TDS conventions this may be a subdirectory named \textit{tex/latex/pgf-PeriodicTable/} or \textit{tex/latex/misc/} in your (site specific) installation tree (insert your appropriate directory delimiter instead of /, if needed).
\subsection{Package loading and options}
If you are using \textrm{PDF\LaTeX}, \textrm{Lua\LaTeX} or \textrm{Xe\LaTeX} you can just simply include the style file without any option via the \texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}} command, \texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [6pt]It can also be loaded with a comma separated list of \textit{options} to select the desired default language, to use Devanagari or Mandarin numerals in the Atomic Number, Periods and/or Groups, to fix the interaction with the beamer class or to use links within the Periodic Table.
\subsubsection{Language Option}
There are six \textit{built-in }languages -- English, French, German, Portuguese (from Portugal and Brazil), Spanish and Italian. The default language used in the package may be selected at package loading:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{language flag}\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [6pt]\textit{The \textcolor{brown!60!black}{language flags} available are:}
\vspace{2pt}\hrule\vspace{4pt}
\begin{minipage}[t]{.5\linewidth}
\begin{itemize}
\item[$\checkmark$]\textbf{en} for English (default),
\item[$\checkmark$]\textbf{fr} for French,
\item[$\checkmark$]\textbf{de} for German,
\item[$\checkmark$]\textbf{pt} for Portuguese (Portugal),
\end{itemize}\end{minipage}\begin{minipage}[t]{.5\linewidth}
\begin{itemize}
\item[$\checkmark$]\textbf{br} for Portuguese (Brazil),
\item[$\checkmark$]\textbf{es} for Spanish and
\item[$\checkmark$]\textbf{it} for Italian.
\end{itemize}\end{minipage}
\vspace{4pt}\hrule\vspace{12pt}
A \textit{user language} can also be chosen as default language loading the package with the following option syntax:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{userlang=<ISO 639-1 CODE>}\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [6pt]\textit{The \textcolor{brown!60!black}{user language ISO CODES} available are:}
\vspace{2pt}\hrule\vspace{4pt}
\begin{minipage}[t]{.5\linewidth}
\begin{itemize}
\item[$\checkmark$]\textbf{nl} for Dutch,
\item[$\checkmark$]\textbf{ru} for Russian,
\item[$\checkmark$]\textbf{uk} for Ukranian,
\end{itemize}\end{minipage}\begin{minipage}[t]{.5\linewidth}
\begin{itemize}
\item[$\checkmark$]\textbf{zh} for Chinese (simplified),
\item[$\checkmark$]\textbf{sl} for Slovenian.
\end{itemize}\end{minipage}
\vspace{4pt}\hrule\vspace{12pt}
\tikz{\node[text width=\linewidth-6mm,draw=green!70,rounded corners=2pt,fill=black!10!green!10,inner sep=3mm] {Anyone who wishes to contribute with translations for use in this package can go to the \tikz[baseline=(b.base)]{\node[inner sep=0pt] (a) {\includegraphics[height=10pt]{manualfiles/pgfPTgithub-mark.pdf}}; \node[right,inner sep=0pt,xshift=.1em] (b) at (a.east) {\href{https://github.com/HugoPGomes/pgf-periodictable}{pgf-periodictable}};} project page.};}
\newpage%\\ [6pt]
\textbf{Note that the \textit{built-in} languages are always available for the \textcolor{red!60!black}{languages} option of the \bs{pgfPT} command, but the \textit{user language} is only available if loaded with the package.}
\subsubsection{Devanagari numerals}
It is possible to get some numbers in the Periodic Table with Devanagari numerals: the atomic number and the numeration of periods and groups. To get this feature enabled the package must be loaded with the option \textit{numerals} set to \textbf{dvn}:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{numerals=dvn}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [6pt]\tikz{\node[text width=\linewidth-6mm,draw=orange!70,rounded corners=2pt,fill=black!10!orange!10,inner sep=3mm] {
This option requires the \textrm{Xe\LaTeX} engine to typeset the document.};}
\\ [10pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[numerals=dvn]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPTnumDeva.pdf}}}%
\\ [3pt]\pgfPTMline
\\ [6pt]It is also possible to load a font for the Devanagari numerals using the following command:
\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfPTdvnfont}%
\\ [3pt]\bs{pgfPTdvnfont}\lp\red{font options}\rp\lb\red{font name}\rb
\\ [3pt]The default font is \textit{Eczar}.
\vfill
\subsubsection{Mandarin numerals}
To get some numbers of the Periodic Table with Mandarin numerals (the atomic number and the numeration of periods and groups) the package must be loaded with the above option \textit{numerals} set to \textbf{zh}:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{numerals=zh}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [6pt]\tikz{\node[text width=\linewidth-6mm,draw=orange!70,rounded corners=2pt,fill=black!10!orange!10,inner sep=3mm] {
This option works with the \textrm{Xe\LaTeX} and \textrm{Lua\LaTeX} engines to typeset the document and requires the \texttt{\large zhnumber} package, which is automatically loaded.};}
\newpage%\\ [10pt]
\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[numerals=zh]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPTnumMand1.pdf}}}%
\\ [3pt]\pgfPTMline
\\ [6pt]As with the Devanagari numerals, the following command loads the specified font for the Mandarin numerals:
\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfPTzhnumberfont}%\pgfPTzhnumberfont
\\ [3pt]\bs{pgfPTzhnumberfont}\lp\red{font options}\rp\lb\red{font name}\rb
\\ [3pt]\textit{For backwards compatibility (up to v2.1.4) the previous \bs{pgfPTzhfont} command now points to \bs{pgfPTzhnumberfont}, so older documents do not need any changes}.
\\ [3pt]The default font is \textit{BabelStone Han} (since v2.1.5) loaded with the \textit{AutoFakeBold=4} option. For details on installing this font, see the \hyperlink{subsec::zhLang}{Chinese (zh) subsection} below.
\\ [6pt]It is also possible to enable or disable the numbers shown in Mandarin with the command:
\\ [3pt]\bs{pgfPTzhnumber}\lp\red{<true|false>}\rp\lb\red{comma separated list}\rb
\\ [3pt] The list can have \red{Z} for the atomic number, \red{per} for the period numbers and \red{gr} for the group numbers. At package loading, with this option, they are set to \red{true}.
\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfPTzhnumber}%
\\ [10pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[numerals=zh]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=center,fill=black!10,rounded corners=2pt] %
{\bs{pgfPTzhnumber}\lp\red{false}\rp\lb\red{Z}\rb};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[Z list={1,...,36}]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPTnumMand2.pdf}}}%
\\ [3pt]\pgfPTMline
\subsubsection{hyperref}
This option loads the \textrm{\large hyperref} package and make available the keys \red{Z links} and \red{Z links color}. The \red{Z links} key provides an easy way to create links within the Periodic Table, to any destinations in the document. To learn how it is used, click on the chemical symbol for hydrogen below:
\\ \pgfPTfittowidth[12pt]\makebox[\linewidth][c]{\pgfPT[Z links={1/option_Z links},show title=false,show legend=false]}\pgfPTendfittowidth
\newpage%
\subsection{User languages}
\textit{User languages} are provided by user translations. They are only available if passed as an option when loading the package. In addition to the \textit{built-in} languages, the chosen language is the only one available and becomes the default language for the Periodic Table.
\bigskip
\subsubsection{Dutch (nl)}
The Dutch language is loaded by:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{userlang=nl}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [10pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[userlang=nl]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPT_nl.pdf}}}%
\\ [3pt]\pgfPTMline
\bigskip
\subsubsection{Chinese (zh)}
\hypertarget{subsec::zhLang}{The Chinese language} is loaded by:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{userlang=zh}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [6pt]\tikz{\node[text width=\linewidth-6mm,draw=orange!70,rounded corners=2pt,fill=black!10!orange!10,inner sep=3mm] {%
The default font is \textit{BabelStone Han} \textbf{which is not available in TeX Live}.
\\ It can be downloaded for free from the BabelStone website:
\\ [3pt]\hfil\href{https://www.babelstone.co.uk/Fonts/Han.html}{https://www.babelstone.co.uk/Fonts/Han.html}\hfil};}
\\ [6pt]The use of a font which is not included in the TeX Live software distribution, nor in common Operating Systems, circumvents the missing Ideographs for the most recent elements -- from rutherfordium to oganesson. The BabelStone Han has all of them as can be seen in the following table:
\begin{center}\small
\includegraphics[width=\linewidth]{manualfiles/pgfPT_zh_fonts.pdf}
\\ [3pt]Glyphs available in \textsf{BabelStone Han} font and in some Windows and TeX Live fonts.
\end{center}
\vfill%
To use the BabelStone Han it is necessary to \href{https://www.babelstone.co.uk/Fonts/Download/BabelStoneHan.zip}{download it}, unzip it and install the extracted font file:
\begin{itemize}\small
\item for Windows users, just right click on \textsf{BabelStoneHan.ttf} and choose \textsf{install for all users}. This can also be done in Windows Settings $\rightarrow$ Personalization $\rightarrow$ Fonts.
\item for Linux users, open the Linux Terminal and type \textsf{sudo apt install fonts-BabelStoneHan.ttf}
\item for macOS users, just copy or drag the font file (\textsf{BabelStoneHan.ttf}) into \textsf{/Library/Fonts} or \mbox{double-click} on \textsf{BabelStoneHan.ttf} to open the preview window. Click on \textsf{Install font} button at the bottom of the preview window.
\end{itemize}\medskip
Make sure the \textsf{BabelStone Han} font is \textit{visible} to the \textrm{Xe\LaTeX} or \textrm{Lua\LaTeX} engines.
\\ [9pt]If you do not want to install this font on your operating system, you can place it in the \textsf{truetype} fonts folder in the TeX Live distribution and \textit{Update filename database} in the TeX Live manager. After that, the font will be known only by the filename \textsf{BabelStoneHan.ttf} instead of its name, \textsf{BabelStone Han}.
\newpage%
\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[userlang=zh]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPT_zh_1.pdf}}}%
\\ [3pt]\pgfPTMline
\vfill
To get the Periodic Table with the atomic number and the period/group numbers in mandarin numerals load the package with the correponding options:
\\ [10pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[userlang=zh,numerals=zh]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPT_zh_2.pdf}}}%
\\ [3pt]\pgfPTMline
\newpage%
When the Chinese language is loaded four extra commands are defined:
\begin{itemize}
\item\bs{pgfPTzhFontFeatures}\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfPTzhFontFeatures} can be used to set font features for the loaded Chinese font (set by the \red{font} option). For more details see the \textsf{fontspec} package documentation.
\item\bs{pgfPTzhtextfontSS}\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfPTzhtextfontSS} is used to set the font for the elements meitnerium, copernicium, nihonium, tennessine and oganesson (Z=109, 112. 113, 117 and 118).
\item\bs{pgfPTzhtextfontSSB}\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfPTzhtextfontSSB} is used to set the font for the elements rutherfordium, dubnium, seaborgium, bohrium, hassium,darmstadtium, roentgenium and flerovium (Z=104, 105, 106, 107, 108, 110, 111 and 114).
\item\bs{pgfPTzhtextfontLv}\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfPTzhtextfontLv} is used to set the livermorium (Z=116) font.
\end{itemize}
The defaults for some features of the Periodic Table are also changed:
\begin{itemize}
\item[--]the \red{name font} is switched from \texttt{\large\textbackslash tiny} to \texttt{\large\textbackslash footnotesize}.
\item[--]the \red{CS font} is switched from \texttt{\large\textbackslash small\textbackslash bfseries} to \texttt{\large\textbackslash large}.
\item[--]the \red{title font} is switched from \texttt{\large\textbackslash Large\textbackslash bfseries} to \texttt{\large\textbackslash LARGE}.
\item[--]when not using the Chinese numerals (loaded with the option \textcolor{brown!60!black}{numerals=zh}) the \red{Z font} is switched from \texttt{\large\textbackslash tiny\textbackslash bfseries} to \texttt{\large\textbackslash scriptsize}, as well the \red{Z padding} is changed from \texttt{\large 0.25ex} to \texttt{\large 0ex}.
\end{itemize}
\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[userlang=zh]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt,text=black!50] %
{\bs{pgfPTzhtextfontSS}\lb\red{SimSun}\rb\% font for Z=\{109,112.113,117,118\}
\\ \makebox[8em][s]{}\% meitnerium, copernicium, nihonium, tennessine, oganesson
\\ \bs{pgfPTzhtextfontSSB}\lb\red{SimSun-ExtB}\rb\% font for
\\ \makebox[8em][s]{}\% Z=\{104,105,106,107,108,110,111,114\}
\\ \makebox[8em][s]{}\% rutherfordium, dubnium, seaborgium, bohrium, hassium,
\\ \makebox[8em][s]{}\% darmstadtium, roentgenium, flerovium
\\ \bs{pgfPTzhtextfontLv}\lb\red{SimSun-ExtB}\rb\% font for Z=116
\\ \makebox[8em][s]{}\% livermorium
};}%
\\ [-4pt]\pgfPTMmacrobox[l]{pgfPT}[font=SimSun]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPT_zh_3.pdf}}}%
\\ [3pt]\pgfPTMline
\newpage
\subsubsection{Russian (ru)}
The Russian language is loaded by:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{userlang=ru}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [10pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[userlang=ru]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPT_ru.pdf}}}%
\\ [3pt]\pgfPTMline
\bigskip
\subsubsection{Ukrainian (uk)}
The Ukrainian language is loaded by:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{userlang=uk}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [10pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[userlang=uk]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPT_uk.pdf}}}%
\\ [3pt]\pgfPTMline
\bigskip
\subsubsection{Slovenian (sl)}
The Slovenian language is loaded by:
\\ [3pt]\texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{userlang=sl}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}}
\\ [10pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\%\ \string\usepackage[userlang=sl]\{pgf-PeriodicTable\}}};}%
\\ [-4pt]\pgfPTMmacrobox{pgfPT}[]%
\\ [10pt]\makebox[\linewidth][c]{\scalebox{.6}{\includegraphics{manualfiles/pgfPT_sl.pdf}}}%
\\ [3pt]\pgfPTMline
\bigskip
\newpage%
\subsection{Interaction with other packages}
\subsubsection{fontspec}
To correctly set the font in each cell contents the command \bs{fontspec} must be used. For example if you want to use \textit{Arial} for the \red{name font}, it must be set using \red{name font=\bs{fontspec}\lb Arial\rb\bs{selectfont}}.\\ All other font selection commands, \eg, \bs{large}, \mbox{\bs{itshape}}, are used as usual. For example if you want to use \textit{Arial}\hfil\ in\hfil\ \textit{large}\hfil\ size\hfil\ and\hfil\ \textit{bold}\hfil\ weight\hfil\ for\hfil\ the \red{name font}, then you type
\\ \makebox[\linewidth][s]{\red{name font=\bs{large}\bs{bfseries}\bs{fontspec}\lb Arial\rb\bs{selectfont}}\hfil\ or\hfil\  \red{name font=\bs{fontspec}\lb Arial\rb}}
\\ \bs{large}\bs{bfseries}\bs{selectfont}.
\subsubsection{ragged2e}
Using \texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}\textcolor{blue!70!black}{[}\textcolor{brown!60!black}{document}%
\textcolor{blue!70!black}{]}\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{ragged2e}\textcolor{purple!40!black}{\}}} and \texttt{\large\textcolor{green!40!black}{\textbackslash usepackage}%
\textcolor{purple!70!black}{\{}\textcolor{blue!70!black}{pgf-PeriodicTable}\textcolor{purple!40!black}{\}}} together, the Periodic Table will be completely fractured and out of the page.
\\ [6pt]\textit{The solution is to use a local group}:
\\ [2pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\{\string\justifying\string\pgfPT\}}};}%
%\vspace{4pt}\hrule\vspace{4pt}Use a local group: \{\bs{justifying}\bs{pgfPT}\}\vspace{4pt}\hrule%
\subsubsection{beamer}
\textrm{\large beamer}, \pack{} and \textrm{PDF\LaTeX} in combination have an issue: the \texttt{\large\textbackslash textsc} fails to produce the correct small caps. The error given is:
\smallskip\hrule\begin{verbatim}
Font shape `T1/cmss/m/sc' undefined
(Font) using `T1/cmss/m/n' instead on input line ...
\end{verbatim}\hrule
\smallskip\hrule\smallskip\bigskip
To avoid this, the \pack{} package can be loaded with one of the following options:
\begin{description}
\item[\red{beamer}] which loads the \textrm{\large lmodern} package, setting small caps compatibility with beamer via `lmodern' package.
\\ \tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\string\usepackage[beamer]\{pgf-PeriodicTable\}}};}%
\item[\red{beamer*}] which sets small caps compatibility with beamer via T1 \textrm{\large cmr} fonts.
\\ \tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\string\usepackage[beamer*]\{pgf-PeriodicTable\}}};}%
\item[\red{beamer**}] which sets small caps compatibility with beamer via T1 \textrm{\large cmr} fonts and loads the \textrm{\large silence} package to suppress small caps font substitution warnings.
\\ \tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\string\usepackage[beamer**]\{pgf-PeriodicTable\}}};}%
\end{description}
\subsubsection{babel}
\textrm{\large babel} with option \textrm{\large[spanish]} and \pack{} in combination have an issue. The error given is:
\smallskip\hrule\begin{verbatim}
! Missing \endcsname inserted.
<to be read again>
                    \protect
\end{verbatim}\hrule
\smallskip\hrule\smallskip\bigskip
To avoid this add the following to the document preamble:
\\ [2pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\string\usepackage[spanish,es-nolayout]\{babel\}}};}%
\\ or
\\ [2pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\string\def\string\spanishoptions\{es-nolayout\}}\\
\textcolor{black!50}{\string\usepackage[spanish]\{babel\}}};}%
\\ \textit{The es-nolayout option disables layout changes in the document when spanish is the main
language. These changes affect enumerated and itemized lists, enumerations (alphabetic order excludes
ñ), and symbolic footnotes}. See the \href{https://mirrors.ctan.org/macros/latex/contrib/babel-contrib/spanish/spanish.pdf#page=20}{babel-spanish manual} for further details.
\subsubsection{graphicx (\textbackslash resizebox) \& preview}
The command \textrm{\large\textbackslash resizebox} of package \textrm{\large graphicx} and package \textrm{\large preview} in combination have an issue.
\smallskip\hrule\begin{verbatim}
\documentclass[a4paper]{article}
\usepackage{pgf-PeriodicTable}
\usepackage[active,tightpage]{preview}
\PreviewEnvironment{tikzpicture}
\setlength\PreviewBorder{0pt}

\begin{document}
\resizebox{.95\linewidth}{!}{\pgfPT}
\end{document}
\end{verbatim}\hrule
\smallskip\hrule\smallskip\bigskip
The error given is:
\smallskip\hrule\begin{verbatim}
! Package graphics Error: Division by 0.
See the graphics package documentation for explanation.
\end{verbatim}\hrule
\smallskip\hrule\smallskip\bigskip
To avoid this add the following \textcolor{red!70!black}{line} to the document preamble:
\\ [2pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt,font=\small] %
{\vspace{-10pt}\color{black!50}\begin{verbatim}
\documentclass[a4paper]{article}
\usepackage{pgf-PeriodicTable}
\usepackage[active,tightpage]{preview}
\PreviewEnvironment{tikzpicture}
\end{verbatim}
\vspace{-18pt}\color{red!70!black}\begin{verbatim}
\PreviewMacro[{*{}{}{}}]{\resizebox}
\end{verbatim}
\vspace{-20pt}\color{black!50}\begin{verbatim}
\setlength\PreviewBorder{0pt}

\begin{document}
\resizebox{.95\linewidth}{!}{\pgfPT}
\end{document}
\end{verbatim}%
};}%
\subsubsection{extdash}
The use of the package \textrm{\large extdash} with the \textrm{\large[shortcuts]} option, raises a lot of errors. The fist error is:
\smallskip\hrule\begin{verbatim}
Undefined control sequence \HyphOrDash  ->\let \EXD@break
                   \@empty \@ifnextchar /{\EXD@d@sh }{\@ifnextch...
\end{verbatim}\hrule
\smallskip\hrule\smallskip\bigskip
To avoid this, the \pack{} package can be loaded with the following option:
\\ [2pt]\tikz{\node[text width=\linewidth-8pt,inner xsep=4pt,align=left,fill=black!10,rounded corners=2pt] %
{\small\textcolor{black!50}{\string\usepackage[extdash]\{pgf-PeriodicTable\}}
\\ \textcolor{black!50}{\string\usepackage[shortcuts]\{extdash\}}
};}%
\newpage
\section{The data}
The data available in \pack{} was mainly compiled with selected and filtered data from Wikipedia, taken from November 2021 to July 2022.
\\ [12pt]\header
\\ [-1pt]\linhaimpar{Ar}{Relative Atomic Mass}{}{(Wikidata @09/jan/2022)}%
\\ [-1pt]\linhapar{Arstar}{Standard Relative\newline Atomic Mass}{}{ STANDARD ATOMIC WEIGHTS 2021, %
Commission on Isotopic Abundances and Atomic Weights,\newline\bfseries\textsf{\textcopyright} CIAAW, 2007--2022%
\newline(\href{https://ciaaw.org/impressum.htm}{https://ciaaw.org/impressum.htm})}%
\\ [-1pt]\linhaimpar{radio}{Radioactivity}{}{(gperiodic-3.0.3, Dec 26 2018)}%
\\ [-1pt]\linhapar{R}{Atomic Radius}{$\mathsf{pm}$}{Calculated (Wikidata @04/jul/2022)}%
\\ [-1pt]\linhaimpar{Rcov}{Covalent Radius}{$\mathsf{pm}$}{Single bond, Wikidata @04/jul/2022)}%
\\ [-1pt]\linhapar{Rion}{Ionic Radius}{$\mathsf{pm}$}{(Wikidata @04/jul/2022)}%
\\ [-1pt]\linhaimpar{Ei}{First Ionization Energy}{$\mathsf{kJ\cdot mol^{-1}}$}{(Wikidata @04/jul/2022)}%
\\ [-1pt]\linhapar{eneg}{Electronegativity\newline (Pauling)}{}{(Wikidata @04/jul/2022)}%
\\ [-1pt]\linhaimpar{eaff}{Electroaffinity}{$\mathsf{kJ\cdot mol^{-1}}$}{(Wikidata @04/jul/2022)}%
\\ [-1pt]\linhapar{O}{Oxidation States}{}{(Wikidata @09/jan/2022)}%
\\ [-1pt]\linhaimpar{Tmelt}{Melting Point}{$\mathsf{K}$}{at standard pressure (Wikidata @21/dez/2021)}%
\\ [-1pt]\linhapar{TmeltC}{Melting Point}{$\mathsf{^oC}$}{at standard pressure (Wikidata @21/dez/2021)}%
\\ [-1pt]\linhaimpar{Tboil}{Boiling Point}{$\mathsf{K}$}{at standard pressure (Wikidata @21/dez/2021)}%
\\ [-1pt]\linhapar{TboilC}{Boiling Point}{$\mathsf{^oC}$}{at standard pressure (Wikidata @21/dez/2021)}%
\\ [-1pt]\linhaimpar{eDist}{Electron Distribution}{}{(Wikidata @01/nov/2021)}%
\\ [-1pt]\linhapar{eConfign}{Electronic Configuration (increasing n)}{}{(Wikidata @01/nov/2021)}%
\\ [-1pt]\linhaimpar{eConfignl}{Electronic Configuration (increasing $\mathsf{n+\ell}$)}{}{(Wikidata @01/nov/2021)}%
\\ [-1pt]\linhapar{d}{Density}{$\mathsf{g\cdot dm^{-3}}$ {\tiny for gases}\newline$\mathsf{g\cdot cm^{-3}}$ {\tiny all other physical states}}{physical state at $\mathsf{25^oC, 1\,atm}$ (Wikidata @01/nov/2021)}%
\\ [-1pt]\linhaimpar{Cp}{Specific heat capacity}{$\mathsf{J\cdot mol^{-1}\cdot K^{-1}}$}{at $\mathsf{25^oC}$ and $\mathsf{100\,kPa}$ (Wikidata @20/nov/2021)}%
\\ [-1pt]\linhapar{kT}{Thermal Conductivity}{$\mathsf{W\cdot m^{-1}\cdot K^{-1}}$}{at $\mathsf{25^oC}$ (Wikidata @21/nov/2021)}%
\\ [-1pt]\linhaimpar{ls}{Lattice Structure}{}{(Wikidata @20/dez/2021 and \href{http://wwwhomes.uni-bielefeld.de/achim/ele_structures.html}{University of Bielefeld})}%
\\ [-1pt]\linhapar{lsa}{Lattice constant: a}{$\mathsf{pm}$}{(University of Bielefeld @21/dez/2021)}%
\\ [-1pt]\linhaimpar{lsb}{Lattice constant: b}{$\mathsf{pm}$}{(University of Bielefeld @21/dez/2021)}%
\\ [-1pt]\linhapar{lsc}{Lattice constant: c}{$\mathsf{pm}$}{(University of Bielefeld @21/dez/2021)}%
\\ [-1pt]\linhaimpar{lsca}{Lattice c/a ratio}{}{Calculated from available data and rounded to two digits}%
\\ [-1pt]\linhapar{DiscY}{Discover Year}{}{(Wikidata @22/dez/2021)}%
\\ [-1pt]\linhaimpar{DiscC}{Discover Country}{}{(Wikidata @22/dez/2021)}%
\\ [-1pt]\linhapar{spectra}{Visible range spectral lines}{}{Elements spectrum made with \textcolor{blue!50!black}{\textbackslash pgfspectra}.\newline See the \footnotesize\href{https://ctan.org/pkg/pgf-spectra}{\textsf{pgf-spectra}}\scriptsize\ manual for more details}%
\\ [12pt]The utilization of the \textit{acronyms} will be explained in \hyperlink{secBuildCell}{Designing cells with \textbackslash pgfPTbuildcell}.
\vfill\vfill\vfill\newpage
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%\label{file:commands}%
%\input{manualfiles/pgf-PeriodicTableManual_commands.tex}%
\newpage%
\def\tmpSection{\bs{pgfPT}}%
\section{\texorpdfstring{Options for \tmpSection: creating a «Periodic Table»}{Options for \textbackslash pgfPT: creating a «Periodic Table»}}
\hypertarget{OPTIONS}{For the commands} \pgfPTMmacro{pgfPT}[] and \pgfPTMmacro{pgfPTstyle}[] there are a set of options available to draw the Periodic Table or any portion of the Periodic Table, as described below.
\\ [6pt]\tikz{\node[text width=\linewidth-6mm,draw=green!70,rounded corners=2pt,fill=black!10!green!10,inner sep=3mm] {%,text justified
\color{green!40!black}The list of options is a comma separated list of any of the following elements:
{\small\begin{itemize}
\item[$\rightsquigarrow$] a \sq{\red{key}} or a \sq{\red{key=value}} pair,
\item[\ding{252}] a \sq{\red{style}} or a \sq{\red{style=value}} pair,
\item[\ding{252}] a \textit{pseudo style} with a proper syntax: \sq{\red{style=\{key 1=value 1, key 2=value 2, \myldots\ , key n=value n\}}}, where none of the \textit{\sq{\red{keys}}} are mandatory.
\end{itemize}}
};}
\\ [3pt]The options \textit{can be divided} in two subsets, one that affects the \textit{appearance} of the \textit{entire} Periodic Table, the other that concerns the \textit{contents} of each cell of the Periodic Table.
\subsection{\texorpdfstring{$\maltese$ Periodic Table options: keys, styles and \itshape pseudo styles}{Periodic Table options}}
The following options and styles are used to \textit{control} the Periodic Table \textit{as a whole} in various aspects, such as the \red{cell width} or \red{cell height}, which elements are displayed (\red{Z list}), whether the title or legend are shown --  \red{show title} or \red{show legend} -- among others.
\label{file:generallayout}%
\input{manualfiles/pgf-PeriodicTableManual_generallayout.tex}%
\label{file:TitleLegend}%
\input{manualfiles/pgf-PeriodicTableManual_TitleLegend.tex}%
\label{file:periodgroup}%
\input{manualfiles/pgf-PeriodicTableManual_periodgroup.tex}%
\label{file:blocksfamilies}%
\input{manualfiles/pgf-PeriodicTableManual_blocksfamilies.tex}%
\newpage%
\label{file:variations}%
\input{manualfiles/pgf-PeriodicTableManual_variations.tex}%
\newpage%
\label{file:DarkMode}%
\input{manualfiles/pgf-PeriodicTableManual_DarkMode.tex}%
\label{file:exerciselayout}%
\input{manualfiles/pgf-PeriodicTableManual_exerciselayout.tex}%
\subsection{\texorpdfstring{$\maltese$ Cell contents options: keys, styles and \itshape pseudo styles}{Cell contents options}}
The following options and styles are used for customizing the contents available in each individual cell of the Periodic Table, like the \textit{fonts} or the \textit{colors} used in the shown contents.
\label{file:decSep}%
\input{manualfiles/pgf-PeriodicTableManual_decSep.tex}%
\label{file:Z}%
\input{manualfiles/pgf-PeriodicTableManual_Z.tex}%
\label{file:Z}%
\input{manualfiles/pgf-PeriodicTableManual_radio.tex}%
\label{file:CS}%
\newpage%
\input{manualfiles/pgf-PeriodicTableManual_CS.tex}%
\label{file:name}%
\input{manualfiles/pgf-PeriodicTableManual_name.tex}%
\label{file:Ar}%
\input{manualfiles/pgf-PeriodicTableManual_Ar.tex}%
\label{file:O}%
\input{manualfiles/pgf-PeriodicTableManual_O.tex}%
\label{file:density}%
\input{manualfiles/pgf-PeriodicTableManual_density.tex}%
\label{file:ls}%
\input{manualfiles/pgf-PeriodicTableManual_ls.tex}%
\label{file:DiscY}%
\input{manualfiles/pgf-PeriodicTableManual_DiscY.tex}%
\label{file:eDist}%
\input{manualfiles/pgf-PeriodicTableManual_eDist.tex}%
\label{file:OtherCont}%
\input{manualfiles/pgf-PeriodicTableManual_OtherCont.tex}%
\newpage%
\label{sec:pgfPTbuildcell}
\def\tmpSection{\bs{pgfPTbuildcell}}%
\hypertarget{secBuildCell}{}%
\section{\texorpdfstring{Designing cells with \tmpSection}{Designing cells with \textbackslash pgfPTbuildcell}}
\input{manualfiles/pgf-PeriodicTableManual_buildCelll.tex}%
\newpage%
\section{\texorpdfstring{Designing color schemes}{Designing color schemes}}
\label{file:DesignCS}%
\input{manualfiles/pgf-PeriodicTableManual_DesignCS.tex}%
\newpage\ \vspace{1.6cm}%
\section{Libraries}
In this part the \hypertarget{sec:lib}{library} packages are documented. They provide additional commands to extend the capabilities provided by this package out of the box. The libraries are not loaded by default since many users will not need them.
\\ [1.6cm]%
\label{lib:pgfPT.library.ColorSchemes}
\input{manualfiles/pgf-PeriodicTableManual_libCS.tex}%
\label{sec:pgfPT,library.fittowidth}
\newpage
\input{manualfiles/pgf-PeriodicTableManual_libFW.tex}%
\label{sec:pgfPT,library.override}
\newpage
\input{manualfiles/pgf-PeriodicTableManual_libOR.tex}%
\newpage%
\section{Tips \& Tricks: inspired by user questions}
In this section a list of selected user questions and the corresponding answers can be found, hoping it can be useful to anyone using this package.
\input{manualfiles/pgf-PeriodicTableManual_TipsTricks}
\newpage%
\section{A few more examples}
\input{manualfiles/pgf-PeriodicTableManual_Examples.tex}%
\newpage\small%
\printindex%
\end{document}
