| 1 |
This is pgf-PeriodicTable, version 2.1.6 (2026/05/03). |
| 2 |
|
| 3 |
The purpose of this package is to provide the Periodic Table of Elements in |
| 4 |
a simple way. It relies on pgf/TikZ to offer a full or partial periodic table with |
| 5 |
a variety of options and displaying the desired data for all the 118 |
| 6 |
elements. It can be done in different languages: English, French, German, |
| 7 |
Portuguese (from Portugal and from Brazil), Spanish, Italian and translations |
| 8 |
by user contributions - currently in currently in Dutch, Chinese, Russian, |
| 9 |
Ukrainian and Slovenian. |
| 10 |
____________________________________________________________ |
| 11 |
|
| 12 |
Just typeset \pgfPT to get a Periodic Table of Elements or \pgfPT[<options list>] |
| 13 |
to do it at your custom way. |
| 14 |
____________________________________________________________ |
| 15 |
|
| 16 |
** Requirements: TikZ and fontenc (pdfLaTeX) or fontspec (XeLaTeX or LuaLaTeX) packages. |
| 17 |
** Installation: unpack everything in a directory in the TeX search path and refresh the TeX database. |
| 18 |
** Usage: just place \usepackage{pgf-PeriodicTable} in the preamble. |
| 19 |
** Contact the author: Hugo Gomes ([email protected]) |
| 20 |
** Licence: released under the LaTeX Project Public License v1.3 or later, see http://www.latex-project.org/lppl.txt |
| 21 |
____________________________________________________________ |
| 22 |
____________________________________________________________ |
| 23 |
|
| 24 |
Major changes: |
| 25 |
*** v2.1.6a (06/05/2026) *** |
| 26 |
Correction of the pgf-PeriodicTable.sty file: the previous version, 2.1.5, was included in the update to version 2.1.6. |
| 27 |
|
| 28 |
*** v2.1.6 (03/05/2026) *** |
| 29 |
Small bug fixes: |
| 30 |
- the font selection in eDist is now within a group |
| 31 |
- alignment for unavailable values '---' is now correctly centered vertically |
| 32 |
- fixed a problem that occurs when changing the Z position (with \pgfPTbuildcell) |
| 33 |
- fixed the resizing of boxes for some numeric values (larger than the width given in the built cell - via \pgfPTbuildcell) |
| 34 |
Interaction with other packages (see pgfPT manual for more information): |
| 35 |
- babel-spanish |
| 36 |
- graphicx (\resizebox) & preview |
| 37 |
- extdash |
| 38 |
New translations: |
| 39 |
- Russian translation provided by Konstantin Nikiforov |
| 40 |
- Ukrainian translation provided by Nikita Khveshchuk |
| 41 |
- Slovenian translation provided by Domen Vaupotic |
| 42 |
New loading option: |
| 43 |
- hyperref |
| 44 |
New keys: |
| 45 |
- legend xshift |
| 46 |
- legend yshift |
| 47 |
- legend acronyms at right |
| 48 |
- radio symbol |
| 49 |
- radio font |
| 50 |
- radio font color |
| 51 |
- Z links (available with the 'hyperref' loading option) |
| 52 |
- Z links color (available with the 'hyperref' loading option) |
| 53 |
- Z links outline width (available with the 'hyperref' loading option) |
| 54 |
Updated keys: |
| 55 |
- group numbers, now supports a list of user labels to display group numbers |
| 56 |
- ls, now supports a starred version of the available flags - fig*, txt*, fig+txt* and txt+fig* - which omits the structure figure in the extra legend that describes the structures' abbreviations |
| 57 |
New libraries: |
| 58 |
'fittowidth': fits the Periodic Table to the text's width |
| 59 |
- \pgfPTfittowidth[font size] |
| 60 |
- \pgfPTendfittowidth |
| 61 |
'override': user can override the default acronyms or the element names: |
| 62 |
- \pgfPToverrideacros[language flag]{override list} |
| 63 |
- \pgfPTrestoreacros[language flag]{override list} |
| 64 |
- \pgfPToverridenames[language flag]{override list} |
| 65 |
- \pgfPTrestorenames[language flag]{override list} |
| 66 |
Fixed some typos in manual. |
| 67 |
|
| 68 |
*** v2.1.5 (10/02/2025) *** |
| 69 |
New options for loading the package, fixing the interaction of pgf-PeriodicTable with the beamer class and pdfLaTeX (small caps): |
| 70 |
- beamer (requires the lmodern package) |
| 71 |
- beamer* |
| 72 |
- beamer** (requires the silence package) |
| 73 |
New translation: |
| 74 |
- Chinese translation provided by Fan Hongtao |
| 75 |
New commands for Chinese language: |
| 76 |
- \pgfPTzhFontFeatures |
| 77 |
- \pgfPTzhtextfontSS |
| 78 |
- \pgfPTzhtextfontSSB |
| 79 |
- \pgfPTzhtextfontLv |
| 80 |
Changes to the default values of the following keys when the Chinese langauge is loaded: |
| 81 |
- name font |
| 82 |
- CS font |
| 83 |
- title font |
| 84 |
- Z font |
| 85 |
- Z padding |
| 86 |
Changes in Mandarin numerals: |
| 87 |
- default font is now BabelStone Han |
| 88 |
- the \pgfPTzhfont command has been renamed to \pgfPTzhnumberfont (\pgfPTzhfont is still defined for backwards compatibility) |
| 89 |
New keys: |
| 90 |
- decimal separator (sets the decimal separator in the numerical values of quantities) |
| 91 |
- legend acronyms font size (sets the font size of the text used in the legend acronyms description) |
| 92 |
New color schemes: |
| 93 |
- pgfPTWikipediaI |
| 94 |
- pgfPTWikipediaII |
| 95 |
New styles: |
| 96 |
- comma separator |
| 97 |
- dot separator |
| 98 |
- csWikipediaI |
| 99 |
- csWikipediaII |
| 100 |
The Z list key supports a new syntax which makes possible to get empty cells anywhere in the Periodic Table. |
| 101 |
Fixed an incorrect translation for 'fermium' in German. |
| 102 |
New section in package documentation 'Tips & Tricks: inspired by user questions'. |
| 103 |
|
| 104 |
*** v2.1.4 (08/09/2024) *** |
| 105 |
Fixed wrong box width on extra legend of Country of Discovery. |
| 106 |
Fixed minor issues in pgfPTbuildcell macros. |
| 107 |
Added the prefix 'pgfPT' to the built-in back color schemes. They are now 'pgfPTdefault', 'pgfPTSoft', 'pgfPTJmol', |
| 108 |
'pgfPTCPK', 'pgfPTRasmol', 'pgfPTRasmolNew', 'pgfPTWikipedia', 'pgfPTMNM', 'pgfPTPS', 'pgfPTRadio' and 'pgfPTBlocks'. |
| 109 |
Fixed some typos in the manual. |
| 110 |
|
| 111 |
*** v2.1.3 (07/08/2024) *** |
| 112 |
The engine's detection mechanism (pdfLaTeX, LuaLaTeX or XeTeX) has been changed to prevent erroneous detection when the packages 'hyperref' or 'bookmark' are loaded and the document is compiled with LuaLaTeX - in this case, pgf-PeriodicTable disturbs the selection of the document font. |
| 113 |
Fixed an issue with the Chemical Symbol color when a non-rgb color is used, such as cyan or yellow , which are defined in the xcolor package using the cmyk model (when loaded without options). |
| 114 |
|
| 115 |
*** v2.1.2 (01/08/2024) *** |
| 116 |
Fixed incorrect Spanish translations of some element names. |
| 117 |
Minor code improvements to eliminate runtime warnings («LaTeX Font Warning: Font shape `TU/TeXGyreHeros(0)/l/n' undefined« or «Missing character: There is no m (U+006D) in font nullfont!» ... ) |
| 118 |
|
| 119 |
*** v2.1.1 (07/07/2024) *** |
| 120 |
New keys: |
| 121 |
- group numbers (to display group numbers in arabic numerals, Roman numerals or both) |
| 122 |
- Roman label color (sets the color of the Roman numerals) |
| 123 |
- O Roman (the oxidation numbers are presented in Roman numerals) |
| 124 |
|
| 125 |
*** v2.1.0a (03/04/2024) *** |
| 126 |
Translation files have been renamed from 'lang.{undefined,nl}.tex' to 'pgfPT.lang.{undefined,nl}.tex' to match the runtime tree of TeX Live (names must be globally unique for reliable searching). |
| 127 |
|
| 128 |
*** v2.1.0 (14/02/2024) *** |
| 129 |
New options for package loading: |
| 130 |
- numerals (supporting Devanagari or Mandarin numerals); |
| 131 |
- userlang (supporting a user defined language, currently only Dutch translation, provided by Wim De Borggraeve). |
| 132 |
New commands: |
| 133 |
- \pgfPTdvnfont (provides font selection for use with Devanagari); |
| 134 |
- \pgfPTzhfont (provides font selection for use with Mandarin numerals); |
| 135 |
- \pgfPTzhnumber (to enable/disable showing the atomic number, period or group number in Mandarin numerals). |
| 136 |
Fixed wrong interaction with fontspec and babel packages: font selection schemes and \babelfont usage now work as expected. |
| 137 |
Fixed incorrect capitalization of some elements in German. |
| 138 |
Correction of the title in Spanish. |
| 139 |
|
| 140 |
*** v2.0.1 (29/05/2023) *** |
| 141 |
Capitalized element names (in German) and improved German language after suggestions made by Ole Schwen |
| 142 |
|
| 143 |
*** v2.0.0 (20/02/2023) *** |
| 144 |
New command \usepgfPTlibrary |
| 145 |
New library 'colorschemes' for easy creation of color schemes with the commands: |
| 146 |
- \pgfPTGroupColors |
| 147 |
- \pgfPTPeriodColors |
| 148 |
- \pgfPTCScombine |
| 149 |
- \pgfPTCSwrite |
| 150 |
|
| 151 |
*** v1.0.1 (08/11/2022) *** |
| 152 |
Now compatible with pdfLaTex, LuaLaTeX and XeLaTeX engines. |
| 153 |
Fixed the 'String contains an invalid utf-8 sequence...' error. |
| 154 |
Added \pgfPTsetLanguage{<language flag>} command to the documentation (forgotten in v1.0.0 manual). |
| 155 |
Updated the behavior of the 'capitalize element names' key. |
| 156 |
New keys: |
| 157 |
- name align |
| 158 |
- d unit |
| 159 |
- ls unit |
| 160 |
New pseudo styles: |
| 161 |
- d |
| 162 |
- lat |
| 163 |
|
| 164 |
*** v1.0.1 (10/10/2022) *** |
| 165 |
Initial release |