Debian Codegraph @

texmf-dist/doc/latex/pgf-periodictable/README

raw
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