03. Setup

Edit default site config

# set blog name, URL, description, etc
./setup
# load settings
source .site_config

# run the 'httpd' web server (if you prefer a different web server, you can use that instead)
server start

If you change anything in .site_config, you should rebuild your site so all your pages get the latest change/values, and then re-publish:

rebuild -all
publish "updated site"

---

Variables in .site_config

After running ./setup, the .site_config file will contain the following variables:

$blog_title

The main name/title of your blog - it appears at the top of the page and in your sites meta info.

$blog_url

• If your blog is https://user.github.io/mdsh/, use $blog_url='/mdsh'
• if your blog is http://site.com/blog/, use $blog_url='/blog'.
• if your blog is http://site.com/, use $blog_url=''.

$blog_js_deps

A space separated list of npm packages to include in all pages by default. Example:

cash-dom fetch-polyfill

• Uses Unpkg.com to provide the packages.
• Supports npm/semver naming like [email protected].
• Use the following format for package names: package[@version/file]

In other words, only the package name is needed. See http://unpkg.com for more info.

$blog_fonts

A Google Font request. Leave blank if you don't want to use Google Fonts. The default value is:

Ubuntu:400,400i,700|Inconsolata:400,400i,700|Monaco:400,400i,700&subset=latin,latin-ext

$blog_author

Your name. Appears in site meta data and as author of blog posts (unless overridden when writing the blog post).

$blog_email

This email is used by the auto-generated contact form (contact.html). (Some basic spam protection is provided by using Javascript and Formspree.io to send the submitted data to your given email).

$blog_twitter

Your Twitter handle - appears under the main headings of your blog posts. Useful to encourage users to share your content on Twitter or visit your Titter page.