aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorThomas Chamberlin <tchamberlin@users.noreply.github.com>2018-05-26 23:19:07 -0400
committerGitHub <noreply@github.com>2018-05-26 23:19:07 -0400
commit7da0be48840a80891b85aacf03d67b42852fc343 (patch)
treeb217d5c94b48cce1cfbd898e4bc0d3f5181727c9
parent8b244609f5f6fcce30c5324cfa8b1e5c4df0e199 (diff)
downloadpelican-themes-7da0be48840a80891b85aacf03d67b42852fc343.tar.gz
Updated README's Github section
There are no descriptions of how the various options work, and they don't work in entirely intuitive ways. I've gone through the relevant code and derived what I think are accurate descriptions of what each does. `GITHUB_SKIP_FORK` especially is confusing, because passing it a boolean will break it.
-rw-r--r--pelican-bootstrap3/README.md6
1 files changed, 3 insertions, 3 deletions
diff --git a/pelican-bootstrap3/README.md b/pelican-bootstrap3/README.md
index 27b9d7a..d3eeec0 100644
--- a/pelican-bootstrap3/README.md
+++ b/pelican-bootstrap3/README.md
@@ -316,9 +316,9 @@ For example, if you want to use the WTFPL license, you can set:
The theme can show your most recently active GitHub repos in the sidebar. To enable, provide a `GITHUB_USER`. Appearance and behaviour can be controlled using the following variables:
-* `GITHUB_REPO_COUNT`
-* `GITHUB_SKIP_FORK`
-* `GITHUB_SHOW_USER_LINK`
+* `GITHUB_REPO_COUNT`: An integer representing the number of repos to display (sorted by modification date, descending)
+* `GITHUB_SKIP_FORK`: Either 'false' [default] or 'true'. If 'true', exclude forked repositories from display in the sidebar. NOTE: This cannot be set to `True` or `False`, it must be a string representation of JS's `true`/`false`.
+* `GITHUB_SHOW_USER_LINK`: If undefined [default], don't show a link to the `GITHUB_USER`'s user page. If defined, show it.
### Facebook Open Graph