rearrange and better document config file

This commit is contained in:
Dean Attali 2020-04-24 00:39:44 +00:00
parent 3cb1e1601c
commit ed5bf8d8f1

View File

@ -1,4 +1,4 @@
# --- Basic general options --- # # --- Basic options --- #
# Name of website # Name of website
title: My website title: My website
@ -9,9 +9,19 @@ description: A virtual proof that I'm awesome
# Your name to show in the footer # Your name to show in the footer
author: Some Person author: Some Person
# --- List of links in the navigation bar --- #
navbar-links:
About Me: "aboutme"
Resources:
- Beautiful Jekyll: "http://deanattali.com/beautiful-jekyll/"
- Learn markdown: "http://www.markdowntutorial.com/"
Author's home: "http://deanattali.com"
# --- Local development options --- # --- Local development options ---
# If your website is hosted locally rather than on GitHub, then you need to uncomment the next two parameters to set the url and baseurl # If your website is hosted locally rather than on GitHub, then you need to uncomment the next two parameters to set the url and baseurl
# *** If you're not sure what this mean, then leave this section as it is. Only modify the url and baseurl if you know what you're doing!*** # ***If you're not sure what this mean, then leave this section as it is. Only modify the url and baseurl if you know what you're doing!***
# url is the the website domain URL without a trailing slash # url is the the website domain URL without a trailing slash
#url: "https://example.com" #url: "https://example.com"
@ -19,15 +29,7 @@ author: Some Person
# baseurl should be an empty string # baseurl should be an empty string
#baseurl: "" #baseurl: ""
# --- Navigation bar options --- # # --- Logo --- #
# List of links in the navigation bar
navbar-links:
About Me: "aboutme"
Resources:
- Beautiful Jekyll: "http://deanattali.com/beautiful-jekyll/"
- Learn markdown: "http://www.markdowntutorial.com/"
Author's home: "http://deanattali.com"
# Image to show in the navigation bar - works best with a square image # Image to show in the navigation bar - works best with a square image
# Remove this parameter if you don't want an image in the navbar # Remove this parameter if you don't want an image in the navbar
@ -38,7 +40,8 @@ round-avatar: true
# If you want to have an image logo in the top-left corner instead of the title text, # If you want to have an image logo in the top-left corner instead of the title text,
# then specify the following parameter # then specify the following parameter
# title-img: /path/to/image #title-img: /path/to/image
# --- Footer options --- # # --- Footer options --- #
@ -64,7 +67,7 @@ social-network-links:
# twitch: yourname # twitch: yourname
# yelp: yourname # yelp: yourname
# --- More general options --- # # --- General options --- #
# Select which social network share links to show in posts # Select which social network share links to show in posts
share-links-active: share-links-active:
@ -82,7 +85,7 @@ link-tags: true
# Excerpt Word Length - Truncates the excerpt to the specified number of words on the index page # Excerpt Word Length - Truncates the excerpt to the specified number of words on the index page
excerpt_length: 50 excerpt_length: 50
# --- Background colour/image options --- # # --- Colours / background image --- #
# Personalize the colors in your website. Colour values can be any valid CSS colour # Personalize the colors in your website. Colour values can be any valid CSS colour
@ -99,9 +102,9 @@ footer-link-col: "#404040"
# Alternatively, the navbar, footer, and page background can be set to use background images # Alternatively, the navbar, footer, and page background can be set to use background images
# instead of colour # instead of colour
# navbar-img: "/img/bgimage.png" #navbar-img: "/img/bgimage.png"
# footer-img: "/img/bgimage.png" #footer-img: "/img/bgimage.png"
# page-img: "/img/bgimage.png" #page-img: "/img/bgimage.png"
# --- Web Statistics Section --- # # --- Web Statistics Section --- #
@ -125,12 +128,12 @@ footer-link-col: "#404040"
# --- Comments --- # # --- Comments --- #
# Fill in your Disqus shortname (NOT the userid) if you want to support Disqus comments # Fill in your Disqus shortname (NOT the userid) if you want to support Disqus comments
# disqus: "" #disqus: ""
# To use Facebook Comments, fill in a Facebook App ID # To use Facebook Comments, fill in a Facebook App ID
# fb_comment_id: "" #fb_comment_id: ""
# To use Staticman comments, fill in repository, branch, and endpoint # To use Staticman comments, fill in "repository", "branch", and "endpoint"
staticman: staticman:
repository : # GitHub username/repository eg. "daattali/beautiful-jekyll" repository : # GitHub username/repository eg. "daattali/beautiful-jekyll"
branch : master # If you're not using `master` branch, then you also need to update the `branch` parameter in `staticman.yml` branch : master # If you're not using `master` branch, then you also need to update the `branch` parameter in `staticman.yml`
@ -141,7 +144,7 @@ staticman:
siteKey : # Use your own site key, you need to apply for one on Google siteKey : # Use your own site key, you need to apply for one on Google
secret : # ENCRYPT your password by going to https://staticman3.herokuapp.com/v3/encrypt/<your-site-secret> secret : # ENCRYPT your password by going to https://staticman3.herokuapp.com/v3/encrypt/<your-site-secret>
# To use Utterances comments: (1) fill in repository (make sure the repository is public), (2) Enable Issues in your repository, # To use Utterances comments: (1) fill in "repository" (make sure the repository is public), (2) Enable Issues in your repository,
# (3) Install the Utterances app in your repository https://github.com/apps/utterances # (3) Install the Utterances app in your repository https://github.com/apps/utterances
# See more details about the parameters below at https://utteranc.es/ # See more details about the parameters below at https://utteranc.es/
utterances: utterances:
@ -161,7 +164,8 @@ title-separator: "-"
date_format: "%B %-d, %Y" date_format: "%B %-d, %Y"
# Facebook App ID # Facebook App ID
# fb_app_id: "" #fb_app_id: ""
# --- You don't need to touch anything below here (but you can if you want) --- # # --- You don't need to touch anything below here (but you can if you want) --- #