3.4 KiB
General Use
-
Add a list with the plugin name and settings to the
:pluginssection of your .coleslawrc. Plugin settings are described below. -
Available plugins are listed below with usage descriptions and config examples.
Analytics via Google
Description: Provides traffic analysis through Google Analytics.
Example: (analytics :tracking-code "google-provided-unique-id")
Comments via Disqus
Description: Provides comment support through Disqus.
Example: (disqus :shortname "disqus-provided-unique-id")
Hosting via Github Pages
Description: Allows hosting with CNAMEs via github-pages. Parses the host from the :domain section of your config by default. Pass in a string to override.
Example: (gh-pages :cname t)
LaTeX via Mathjax
Description: Provides LaTeX support through Mathjax for posts tagged with "math" and indexes containing such posts. Any text enclosed in will be rendered, for example, ``` \lambda \scriptstyle{f}. (\lambda x. (\scriptstyle{f} (x x)) \lambda x. (\scriptstyle{f} (x x))) $$```.
Example: (mathjax)
Options
:force, when non-nil, will force the inclusion of MathJax on all posts. Default value is nil.
:location specifies the location of the MathJax.js file. The default value is "http://cdn.mathjax.org/mathjax/latest/MathJax.js". This is useful if you have a local copy of MathJax and want to use that version.
:preset allows the specification of the config parameter of MathJax.js. The default value is "TeX-AMS-MML_HTMLorMML".
:config is used as supplementary inline configuration to the MathJax.Hub.Config ({ ... });. It is unused by default.
ReStructuredText
Description: Some people really like ReStructuredText. Who knows why? But it only took one method to add, so yeah! Just create a post with format: rst and the plugin will do the rest.
Example: (rst)
S3 Hosting
Description: Allows hosting your blog entirely via Amazon S3. It is suggested you closely follow the relevant AWS guide to get the DNS setup correctly. Your :auth-file should match that described in the ZS3 docs.
Example: (s3 :auth-file "/home/redline/.aws_creds" :bucket "blog.redlinernotes.com")
Sitemap generator
Description: This plugin generates a sitemap.xml under the page root, which is useful if you want google to crawl your site.
Example: (sitemap)
Wordpress Importer
Description: Import blog posts from Wordpress using their export tool. Blog entries will be read from the XML and converted into .post files. Afterwards the XML file will be deleted to prevent reimporting. Optionally an :output argument may be supplied to the plugin. If provided, it should be a directory in which to store the .post files. Otherwise, the value of :repo in your .coleslawrc will be used.
Example: (import :filepath "/home/redline/redlinernotes-export.timestamp.xml" :output "/home/redlinernotes/blog/")