XX .Tips & tricks

Writing blog posts

To create a blog post, use new post.

To create any other kind of page, use new page.

Improving site performance

1. Deploy your site to a web server that supports HTTP2:

• this will load the CSS and JS scripts quicker.

2. When adding JS dependencies to a page or post:

• don't add jQuery - use a smaller, faster alternative.
• use cash-dom (recommended), cheerio, sprint-js, or chibi-js instead.

3. Don't use too many JS deps:

• only use what you need - the JS dependencies are optional.
• your blog will still work with no JavaScript dependencies.

4. Use system fonts only (don't use Web Fonts):

• to disable Google Fonts, set $blog_fonts="" in the .site_config config file
• your pages will load quicker, but you lose control over how your fonts look
• (most systems have OK looking fonts with good Unicode support nowadays)

Running a local web server

• The server script included with mdsh requires the httpd command
• Use server start or server stop to control you web server
• You can use a different web server, instead of using server, if you prefer
• Any web server you use must be run from the right directory (see Requirements)