X-Git-Url: https://git.korewanetadesu.com/?p=pelican-mode.git;a=blobdiff_plain;f=README.md;h=e29499dc234944af92bcee2273bb4df3be97325d;hp=8b365cb8e7042e9ea5eec08aa9c1c8a150158b4c;hb=0eeee74fd9a459dd8c04c264c183d80f2d2b98b2;hpb=3315a18243301484682db5648146579430001772 diff --git a/README.md b/README.md index 8b365cb..e29499d 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,10 @@ -pelican-mode is an Emacs minor mode for editing pages and posts in +pelican-mode is an Emacs minor mode for editing articles and pages in [Pelican][] sites. -It's intended to be used alongside [markdown-mode][] or [rst-mode][]. -It also assumes you've set up Pelican with `pelican-quickstart` or -something like it. In particular it assumes: +It's intended to be used alongside a major mode for the Pelican +document. Currently supported formats are Markdown, reStructuredText, +AsciiDoc, and Org. It also assumes you've set up Pelican with +`pelican-quickstart` or something like it. In particular it expects: * The existence of `pelicanconf.py` and `Makefile` in some ancestor directory. @@ -11,28 +12,33 @@ something like it. In particular it assumes: ancestor is irrelevant. * If the next component is `pages`, that indicates a static page rather than a dated post. - -It also enforces some parts of my preferred Pelican configuration: - * Categories are never provided (you can have one if you want, but - the default interactive commands don't provide one). - * Tags are always provided. - * Slugs are explicit, and include nested subdirectories. ## Quick Guide +To enable by default on all text files in a Pelican site: + + (require 'pelican-mode) + (pelican-global-mode) + +Or, register `pelican-mode` or `pelican-mode-enable-if-site` +as hook functions for more direct control. + +* `C-c P d` - Update the document’s date +* `C-c P f` - Set a metadata field (title, category, etc.) +* `C-c P h` - Generate HTML output for a site (equivalent to `make html`) * `C-c P n` - Insert a post or page header * `C-c P p` - Remove draft status from a post (i.e. publish it) -* `C-c P t` - Update the date field in a post/page header -* `C-c P h` - Generate HTML output for a site (equivalent to `make html`) * `C-c P u` - Upload a site using rsync (equivalent to `make rsync_upload`) + ## Troubleshooting If the commands which invoke `make` can find the Makefile but can't find `pelican`, your `exec-path` may not be set right. Try out [exec-path-from-shell][]. + ## License This program is free software; you can redistribute it and/or modify