2017-03-09 13:16:08 -05:00
|
|
|
# Welcome to Jekyll!
|
|
|
|
#
|
|
|
|
# This config file is meant for settings that affect your whole site, values
|
|
|
|
# which you are expected to set up once and rarely edit after that. If you find
|
|
|
|
# yourself editing these this file very often, consider using Jekyll's data files
|
|
|
|
# feature for the data you need to update frequently.
|
|
|
|
#
|
|
|
|
# For technical reasons, this file is *NOT* reloaded automatically when you use
|
|
|
|
# 'jekyll serve'. If you change this file, please restart the server process.
|
|
|
|
|
|
|
|
# Site settings
|
|
|
|
# These are used to personalize your new site. If you look in the HTML files,
|
|
|
|
# you will see them accessed via {{ site.title }}, {{ site.github_repo }}, and so on.
|
|
|
|
# You can create any custom variable you would like, and they will be accessible
|
|
|
|
# in the templates via {{ site.myvariable }}.
|
2017-03-26 21:09:19 -04:00
|
|
|
title: Just the Docs
|
2017-03-09 13:16:08 -05:00
|
|
|
description: A Jekyll theme for documentation
|
2019-08-14 14:31:50 -04:00
|
|
|
baseurl: "/just-the-docs" # the subpath of your site, e.g. /blog
|
2020-09-11 13:41:55 -04:00
|
|
|
url: "https://pmarsceill.github.io" # the base hostname & protocol for your site, e.g. http://example.com
|
2017-03-09 13:16:08 -05:00
|
|
|
|
2017-03-24 09:47:37 -04:00
|
|
|
permalink: pretty
|
2020-08-13 10:52:30 -04:00
|
|
|
exclude: ["node_modules/", "*.gemspec", "*.gem", "Gemfile", "Gemfile.lock", "package.json", "package-lock.json", "script/", "LICENSE.txt", "lib/", "bin/", "README.md", "Rakefile"
|
|
|
|
, "docs/tests/"
|
|
|
|
]
|
|
|
|
|
|
|
|
# Regression tests
|
|
|
|
# By default, the pages in /docs/tests are excluded when the ste is built.
|
|
|
|
# To include them, comment-out the relevant line above.
|
|
|
|
# Uncommenting the following line doesn't work - see https://github.com/jekyll/jekyll/issues/4791
|
|
|
|
# include: ["docs/tests/"]
|
2017-06-04 17:50:01 -04:00
|
|
|
|
2019-08-17 08:46:28 -04:00
|
|
|
# Set a path/url to a logo that will be displayed instead of the title
|
|
|
|
#logo: "/assets/images/just-the-docs.png"
|
|
|
|
|
2018-11-16 11:46:43 -05:00
|
|
|
# Enable or disable the site search
|
2020-03-24 19:23:17 -04:00
|
|
|
# Supports true (default) or false
|
2018-11-16 11:46:43 -05:00
|
|
|
search_enabled: true
|
2019-12-29 13:19:00 -05:00
|
|
|
search:
|
2020-03-24 19:23:17 -04:00
|
|
|
# Split pages into sections that can be searched individually
|
2019-12-29 15:30:44 -05:00
|
|
|
# Supports 1 - 6, default: 2
|
|
|
|
heading_level: 2
|
2020-03-24 19:23:17 -04:00
|
|
|
# Maximum amount of previews per search result
|
2020-01-02 05:55:38 -05:00
|
|
|
# Default: 3
|
2020-09-14 13:33:29 -04:00
|
|
|
previews: 2
|
2019-12-29 15:30:44 -05:00
|
|
|
# Maximum amount of words to display before a matched word in the preview
|
|
|
|
# Default: 5
|
2020-09-14 13:33:29 -04:00
|
|
|
preview_words_before: 3
|
2019-12-29 15:30:44 -05:00
|
|
|
# Maximum amount of words to display after a matched word in the preview
|
|
|
|
# Default: 10
|
2020-09-14 13:33:29 -04:00
|
|
|
preview_words_after: 3
|
2020-03-24 19:23:17 -04:00
|
|
|
# Set the search token separator
|
2019-12-29 15:30:44 -05:00
|
|
|
# Default: /[\s\-/]+/
|
2020-03-24 19:23:17 -04:00
|
|
|
# Example: enable support for hyphenated search words
|
2019-12-29 15:30:44 -05:00
|
|
|
tokenizer_separator: /[\s/]+/
|
2020-03-24 19:23:17 -04:00
|
|
|
# Display the relative url in search results
|
|
|
|
# Supports true (default) or false
|
2020-06-25 17:19:24 -04:00
|
|
|
rel_url: true
|
|
|
|
# Enable or disable the search button that appears in the bottom right corner of every page
|
2019-12-29 15:30:44 -05:00
|
|
|
# Supports true or false (default)
|
2020-06-25 17:19:24 -04:00
|
|
|
button: false
|
2019-08-29 09:36:13 -04:00
|
|
|
|
2019-08-13 17:23:35 -04:00
|
|
|
# Enable or disable heading anchors
|
|
|
|
heading_anchors: true
|
|
|
|
|
2017-11-08 11:23:05 -05:00
|
|
|
# Aux links for the upper right navigation
|
2017-06-04 17:50:01 -04:00
|
|
|
aux_links:
|
2018-10-23 11:39:30 -04:00
|
|
|
"Just the Docs on GitHub":
|
2017-06-04 17:50:01 -04:00
|
|
|
- "//github.com/pmarsceill/just-the-docs"
|
2018-11-15 15:12:12 -05:00
|
|
|
|
2019-10-02 01:22:34 -04:00
|
|
|
# Makes Aux links open in a new tab. Default is false
|
|
|
|
aux_links_new_tab: false
|
|
|
|
|
2020-04-25 08:53:45 -04:00
|
|
|
# Sort order for navigation links
|
Ensure pages with nav_exclude are ignored by navigation
Pages with `nav_exclude: true` were included when sorting on `title` or `nav_order`. That could cause build failures when the type of value of the field differs from that on other pages, as reported in https://github.com/pmarsceill/just-the-docs/issues/406.
Pages with `nav_exclude: true` or no `title` are never displayed in the navigation, so removing them from `pages_list` cannot break existing sites. This change also allows the removal of some tests in the code. (The indentation of the code should now be adjusted, but that has been deferred, to restrict the size of the diff for review.)
For testing, the title of `404.html` has been changed to the number `404`, the page `docs/untitled-test.md` has been added, and `nav_sort_order` has been set to `case_sensitive`. Those updates give build failures with the current version of `_includes/nav.html`, but not after the suggested changes.
It will still be possible for build failures to occur due to sorting fields of *non-excluded* pages with differing types of values (e.g., `nav_order`a mixture of numbers and strings). To make the code completely safe will require relatively complicated changes,.
2020-08-10 09:58:42 -04:00
|
|
|
# nav_sort: case_insensitive # default, equivalent to nil
|
|
|
|
nav_sort: case_sensitive # Capital letters sorted before lowercase
|
2019-08-06 15:56:29 -04:00
|
|
|
|
2020-04-24 15:39:44 -04:00
|
|
|
# Footer content
|
2020-04-23 22:38:45 -04:00
|
|
|
# appears at the bottom of every page's main content
|
2020-05-01 17:31:44 -04:00
|
|
|
|
|
|
|
# Back to top link
|
|
|
|
back_to_top: true
|
|
|
|
back_to_top_text: "Back to top"
|
|
|
|
|
2020-04-27 12:52:07 -04:00
|
|
|
footer_content: "Copyright © 2017-2020 Patrick Marsceill. Distributed by an <a href=\"https://github.com/pmarsceill/just-the-docs/tree/master/LICENSE.txt\">MIT license.</a>"
|
2019-08-06 15:56:29 -04:00
|
|
|
|
2020-04-23 22:38:45 -04:00
|
|
|
# Footer last edited timestamp
|
2020-04-23 22:43:27 -04:00
|
|
|
last_edit_timestamp: true # show or hide edit time - page must have `last_modified_date` defined in the frontmatter
|
2020-01-12 16:47:05 -05:00
|
|
|
last_edit_time_format: "%b %e %Y at %I:%M %p" # uses ruby's time format: https://ruby-doc.org/stdlib-2.7.0/libdoc/time/rdoc/Time.html
|
2020-04-23 22:38:45 -04:00
|
|
|
|
2020-05-01 17:31:44 -04:00
|
|
|
|
|
|
|
|
2020-04-23 22:38:45 -04:00
|
|
|
# Footer "Edit this page on GitHub" link text
|
|
|
|
gh_edit_link: true # show or hide edit this page link
|
2020-04-27 13:14:42 -04:00
|
|
|
gh_edit_link_text: "Edit this page on GitHub"
|
2020-01-12 16:47:05 -05:00
|
|
|
gh_edit_repository: "https://github.com/pmarsceill/just-the-docs" # the github URL for your repo
|
2020-04-23 22:32:46 -04:00
|
|
|
gh_edit_branch: "master" # the branch that your docs is served from
|
2020-08-25 21:08:31 -04:00
|
|
|
# gh_edit_source: docs # the source that your files originate from
|
2020-04-23 22:32:46 -04:00
|
|
|
gh_edit_view_mode: "tree" # "tree" or "edit" if you want the user to jump into the editor immediately
|
2019-08-06 15:56:29 -04:00
|
|
|
|
2020-04-24 15:39:44 -04:00
|
|
|
# Color scheme currently only supports "dark", "light"/nil (default), or a custom scheme that you define
|
2018-11-18 11:06:59 -05:00
|
|
|
color_scheme: nil
|
2019-02-02 15:32:04 -05:00
|
|
|
|
|
|
|
# Google Analytics Tracking (optional)
|
|
|
|
# e.g, UA-1234567-89
|
|
|
|
ga_tracking: UA-2709176-10
|
2020-04-27 12:51:48 -04:00
|
|
|
ga_tracking_anonymize_ip: true # Use GDPR compliant Google Analytics settings (true/nil by default)
|
2019-02-28 02:08:27 -05:00
|
|
|
|
|
|
|
plugins:
|
2019-05-04 15:59:33 -04:00
|
|
|
- jekyll-seo-tag
|
|
|
|
|
2020-07-07 13:34:35 -04:00
|
|
|
kramdown:
|
|
|
|
syntax_highlighter_opts:
|
|
|
|
block:
|
|
|
|
line_numbers: false
|
|
|
|
|
2019-05-04 15:59:33 -04:00
|
|
|
compress_html:
|
|
|
|
clippings: all
|
|
|
|
comments: all
|
|
|
|
endings: all
|
|
|
|
startings: []
|
2019-09-09 16:26:32 -04:00
|
|
|
blanklines: false
|
2019-08-13 17:24:23 -04:00
|
|
|
profile: false
|
2020-07-07 13:34:35 -04:00
|
|
|
# ignore:
|
|
|
|
# envs: all
|