Merge branch 'master' into develop, resolve conflicts in docs

docs/users/landingpages.rst

@@ -4,10 +4,11 @@ Series Landing Pages
 Custom landing pages allow you to summarize a :ref:`series of posts <series-tax>` or tie a project together. For one example, see http://inewsnetwork.org/series/hit-and-run: the project page begins with a summary of the series, followed by posts within the series.
 Creating a custom landing page is a simple process.
 
-1. Make sure "Custom Landing Pages for Series/Project Pages" is enabled in *Appearance* > *Theme 	Options* > *Advanced*.
-2. Create a series
-3. Add the series to posts
-4. Create the landing page
+1. Go to *Appearance* > *Theme Options* > *Advanced* and check the box to Enable "Series" Taxonomy
+2. Check the box that appears underneath to Enable Custom Landing Pages for Series/Project Pages
+3. Create a series
+4. Add the series to posts
+5. Create the landing page
 
 Creating a series
 -----------------

docs/users/menus.rst

@@ -6,9 +6,9 @@ Available Menu Areas
 
 The Largo theme has five customizable menu areas:
 
-**Global Navigation** - The links in the dark gray bar at the very top of the page. When viewed on a small screen such as a mobile device, this menu collapses and appears in a dropdown menu instead. The name of the menu area can be changed under Appearance > Menus to set the top level target for the dropdown menu on small screens. Note that you do not have to use this area at all if you do not wish to, but it can be a good place to put supplemental links such as links to your about or contact page or links to login or register (if relevant for your site)
+**Global Navigation** - The links in the dark gray bar at the very top of the page. When the Main Navigation is displayed as a sticky menu, the Global Navigation collapses and appears in a dropdown menu inside the Main Navigation. The name of the menu area can be changed under Appearance > Menus to set the top level target for the dropdown menu on the sticky Main Nav. Note that you do not have to use this area at all if you do not wish to, but it can be a good place to put supplemental links such as links to your about or contact page or links to login or register (if relevant for your site)
 
-**Main Navigation** - The main site navigation that appears in the menu bar/sticky nav in the header.
+**Main Navigation** - The main site navigation that appears in the menu bar nav. By default the main navigation is displayed just below the header when viewed on larger screen sizes. When viewed on a smaller screen size (768px or less in width) the main navigation becomes sticky at the top of the screen. The sticky nav disappears when the user scrolls down, and reappears when scrolling up. You can also choose in Appearance > Theme Options > Navigation to enable the sticky navigation for all screen sizes on article pages, and optionally to hide the header and display only the sticky nav on article pages.
 
 **Don't Miss** - An optional menu area that you must enable and configure under Appearance > Theme Options before it will appear on your site (it is hidden by default). This is a good place to link to category, tag or series pages that you want to highlight for your readers but not necessarily include in the main navbar.
 

docs/users/taxonomies.rst

@@ -34,6 +34,12 @@ Additionally you can add a description for each category, tag or series and also
 
 Note that in some cases you may need to click on the "Screen Options" tab at the very top right corner of the post edit screen to ensure that all of the taxonomies are visible.
 
+**Featured Media in Taxonomies**
+
+You can add a Featured Image for each term created in any of the taxonomies. This will appear as a banner image at the top of the term's archive page. While this is optional, an appropriate image can add visual appeal and impact to a topic landing page. At this time only images can be added as Featured Media in taxonomies.
+
+You can add a Featured Image for a term in Posts > Categories (or Tags, Post Prominence, Series, and Post Types) by editing the term, and using the Set Featured Media button to upload an image or select an existing image in the Media Library. For best results use a landscape-shaped image with a width of 1170px, so it spans the top of landing page for the term.  Adding, editing, and removing Featured Media images for a taxonomy term works the same way as for Featured Media in posts and pages.
+
 .. _categories-tax:
 
 Categories

docs/users/themeoptions.rst

@@ -16,12 +16,6 @@ Basic Settings
 
 **Donate Button** - The Largo theme includes an optional donate button in the top header. To enable the donate button, make sure the checkbox to show the donate button is checked and then add the link to your donation page, form or external payment processor here. Optionally, you can change the text of the button. The Largo theme also includes a sidebar widget that you can use to link to a donation page in addition to or instead of the link in the top header.
 
-**Don't Miss Menu** - Under the main navbar on your Largo site is an optional secondary navigation menu that, by default, is called "Don't Miss". To enable this menu make sure the checkbox to show the Don't Miss Menu is checked. Optionally, you can customize the label that appears at the beginning of the menu or remove it entirely. To add or remove links from this menu visit **Appearance > Menus** from the left sidebar in the WordPress administration interface.
-
-**Footer Nav Menu** - On the left side of the site footer is a configurable menu area. By default the label for this menu will be your site name, but you can change it here. As with the Don't Miss menu area, to add or remove links from this menu visit **Appearance > Menus** from the left sidebar in the WordPress administration interface.
-
-**Sticky Nav** - The sticky navigation bar remains at the top of the reader's window as they scroll. The default is to show the sticky navbar, but you may want to hide it. You also have the option to show your site name in the sticky navbar, which is useful on smaller screens.
-
 **Copyright Message** - By default this will display "Copyright [YEAR], Your Site Name" but you can enter your own message here if you would like. You can include HTML in this area to link to external sites and use © to display a copyright symbol or ``%d`` to display the current year.
 
 **Google Analytics** - The Largo theme has built in support for Google Analytics. Enter your Google Analytics ID here and the relevant Google Analytics code will be automatically added to all of the pages on your site. Note that it is configured to not track logged in users to ensure accurate reporting.
@@ -34,10 +28,11 @@ Be careful to note the recommended format for each link type for maximum compati
 
 Note that authors can add links to their own social media profiles by editing their user profile.
 
-**Single Post Social Icons** - By default a box showing social media links will be shown at the top of single article pages. You can choose to hide this if you prefer. You can also choose which share icons should be displayed here and the verb used on Facebook buttons.
+**Single Post Social Icons** - By default a box showing social media links will be shown at the top of single article pages. You can choose to hide this if you prefer. You can also choose which share icons should be displayed here, display share icons in a floating bar beside posts using the single-column template, and select the verb used on Facebook buttons.
 
 In previous versions of Largo, the option to have the author's bio and social media links occupied this slot, and also governed the visibility of share icons and the author bio at the end of the article. The article-bottom author bio and social links are now available as widgets.
 
+
 .. _theme-images:
 
 Theme Images
@@ -82,7 +77,7 @@ Layout Options
 **Homepage bottom templates** - Largo supports three options for the bottom of the homepage:
 
 - A single-column list of recent posts with photos and excerpts
-- A two-column widget area: This creates a new widget area in **Appearance > Widgets** that can be filled with widgets. It appears empty until widgets have been added to this area.
+- A two-column widget area: This creates a new widget area in **Appearance** > **Widgets** that can be filled with widgets. It appears empty until widgets have been added to this area.
 - Nothing whatsoever
 
 **Category and Tag Display** - Largo can display:
@@ -103,20 +98,52 @@ Layout Options
 
 **Sidebar Options** - These affect the presentation of the sidebar to the reader.
 
-- Add a third sidebar used only on archive pages (category, tag, author and series pages), configurable in Appearance > Widgets
-- An additional widget region just above the site footer region, configurable in Appearance > Widgets
+- Add a third sidebar used only on archive pages (category, tag, author and series pages), configurable in **Appearance** > **Widgets**
+- An additional widget region just above the site footer region, configurable in **Appearance** > **Widgets**
 - Fade the sidebar out on single story pages as the reader scrolls
 
 You can also enter a list of additional sidebar regions that should be created, one on each line of the text box.
 
-**Footer Layout** - The default footer is a 3 column footer with a wide center column. Alternatively you can choose to have 3 or 4 equal columns. Each column is a widget area that can be configured under the **Appearance > Widgets** menu, where they will be labeled "Footer 1" through "Footer 3" or "Footer 4."
+**Footer Layout** - The default footer is a 3 column footer with a wide center column. Alternatively you can choose to have 3 or 4 equal columns. Each column is a widget area that can be configured under the **Appearance** > **Widgets** menu, where they will be labeled "Footer 1" through "Footer 3" or "Footer 4."
+
+
+.. _navigation:
+
+Navigation
+----------------
+
+**Sticky navigation**
+
+Largo 0.5.4 introduces a new sticky navigation bar. This improves the user experience especially on mobile screen sizes by reducing the screen space occupied by navigation links, while still providing a highly usable menu. The sticky navigation disappears when the user scrolls down, and reappears when scrolling back up. 
+
+The sticky navigation bar has the theme location of Main Navigation. By default the Main Navigation menu is assigned to the Main Navigation theme location, and in most cases this would be the best practice. But in **Appearance** > **Menus** > **Manage Locations** you can reassign any menu to the Main Navigation theme location and place it in the sticky navigation bar. 
+
+By default, the sticky navigation bar is active only for mobile screen sizes. You can choose two additional options:
+
+- Enable the sticky navigation for all screen sizes on article pages
+- Hide the "non-sticky" main navigation on article pages and display only the sticky navigation
+
+Note that if you hide the non-sticky main navigation on article pages, any content above the navigation such as a banner ad will not be displayed. Users entering the site will see only the sticky nav bar at the top with a small site logo and the navigation links. 
+
+**Sticky navigation overflow**
+
+If the menu assigned to the sticky navigation has so many top-level links that it would have to wrap onto multiple lines, a dropdown menu will be added containing the links that would wrap. Enter a label here for the dropdown menu, which defaults to "More."
+
+**Also of note:** If you have assigned a menu to the Global Navigation theme location, the sticky navigation will include that as a dropdown menu to the right of the sticky nav menu links.
+
+**Menu Options**
+
+**Don't Miss Menu** - Under the main navbar on your Largo site is an optional secondary navigation menu that, by default, is called "Don't Miss". To enable this menu make sure the checkbox to show the Don't Miss Menu is checked. Optionally, you can customize the label that appears at the beginning of the menu or remove it entirely. To add or remove links from this menu visit **Appearance** > **Menus** from the left sidebar in the WordPress administration interface.
+
+**Footer Nav Menu** - On the left side of the site footer is a configurable menu area. By default the label for this menu will be your site name, but you can change it here. As with the Don't Miss menu area, to add or remove links from this menu visit **Appearance** > **Menus** from the left sidebar in the WordPress administration interface.
+
 
 .. _advanced-options:
 
 Advanced Options
 ----------------
 
-**Custom LESS** - Enabling this will let you change the theme's colors and fonts in **Appearance > CSS Variables**.
+**Custom LESS** - Enabling this will let you change the theme's colors and fonts in **Appearance** > **CSS Variables**.
 
 **Enable Series** - Some sites may create a multi-part series or project that is only published for a set amount of time and then should fall into the archive or appear on a “projects” archive page. To support this and also to allow for the creation of custom landing pages, Largo adds an optional “series” taxonomy. When you create a new series, you can add a term to this taxonomy and then make sure all of the posts in that series have this label applied. This will enable the Largo theme to surface related posts in that series in at the bottom of a post (if you are using the “read next” widget) and, in some cases, also on the homepage (depending on the homepage layout you have selected). Largo also adds the ability to create custom sidebars and landing pages for series archive pages, replacing the default series archive template in WordPress. For more information, see :ref:`series-tax`.