=== Twenty8teen ===
Contributors: joyously
Tags: blog, custom-background, custom-colors, custom-header, custom-logo, custom-menu, editor-style, featured-images, footer-widgets, microformats, rtl-language-support, theme-options, threaded-comments, translation-ready, two-columns
Tested up to: 5.3
Stable tag: 20191111
License: GNU General Public License v2 or later
License URI: LICENSE
A lightweight, block-oriented theme.
== Description ==
* Block oriented by using widgets
* easily add user styles to checkbox grid
* save and load subsets of theme options (presets)
* apply a different preset to each page
* works with any font or screen size
* option for balanced display of posts regardless of number
* any Google fonts, with suggested fonts
* CSS variables for easy user changes and dynamic CSS
* script to add CSS vendor prefixes so CSS is smaller, and works on user CSS
* template function to generate unique gradients for text
* Child theme friendly (load style sheet, lots of filters, template files are widgets too, child demo)
* Microformats done right
The theme defines classes for you to use in content or just for
styling. These classes, along with user-defined classes, are
available on the Formats selector in the Classic Editor and Classic
Block.
All of the Area Styles can be used in content or changed, and it is
simple to add your own style to the checkbox grid by entering the
class name in the Theme Advanced section of the Customizer.
Each page/post has a body class of name-{slug}, so you can style for
instance
.name-hello-world { font-size: 110% }
These body classes, as well as the WordPress standard classes, can be
used to identify when to apply presets per page.
The body font has a class of body-font, and the titles have titles-
font.
Each image size has a class for the default featured images to size
called wrapped-media-size-{size} (e.g. wrapped-media-size-
thumbnail).
There are many CSS Custom Properties, which can be set in a
hierarchy, but be careful, as this won't work correctly in old
browsers.
The mouse position is tracked as `--mouse-x` and `--mouse-y`,
so that can be used for interactive effects. The theme defines many
of the Area Styles as Custom Properties so that they can easily be
modified and mixed (like in multiple backgrounds), due to the
checkboxes being independent of each other.
The theme widgets allow the choice of the Area Styles and a few
others, and the user-defined classes are also in the list.
The taxonomy root page template uses the page slug for the
taxonomy slug to list the terms (with counts) below the content of
the page.
The presets are saved only when the Create Preset button is used.
Nothing happens with the presets when the Customizer Publish
button is used.
== Frequently Asked Questions ==
**Why aren't the widgets stored in the presets?**
Widgets are handled by WordPress, not the theme. The data is stored
separately from the theme options in the database.
**How do I show different widgets on different pages if they aren't in the presets?**
The best way is to use a plugin such as Dynamic Widgets, so the
settings are not lost on theme switch.
**How do I change how something is output?**
Make a child theme! All you need is a style.css file that shows the
parent as twenty8teen, and then put your copy of the template file in
the child theme template-parts folder or the loop-parts folder. (See
the included child-demo, which does a little more.)
**How do I move the theme options from parent to child or to my other site?**
You can move theme options using the Customizer Import/Export plugin.
But be wary of presets, since they are part of the theme options of
both the source and destination. Version 20190510 adds code to
merge the preset options when an import calls the
`customize_save_{name}` action for the preset option (instead of it
overwriting).
**Does this theme work on ClassicPress?**
Yes
== Changelog ==
= 20191111 =
* tweak style for button block and screen-reader-text, add group block style
* define starter content only in customizer_preview
* move Requires PHP and Requires at least to style.css
* style code tag for RTL (always LTR)
* change target of Jump to top to #, add screen-reader-text
* set the child demo search default to no images
* adjust print style for pre and table
= 20190922 =
* add horizontal-rule and separator template parts
* add theme support for html5 script and style tags
* add tabindex=-1 for menu arrows and toggle
* tweak style for skip link, calendar block, table-view, submenus
* remove profile for gmpg.org
See changelog.txt for history
== Credits ==
Twenty8teen WordPress Theme, Copyright 2018 Joy Reynolds
Twenty8teen is distributed under the terms of the GNU GPLv2 or later.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see
https://www.gnu.org/licenses/gpl-2.0.txt.
Twenty8teen WordPress Theme is derived from Underscores
WordPress Theme, http://underscores.me/, Copyright 2012-2017
Automattic, Inc. Underscores WordPress Theme is distributed under
the terms of the GPLv2 or later (https://www.gnu.org/licenses/gpl-2.0.html)
Twenty8teen WordPress Theme incorporates code from
Justin Tadlock, described at http://justintadlock.com/archives/2015/05/26/multiple-checkbox-customizer-control
Twenty8teen WordPress Theme bundles the following third-party
resources:
normalize.css, (C) 2012-2016 Nicolas Gallagher and Jonathan Neal
MIT license (http://opensource.org/licenses/MIT)
Source: http://necolas.github.io/normalize.css/
prefixfree javascript library,
MIT license (http://opensource.org/licenses/MIT)
Source: http://leaverou.github.io/prefixfree/
conic-gradient javascript library,
MIT license (http://opensource.org/licenses/MIT)
Source: http://leaverou.github.io/conic-gradient/
auticons icon font, Copyright 2013, Heydon Pickering
WTFPL license - http://sam.zoy.org/wtfpl/
Source: http://www.heydonworks.com
Twenty8teen WordPress Theme uses these two fonts from
Google Fonts by default: Amarante font, Copyright (c) 2012 by
Sorkin Type Co (www.sorkintype.com),
with Reserved Font Name "Amarante".
SIL Open Font License, Version 1.1 - http://scripts.sil.org/OFL
Convergence font,
Copyright (c) 2010, 2011 José Nicolás Silva Schwarzenberg ,
Copyright (c) 2010, 2011 John Vargas Beltrán
(john.vargasbeltran@gmail.com),
with Reserved Font Names "Convergence".
SIL Open Font License, Version 1.1 - http://scripts.sil.org/OFL