mirror of
https://github.com/snachodog/just-the-docs.git
synced 2025-04-17 00:22:24 -06:00
eabe7b2585
This commit makes the dark mode preview feel a little more interactive and it also pulls some duplicated code into one file so that people like me aren't stumped when they are looking at the wrong page!
60 lines
1.1 KiB
Markdown
60 lines
1.1 KiB
Markdown
---
|
|
layout: default
|
|
title: Configuration
|
|
nav_order: 2
|
|
---
|
|
|
|
# Configuration
|
|
{: .no_toc }
|
|
|
|
|
|
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.
|
|
|
|
## Search enabled
|
|
|
|
```yaml
|
|
# Enable or disable the site search
|
|
search_enabled: true
|
|
```
|
|
|
|
## Aux links
|
|
|
|
```yaml
|
|
# Aux links for the upper right navigation
|
|
aux_links:
|
|
"Just the Docs on GitHub":
|
|
- "//github.com/pmarsceill/just-the-docs"
|
|
```
|
|
|
|
## Color scheme
|
|
|
|
```yaml
|
|
# 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 type="text/javascript" src="{{ "/assets/js/dark-mode-preview.js" | absolute_url }}"></script>
|
|
|
|
See [Customization]({{ site.baseurl }}{% link docs/customization.md %}) for more information.
|
|
|
|
## Google Analytics
|
|
|
|
```yaml
|
|
# Google Analytics Tracking (optional)
|
|
# e.g, UA-1234567-89
|
|
ga_tracking: UA-5555555-55
|
|
```
|