Version 2.1.0-beta.1

``` * [Changed] Add basic `pico-theme.yml` to use API v3, enable Twig's autoescape feature (no changes necessary) and register `Social` meta header * [Changed] Use Pico's `pages` Twig function to create the main navigation * [Changed] Improve formatting of definition lists and inline code snippets * [Changed] Improve JSDoc class docs ```
Update CHANGELOG.md
2025-08-22 16:23:01 +02:00 · 2019-11-04 00:43:37 +01:00 · 2019-11-04 00:42:52 +01:00 · 2019-11-04 00:13:47 +01:00 · 2019-11-03 20:57:11 +01:00 · 2019-10-26 14:03:38 +02:00
16 changed files with 96 additions and 38 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,52 @@ Pico Default Theme Changelog
          refer to both the UPGRADE and NEWS sections of the docs for more
          details.
 ### Version 2.1.0-beta.1
 Released: 2019-11-03
 ```
 * [Changed] Add basic `pico-theme.yml` to use API v3, enable Twig's autoescape
            feature (no changes necessary) and register `Social` meta header
 * [Changed] Use Pico's `pages` Twig function to create the main navigation
 * [Changed] Improve formatting of definition lists and inline code snippets
 * [Changed] Improve JSDoc class docs
 ```
 ### Version 2.0.5-beta.1
 Released: 2019-01-03
 ```
 * [New] Add `2.0.x-dev` alias for master branch to `composer.json`
 ```
 ### Version 2.0.4
 Released: 2018-12-17
 No changes
 ### Version 2.0.3
 Released: 2018-12-03
 No changes
 ### Version 2.0.2
 Released: 2018-08-12
 No changes
 ### Version 2.0.1
 Released: 2018-07-29
 No changes
 ### Version 2.0.0
 Released: 2018-07-01
 ```
 * [New] Add Bountysource
 * [Changed] Improve documentation
 ```
 ### Version 2.0.0-beta.3
 Released: 2018-04-07
--- a/README.md
+++ b/README.md
@@ -36,7 +36,7 @@ theme: my_theme
 You can now edit the theme's stylesheets and JavaScript to fit your needs. If you rather want to use a third-party theme, simply add the theme's directory to your `themes/` directory (e.g. `themes/some_other_theme/`) and update your `config/config.yml` accordingly. Pico's default theme is now completely disabled and won't ever interfere with your custom theme or your website in general anymore. If you want to use Pico's default theme again, either remove the line or replace it by `theme: default`.
-Anyway, since Pico's default theme is meant to be a starting point for your own theme, it demonstrates how themes can allow one to tweak a theme's behavior. For this reason it supports a "Widescreen" mode: By adding `theme_config.widescreen: true` to your `config/config.yml`, the theme's main container grows from 768px to 1152px breadth due to adding `class="widescreen"` to the website's `<body>` element. Pico's default theme furthermore supports adding social buttons to its footer. Rather than using Pico's config for this, it uses the YAML Frontmatter of the `content/_meta.yml` Markdown file. Here's `content/_meta.yml` from Pico's sample contents:
+Anyway, since Pico's default theme is meant to be a starting point for your own theme, it demonstrates how themes can allow one to tweak a theme's behavior. For this reason it supports a "Widescreen" mode: By adding `theme_config.widescreen: true` to your `config/config.yml`, the theme's main container grows from 768px to 1152px breadth due to adding `class="widescreen"` to the website's `<body>` element. Pico's default theme furthermore supports adding social buttons to its footer. Rather than using Pico's config for this, it uses the YAML Frontmatter of the `content/_meta.md` Markdown file. Here's `content/_meta.md` from Pico's sample contents:
 ```yaml
 ---
--- a/composer.json
+++ b/composer.json
@@ -26,7 +26,8 @@
    "extra": {
        "installer-name": "default",
        "branch-alias": {
-            "dev-master": "2.0-dev"
+            "dev-master": "2.0.x-dev",
            "dev-pico-2.1": "2.1.x-dev"
        }
    }
 }
--- a/css/fontello.css
+++ b/css/fontello.css
@@ -1,11 +1,11 @@
@font-face {
    font-family: 'fontello';
-    src: url('../icon/fontello.eot?13793670');
+    src: url('../icon/fontello.eot?29729916');
-    src: url('../icon/fontello.eot?13793670#iefix') format('embedded-opentype'),
+    src: url('../icon/fontello.eot?29729916#iefix') format('embedded-opentype'),
-         url('../icon/fontello.woff2?13793670') format('woff2'),
+         url('../icon/fontello.woff2?29729916') format('woff2'),
-         url('../icon/fontello.woff?13793670') format('woff'),
+         url('../icon/fontello.woff?29729916') format('woff'),
-         url('../icon/fontello.ttf?13793670') format('truetype'),
+         url('../icon/fontello.ttf?29729916') format('truetype'),
-         url('../icon/fontello.svg?13793670#fontello') format('svg');
+         url('../icon/fontello.svg?29729916#fontello') format('svg');
    font-weight: normal;
    font-style: normal;
 }
@@ -58,3 +58,4 @@
 .icon-chat:before { content: '\e800'; } /* '' */
 .icon-octocat:before { content: '\f09b'; } /* '' */
 .icon-menu:before { content: '\f0c9'; } /* '' */
 .icon-dollar:before { content: '\f155'; } /* '' */
--- a/css/style.css
+++ b/css/style.css
@@ -11,7 +11,7 @@
 * @author  Daniel Rudolf
 * @link    http://picocms.org
 * @license http://opensource.org/licenses/MIT The MIT License
- * @version 2.0
+ * @version 2.1
 */
 * {
@@ -185,7 +185,7 @@ p, td, th, li, dd {
    word-wrap: break-word;
 }
-p, hr, table, .table-responsive, ol, ul, dl, pre, blockquote, fieldset {
+p, hr, table, .table-responsive, ol, ul, dl, dd, pre, blockquote, fieldset {
    margin-bottom: 1em;
 }
@@ -234,7 +234,7 @@ th {
    color: #333;
 }
-td, th {                                         border: solid 1px #ccc; }
+td, th {                                         border: 1px solid #ccc; }
 tr:not(:last-child) td, tr:not(:last-child) th { border-bottom: 0 none; }
 thead tr:last-child th {                         border-bottom: 0 none; }
 td:not(:last-child), th:not(:last-child) {       border-right: 0 none; }
@@ -269,7 +269,8 @@ code {
    border-radius: 0.3em;
    background: #f5f5f5;
    font-family: 'Droid Sans Mono', 'Courier New', 'Courier', monospace;
-    font-size: 0.9rem;
+    font-size: 0.85rem;
    line-height: 1.9824;
 }
 pre {
@@ -277,7 +278,6 @@ pre {
    border: 1px solid #ccc;
    border-radius: 0.3em;
    background: #f5f5f5;
    line-height: 1.4;
 }
 pre code {
    display: block;
@@ -286,6 +286,7 @@ pre code {
    border: 0 none;
    background: transparent;
    overflow-x: auto;
    line-height: 1.4;
 }
 /*** BLOCKQUOTE ***/
@@ -302,7 +303,7 @@ blockquote {
 label, fieldset legend { font-weight: bold; }
 input:not([type="checkbox"]):not([type="radio"]), button, select, textarea, fieldset, fieldset legend {
-    border: solid 1px #ccc;
+    border: 1px solid #ccc;
    border-radius: 0.3em;
    background: #fff;
    -webkit-transition: none .2s ease-in;
--- a/icon/COPYRIGHT.txt
+++ b/icon/COPYRIGHT.txt
@@ -14,10 +14,10 @@ Font license info
 ## Font Awesome
-    Copyright (C) 2012 by Dave Gandy
+    Copyright (C) 2016 by Dave Gandy
    Author:     Dave Gandy
    License:    SIL OFL 1.1 <http://scripts.sil.org/OFL>
    Homepage:   http://fortawesome.github.com/Font-Awesome/
-    Icons:      menu, github-circled ("octocat"), chat
+    Icons:      chat, github-circled ("octocat"), menu, dollar
--- a/icon/LICENSE.OFL-1.1.txt
+++ b/icon/LICENSE.OFL-1.1.txt
@@ -1,4 +1,4 @@
-Copyright (c) 2012, Dave Gandy <http://fontawesome.io>,
+Copyright (c) 2016, Dave Gandy <http://fontawesome.io>,
 with Reserved Font Name Font Awesome.
 This Font Software is licensed under the SIL Open Font License, Version 1.1.
--- a/icon/fontello.eot
+++ b/icon/fontello.eot
--- a/icon/fontello.svg
+++ b/icon/fontello.svg
@@ -1,7 +1,7 @@
 <?xml version="1.0" standalone="no"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
 <svg xmlns="http://www.w3.org/2000/svg">
-<metadata>Copyright (C) 2017 by original authors @ fontello.com</metadata>
+<metadata>Copyright (C) 2018 by original authors @ fontello.com</metadata>
 <defs>
 <font id="fontello" horiz-adv-x="1000" >
 <font-face font-family="fontello" font-weight="400" font-stretch="normal" units-per-em="1000" ascent="850" descent="-150" />
@@ -11,6 +11,8 @@
 <glyph glyph-name="octocat" unicode="&#xf09b;" d="M429 779q116 0 215-58t156-156 57-215q0-140-82-252t-211-155q-15-3-22 4t-7 17q0 1 0 43t0 75q0 54-29 79 32 3 57 10t53 22 45 37 30 58 11 84q0 67-44 115 21 51-4 114-16 5-46-6t-51-25l-21-13q-52 15-107 15t-108-15q-8 6-23 15t-47 22-47 7q-25-63-5-114-44-48-44-115 0-47 12-83t29-59 45-37 52-22 57-10q-21-20-27-58-12-5-25-8t-32-3-36 12-31 35q-11 18-27 29t-28 14l-11 1q-12 0-16-2t-3-7 5-8 7-6l4-3q12-6 24-21t18-29l6-13q7-21 24-34t37-17 39-3 31 1l13 3q0-22 0-50t1-30q0-10-8-17t-22-4q-129 43-211 155t-82 252q0 117 58 215t155 156 216 58z m-267-616q2 4-3 7-6 1-8-1-1-4 4-7 5-3 7 1z m18-19q4 3-1 9-6 5-9 2-4-3 1-9 5-6 9-2z m16-25q6 4 0 11-4 7-9 3-5-3 0-10t9-4z m24-23q4 4-2 10-7 7-11 2-5-5 2-11 6-6 11-1z m32-14q1 6-8 9-8 2-10-4t7-9q8-3 11 4z m35-3q0 7-10 6-9 0-9-6 0-7 10-6 9 0 9 6z m32 5q-1 7-10 5-9-1-8-8t10-4 8 7z" horiz-adv-x="857.1" />
 <glyph glyph-name="menu" unicode="&#xf0c9;" d="M857 100v-71q0-15-10-25t-26-11h-785q-15 0-25 11t-11 25v71q0 15 11 25t25 11h785q15 0 26-11t10-25z m0 286v-72q0-14-10-25t-26-10h-785q-15 0-25 10t-11 25v72q0 14 11 25t25 10h785q15 0 26-10t10-25z m0 285v-71q0-14-10-25t-26-11h-785q-15 0-25 11t-11 25v71q0 15 11 26t25 10h785q15 0 26-10t10-26z" horiz-adv-x="857.1" />
 <glyph glyph-name="dollar" unicode="&#xf155;" d="M546 189q0-86-56-147t-144-77v-97q0-8-5-13t-13-5h-75q-7 0-13 5t-5 13v97q-37 5-71 18t-57 25-41 26-26 21-10 10q-9 12-1 23l58 76q3 5 12 6 9 1 14-5l1-1q63-55 135-70 21-4 42-4 45 0 79 24t35 68q0 16-9 30t-18 23-33 21-37 18-45 18q-21 9-34 14t-34 15-35 17-32 20-29 24-25 27-20 32-11 37-5 44q0 77 55 135t142 75v100q0 7 5 13t13 5h75q8 0 13-5t5-13v-98q32-3 62-13t48-19 36-20 21-17 9-7q9-11 3-22l-46-81q-4-9-12-9-8-2-15 4-2 2-9 7t-21 14-33 18-42 15-47 6q-53 0-87-24t-33-62q0-14 4-27t17-23 22-18 31-18 34-15 39-15q30-11 45-17t43-20 42-24 34-28 30-35 18-43 7-52z" horiz-adv-x="571.4" />
 </font>
 </defs>
 </svg>
--- a/icon/fontello.ttf
+++ b/icon/fontello.ttf
--- a/icon/fontello.woff
+++ b/icon/fontello.woff
--- a/icon/fontello.woff2
+++ b/icon/fontello.woff2
--- a/index.twig
+++ b/index.twig
@@ -32,13 +32,10 @@
            </h1>
            <div id="nav" role="region" tabindex="-1">
                <ul>
-                    {% for page in pages if page.title and not page.hidden %}
+                    {% for page in pages(depthOffset=-1) if page.title and not page.hidden %}
-                        {% set pageDepth = page.id|split('/')|length %}
+                        <li{% if page.id == current_page.id %} class="active"{% endif %}>
-                        {% if (pageDepth == 2) and (page.id ends with "/index") or (pageDepth == 1) %}
+                            <a href="{{ page.url }}">{{ page.title }}</a>
-                            <li{% if page.id == current_page.id %} class="active"{% endif %}>
+                        </li>
                                <a href="{{ page.url }}">{{ page.title }}</a>
                            </li>
                        {% endif %}
                    {% endfor %}
                </ul>
            </div>
--- a/js/pico.js
+++ b/js/pico.js
@@ -6,7 +6,7 @@
 * @author  Daniel Rudolf
 * @link    http://picocms.org
 * @license http://opensource.org/licenses/MIT The MIT License
- * @version 2.0
+ * @version 2.1
 */
 function main()
--- a/js/utils.js
+++ b/js/utils.js
@@ -6,7 +6,7 @@
 * @author  Daniel Rudolf
 * @link    http://picocms.org
 * @license http://opensource.org/licenses/MIT The MIT License
- * @version 2.0
+ * @version 2.1
 */
 utils = {};
@@ -14,7 +14,7 @@ utils = {};
 /**
 * Checks whether the client's browser is able to slide elements or not
 *
- * @return boolean TRUE when the browser supports sliding, FALSE otherwise
+ * @return {bool} TRUE when the browser supports sliding, FALSE otherwise
 */
 utils.canSlide = function ()
 {
@@ -24,11 +24,10 @@ utils.canSlide = function ()
 /**
 * Slides a element up (i.e. hide a element by changing its height to 0px)
 *
- * @param  HTMLElement element        the element to slide up
+ * @param {HTMLElement} element        the element to slide up
- * @param  function    finishCallback function to call when the animation has
+ * @param {function}    finishCallback function to call when the animation has
 *     been finished (i.e. the element is hidden)
- * @param  function    startCallback  function to call when the animation starts
+ * @param {function}    startCallback  function to call when the animation starts
 * @return void
 */
 utils.slideUp = function (element, finishCallback, startCallback)
 {
@@ -72,11 +71,10 @@ utils.slideUp = function (element, finishCallback, startCallback)
 /**
 * Slides a element down (i.e. show a hidden element)
 *
- * @param  HTMLElement element        the element to slide down
+ * @param {HTMLElement} element        the element to slide down
- * @param  function    finishCallback function to call when the animation has
+ * @param {function}    finishCallback function to call when the animation has
 *     been finished (i.e. the element is visible)
- * @param  function    startCallback  function to call when the animation starts
+ * @param {function}    startCallback  function to call when the animation starts
 * @return void
 */
 utils.slideDown = function (element, finishCallback, startCallback)
 {
@@ -126,8 +124,9 @@ utils.slideDown = function (element, finishCallback, startCallback)
 /**
 * Checks whether a element is visible or not
 *
- * @param  HTMLElement element the element to check
+ * @param {HTMLElement} element the element to check
- * @return boolean             TRUE when the element is visible, FALSE otherwise
+ *
 * @return {bool} TRUE when the element is visible, FALSE otherwise
 */
 utils.isElementVisible = function (element)
 {
--- a/pico-theme.yml
+++ b/pico-theme.yml
@@ -0,0 +1,11 @@
 api_version: 3
 meta:
    Social: social
 twig_config:
    autoescape: html
    strict_variables: false
    charset: utf-8
 widescreen: false               # Use more horicontal space (i.e. make the site container wider)
Author	SHA1	Message	Date
Daniel Rudolf	6c0491a918	Version 2.1.0-beta.1 ``` * [Changed] Add basic `pico-theme.yml` to use API v3, enable Twig's autoescape feature (no changes necessary) and register `Social` meta header * [Changed] Use Pico's `pages` Twig function to create the main navigation * [Changed] Improve formatting of definition lists and inline code snippets * [Changed] Improve JSDoc class docs ```	2019-11-04 00:43:37 +01:00
Daniel Rudolf	abae4acd5b	Update CHANGELOG.md	2019-11-04 00:42:52 +01:00
Daniel Rudolf	0a9321047d	Slightly decrease font size of inline code `line-height: 1.9824;` is the result of `calc(1em * 1.4 + 2 * 0.1em + 2 * 1px / 16px / 0.85 + 2 * 0.1em / 0.85)` (`1em * 1.4` equals the line height for code (= `1.4` times), plus `0.1em` vertical padding on top and bottom, plus `1px` border width on top and bottom (`1rem` equals `16px` and considering the smaller font size (= `0.85rem`)), plus `0.1em` vertical margin on top and bottom (also considering the smaller font size).	2019-11-04 00:13:47 +01:00
Daniel Rudolf	ac5e65b7a4	Update CHANGELOG.md	2019-11-03 20:57:11 +01:00
Daniel Rudolf	83a9b6ad59	Remove raw Twig filter when outputting Pico's content variable See `e0415c8c1d` for more details	2019-10-26 14:03:38 +02:00
Daniel Rudolf	8df986b02e	Update JSDoc class docs	2019-10-26 11:30:05 +02:00
Daniel Rudolf	fc941aab0c	Fix inline code line height `line-height: 1.9778;` is the result of `calc(1rem * 1.6 / 0.9 + 2 * 0.1em)` (`1rem * 1.6 / 0.9` equals the default line height (= `1.6` times) adjusted by the smaller font size (= `0.9rem`), plus `0.1em` vertical space on top and bottom)	2019-10-12 19:51:34 +02:00
Daniel Rudolf	777f852a06	Add bottom margin to definition descriptions	2019-10-12 19:46:38 +02:00
Daniel Rudolf	138a88e05f	Use Twig pages function for navigation See `681ad27158` for more info	2019-10-01 13:32:20 +02:00
Daniel Rudolf	470a734034	🎉 Add pico-theme.yml and update to API version 3 See `b27b4f388a` for more info	2019-10-01 13:31:34 +02:00
Daniel Rudolf	e66eab238e	phpDoc class docs: Remove superflous @return void	2019-09-11 11:29:15 +02:00
Daniel Rudolf	23a907d23b	composer.json: Add 2.1.x-dev alias for pico-2.1 branch	2019-07-14 15:37:20 +02:00
Daniel Rudolf	b33fe258b0	CSS: Fix border value order	2019-03-11 23:06:01 +01:00
Daniel Rudolf	db2e386a57	Version 2.0.5-beta.1 ``` * [New] Add `2.0.x-dev` alias for master branch to `composer.json` ```	2019-01-03 01:14:55 +01:00
Daniel Rudolf	316a531f64	Update CHANGELOG.md	2019-01-03 01:11:49 +01:00
Daniel Rudolf	7c1d14dda8	composer.json: Add 2.0.x-dev alias for master branch	2019-01-03 01:03:52 +01:00
Daniel Rudolf	c366649243	Version 2.0.4 No changes	2018-12-17 15:57:19 +01:00
Daniel Rudolf	02b112b072	Update CHANGELOG.md	2018-12-17 15:57:15 +01:00
Daniel Rudolf	6ad42dbbd2	Version 2.0.3 No changes	2018-12-03 12:46:48 +01:00
Daniel Rudolf	8f8cd50936	Update CHANGELOG.md	2018-12-03 12:46:42 +01:00
Daniel Rudolf	5af338c408	Version 2.0.2 No changes	2018-08-12 13:51:04 +02:00
Daniel Rudolf	f59f639f97	Update CHANGELOG.md	2018-08-12 13:50:57 +02:00
Daniel Rudolf	e1e4cc644f	Version 2.0.1 No changes	2018-07-29 12:58:56 +02:00
Daniel Rudolf	b1e423c691	Update CHANGELOG.md	2018-07-29 12:58:41 +02:00
Daniel Rudolf	ba0ac88e14	composer.json: Remove 2.0-dev branch alias	2018-07-03 16:13:14 +02:00
Daniel Rudolf	a75986d269	Version 2.0.0 ``` * [New] Add Bountysource * [Changed] Improve documentation ```	2018-07-01 17:35:52 +02:00
Daniel Rudolf	3799bc14ed	Update CHANGELOG.md	2018-07-01 17:26:26 +02:00
Daniel Rudolf	db2463c9b6	Add Bountysource icon (FontAwesome "dollar" icon) See `f994ef191c`	2018-07-01 14:47:14 +02:00
Daniel Rudolf	1526e6eb47	Merge pull request #1 from Tyxiang/patch-1 Repair description error	2018-04-28 15:30:21 +02:00
Tyxiang	182431ce45	Repair description error	2018-04-28 21:23:49 +08:00