config.yaml
Below is a typical config.yaml
file
# Maximum number of words to use in a blurb blurb_max: 50 # The default home page to be written as docroot/index.html home_page: home.md site: # The site title, used in <title> title: My PyKwiki Project # Author for use in meta name=author author: Example Author # Description for use in meta name=description description: "Example Site Description goes here" # Keywords for use in meta name=keywords keywords: "example, pykwiki" # (new in v1.0.5) Base URL is used by RSS feeds, no web_prefix base_url: http://www.example.com # The style is the folder name from ./styles/ style: default # Theme is now "null", but can be specified for overriding. theme: null # Web prefix, must not end with "/" web_prefix: '' # The project's directory base_path: /home/HarryPotter/MyPyKwikiProject/ # The date format used by posts date_format: '%B %d, %Y' # The time format used by posts time_format: '%H:%M:%S' # The timestamp format used by posts, this must match # the format found in the post data block, if specified timestamp_format: '%Y-%m-%d %H:%M' # Post list section postlist: # How many posts to show per page per_page: 5 # Maximum number of pages to render max_pages: 20 # What type of post data to display (blurb, preview, full) post_type: preview # What field to order posts by (mtime, title) order_field: mtime # What direction to order posts (descending, ascending) order_type: descending # The version information version: 2 # Upload extensions are file extensions that will # be copied from source/ to docroot/ upload_exts: - .gif - .jpg - .jpeg - .png - .tiff - .pdf
Parts
blurb_max
- specifies how many words of a post should be shown.home_page
- Tells PyKwiki to look for this post in thesource
directory, and if found, save it toindex.html
in thedocroot
directory.web_prefix
- This should be an empty string if not specified. This is usefull for serving multiple PyKwiki projects from the same docroot directory.base_path
- This is the full path to your PyKwiki Project's directory.site
- Generate site settingstitle
- The human readable site title. Most themes will populate the html<title>
attribute with this value.author
- Most themes put this value in<meta name=author>
description
- Most themes use this value in<meta name=description>
keywords
- This is a string of keywords that some themes use in<meta name=keywords>
base_url
- This is the base url of your site without a trailing slash or web prefix.
date_format
- This describes how the date will appear when themes lookup a post's date. It uses strftime formatting.time_format
- This describes how the time will appear when themes lookup a post's time. It uses strftime formatting.timestamp_format
- This describes how the date and time will appear when themes lookup a post's timestamp.It also uses strftime formatting.- This format must match the format in the post data block.
upload_exts
- This YAML list contains file extensions, including the dot (.), for file types that will be copied from source/ to docroot/.- For example, if you have
source/my_vacation_pics/pic21.png
and.png
inupload_exts
thenpic21.png
will be copied todocroot/my_vacation_pics/pic21.png
when cached.
- For example, if you have