1
0
mirror of https://github.com/thangisme/notes.git synced 2024-12-22 23:36:32 -05:00
notes/docs/configuration.md

92 lines
2.1 KiB
Markdown
Raw Normal View History

2018-11-16 11:47:46 -05:00
---
layout: default
title: Configuration
nav_order: 2
---
# Configuration
2019-02-02 15:32:33 -05:00
{: .no_toc }
2018-11-16 11:47:46 -05:00
2019-02-02 15:32:33 -05:00
Just the Docs has some specific configuration parameters that can be defined in your Jekyll site's _config.yml file.
{: .fs-6 .fw-300 }
## Table of contents
{: .no_toc .text-delta }
1. TOC
{:toc}
---
View this site's [_config.yml](https://github.com/pmarsceill/just-the-docs/tree/master/_config.yml) file as an example.
2018-11-16 11:47:46 -05:00
## Search enabled
2019-01-15 20:43:19 -05:00
```yaml
2018-11-16 11:47:46 -05:00
# Enable or disable the site search
2019-08-14 10:40:19 -04:00
# Support true (default) or false
2018-11-16 11:47:46 -05:00
search_enabled: true
```
## Aux links
2019-01-15 20:43:19 -05:00
```yaml
2018-11-16 11:47:46 -05:00
# Aux links for the upper right navigation
aux_links:
"Just the Docs on GitHub":
2018-11-26 11:26:44 -05:00
- "//github.com/pmarsceill/just-the-docs"
2018-11-16 11:47:46 -05:00
```
2018-11-18 11:07:45 -05:00
2019-08-14 10:40:19 -04:00
## Heading anchor links
2019-08-13 17:24:23 -04:00
```yaml
2019-08-14 10:40:19 -04:00
# Heading anchor links appear on hover over h1-h6 tags
# in page content allowing users to deep link to a particular
# heading on a page.
2019-08-13 17:24:23 -04:00
#
# Supprts true (default) or false/nil
heading_anchors: true
```
2019-08-14 10:50:49 -04:00
## Footer content
```yaml
# Footer content appears at the bottom of every page's main content
footer_content: "Copyright &copy; 2017-2019 Patrick Marsceill. Distributed by an <a href=\"https://github.com/pmarsceill/just-the-docs/tree/master/LICENSE.txt\">MIT license.</a>"
```
2018-11-18 11:07:45 -05:00
## Color scheme
2019-01-15 20:43:19 -05:00
```yaml
2018-11-18 11:07:45 -05:00
# Color scheme currently only supports "dark" or nil (default)
color_scheme: "dark"
```
<button class="btn js-toggle-dark-mode">Preview dark color scheme</button>
<script>
2019-05-04 16:20:36 -04:00
const toggleDarkMode = document.querySelector('.js-toggle-dark-mode');
const cssFile = document.querySelector('[rel="stylesheet"]');
const originalCssRef = cssFile.getAttribute('href');
const darkModeCssRef = originalCssRef.replace('just-the-docs.css', 'dark-mode-preview.css');
2018-11-18 11:07:45 -05:00
2019-08-14 10:08:01 -04:00
jtd.addEvent(toggleDarkMode, 'click', function(){
2019-01-14 14:18:09 -05:00
if (cssFile.getAttribute('href') === originalCssRef) {
2019-05-04 16:20:36 -04:00
cssFile.setAttribute('href', darkModeCssRef);
2019-01-14 14:18:09 -05:00
} else {
2019-05-04 16:20:36 -04:00
cssFile.setAttribute('href', originalCssRef);
2019-01-14 14:18:09 -05:00
}
2018-11-18 11:07:45 -05:00
})
</script>
2019-01-14 14:18:09 -05:00
See [Customization]({{ site.baseurl }}{% link docs/customization.md %}) for more information.
2019-02-02 15:32:33 -05:00
## Google Analytics
```yaml
# Google Analytics Tracking (optional)
# e.g, UA-1234567-89
ga_tracking: UA-5555555-55
```